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가 켜져 있어야 탐지됩니다.

ExcludeTitle

제목에 이 값이 있는 창은 무시합니다.

ExcludeText

텍스트에 이 값이 있는 창은 무시합니다.

에러 처리

[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

예제

Changes the text of Notepad's edit control. This example may fail on Windows 11 or later, as it requires the classic version of Notepad.

ControlSetText, Edit1, 여기에 새 텍스트 설정, Untitled -

Changes the text of the main window's edit control.

#Persistent
ListVars
WinWaitActive, ahk_class AutoHotkey
ControlSetText, Edit1, New Text Here ; Use the window found above.