ControlSetText
콘트롤의 텍스트를 변경합니다.
ControlSetText [, Control, NewText, WinTitle, WinText, ExcludeTitle, ExcludeText]
매개변수
- Control
ClassNN (콘트롤의 클래스이름과 실체 번호) 또는 콘트롤의 텍스트일 수 있습니다. 둘 다 Window Spy를 통하여 알아낼 수 있습니다. 텍스트를 사용할 때, 부합 행위는 SetTitleMatchMode로 결정됩니다. 이 매개변수가 비어 있으면, 목표 창의 최상위 콘트롤이 사용됩니다.
콘트롤으 HWND (창 핸들)에 작동 시키려면, Control 매개변수를 비워 두고
ahk_id %ControlHwnd%를 WinTitle 매개변수에 지정하십시오 (이것은 숨은 콘트롤에도 작동합니다. DetectHiddenWindows가 꺼져 있어도 상관 없습니다). 콘트롤의 HWND는 전형적으로 ControlGet Hwnd, MouseGetPos, 또는 DllCall을 통하여 열람합니다.- NewText
콘트롤 안에 설정해 넣을 새 텍스트. 비어 있거나 생략되면, 콘트롤이 비워집니다.
- WinTitle
목표 창을 식별하는 창 제목이나 기타 기준. WinTitle 참조.
- WinText
존재하면, 목표 창 텍스트의 부문자열입니다 (Window Spy에 노출). 숨은 텍스트는 DetectHiddenText가 켜져(ON) 있어야 탐지됩니다.
- ExcludeTitle
제목에 이 값이 있는 창은 제외됩니다.
- ExcludeText
텍스트에 이 값이 있는 창은 제외됩니다.
ErrorLevel
[v1.1.04+] 이 명령어는 실패시 예러를 던질 수 있습니다. 더 자세한 정보는 실행시간 에러를 참조하십시오.
ErrorLevel은 실패하면 1 성공하면 0이 설정됩니다.
논평
대부분의 콘트롤 유형은 홀로 라인피드 (`n) 말고 캐리지 리턴과 라인피드 (`r`n)를 사용해 각 줄의 끝을 표시합니다. `n 문자가 포함된 텍스트 블록을 변환하려면, 다음 예제를 따르십시오:
StringReplace, MyVar, MyVar, `n, `r`n, All
신뢰성을 향상시키기 위해, 이 명령어를 사용할 때마다 지연 시간이 자동으로 삽입됩니다. 이 지연 시간은 SetControlDelay를 통하여 바꿀 수 있습니다.
창 제목과 텍스트는 대소문자를 구분합니다. 숨은 창은 DetectHiddenWindows가 켜져 있어야 탐지됩니다.
관련 항목
SetControlDelay, ControlGetFocus, ControlGetText, ControlGet, Control, ControlMove, ControlGetPos, ControlClick, ControlFocus, ControlSend
예제
ControlSetText, Edit1, 여기에 새 텍스트 설정, Untitled -