지정된 창으로부터 텍스트를 열람합니다.
WinGetText, OutputVar [, WinTitle, WinText, ExcludeTitle, ExcludeText]
열람된 텍스트를 저장할 변수의 이름.
목표 창을 식별하는 창 제목 또는 다른 기준. WinTitle 참조.
존재하면, 목표 창 텍스트의 부문자열입니다 (동봉된 Window Spy 유틸리티에 노출됨). 숨은 텍스트는 DetectHiddenText가 켜져(ON) 있으면 탐지됩니다.
제목에 이 값이 있는 창은 제외합니다.
텍스트에 이 값이 있는 창은 제외합니다.
[v1.1.04+] 이 명령어는 실패하면 예외를 던질 수 있습니다. 더 자세한 정보는 실행시간 에러를 참조하십시오.
ErrorLevel은 문제가 있었으면 1,. 그렇지 않으면 0이 설정됩니다.
열람된 텍스트는 일반적으로 Window Spy가 그 창에 대하여 보여주는 것과 동일합니다. 그렇지만, DetectHiddenText가 꺼져 있다면, 숨은 텍스트는 OutputVar에 포함되지 않습니다.
각 텍스트 원소는 캐리지 리턴과 라인피드 (CR+LF)로 끝납니다. 스크립트에서는 `r`n로 표기됩니다. 각 줄이나 부문자열을 추출하려면, StringGetPos 그리고 StringMid와 같은 명령어를 사용하십시오. 회돌이 파싱을 사용하면 각 줄이나 단어를 하나씩 조사할 수 있습니다.
열람된 텍스트가 (불완전하게) 잘려 나타나면, 먼저 VarSetCapacity(OutputVar, 55)를 사용한 다음 WinGetText를 시도하십시오 [잘려 나간 텍스트보다 훨씬 더 큰 크기로 55를 교체하십시오]. 어떤 어플리케이션은 WM_GETTEXTLENGTH 메시지에 적절하게 응답하지 않기 때문에, 오토핫키가 출력 변수를 너무 작게 만들어 모든 텍스트가 들어가지 못하기 때문에 필수적으로 이렇게 처리해야 합니다.
열람된 텍스트의 양은 변수의 최대 가용 능력에 제한을 받습니다 (#MaxMem 지시어를 통하여 바꿀 수 있습니다). 결과적으로, 이 명령어는 목표 창에 (예, 큰 문서를 열고 있는 편집기에) 방대한 양의 텍스트가 있다면 방대한 양의 RAM을 사용할 수 있습니다. 이를 피하려면, 창 텍스트의 포인터만 열람하는 것도 가능합니다. 대신에 ControlGetText를 사용하십시오. 어느 경우든, 변수의 메모리는 나중에 아무것도 할당하지 않으면 해제할 수 있습니다. 즉, OutputVar =이면 메모리가 해제됩니다.
창의 모든 콘트롤 목록을 열람하려면, 다음 예제를 따르십시오: WinGet, OutputVar, ControlList, WinTitle
창 제목과 텍스트는 대소문자를 구분합니다. 숨은 창은 DetectHiddenWindows가 켜져 있으면 탐지됩니다.
ControlGetText, WinGetActiveStats, WinGetActiveTitle, WinGetTitle, WinGetPos, #MaxMem
Run, Calc.exe WinWait, Calculator WinGetText, text ; 위에서 발견한 창을 사용합니다. MsgBox, The text is:`n%text%