GuiControlGet

Gui커멘드로 작성한 윈도우에 배치된 컨트롤의 각종 정보를 취득한다

GuiControlGet, OutputVar [, SubCommand, ControlID, Param4]

Parameters

ErrorLevel

무엇인가 문제가 있으면 「1」, 정상적으로 종료하면 「0」

SubCommand생략시

이하의 종류의 컨트롤 이외에서는,Gui,Add시간에Text인수로 설정되는 부분의 내용이 취득된다.

Hotkey

hot key가 입력되고 있으면, 「^!C」 「^Home」 「^NumpadHome」(와)과 같은 형식(hot key 라벨로 그대로 사용할 수 있다)그리고 취득된다.

Slider/Progress

현재의 위치가 취득된다.

Picture

컨트롤이Gui,Add그리고 추가되었을 때에 읽힌 화상의 파일명이 취득된다.

Checkbox/Radio

「0」(이)라면 체크 이루어, 「1」(이)라면 체크 있어, 「-1」(이)라면 반체크.
Param4에 「Text」(을)를 지정하면, 대신에 컨트롤의 캡션이 취득된다.

DropDownList/ComboBox/ListBox/Tab

선택되고 있는 항목의 텍스트가 취득된다.
ComboBox그럼, 입력란에 입력되고 있는 텍스트가 취득된다.

SubCommand

Pos

컨트롤의 좌표와 높이를 취득한다.
이 서브 커멘드에서는,OutputVar그리고 지정한 이름에 「X」 「Y」 「W」 「H」(을)를 붙인 이름의 변수에, 각각X좌표/Y좌표/폭/높이가 격납된다.
좌표는, 윈도우의 타이틀 바나 도구모음을 들여다 본 클라이언트 에리어상에서의 좌표로 취득된다.

Enabled

윈도우가 유효 상태라면 「1」, 무효화되고 있으면 「0」

Visible

컨트롤이 표시되고 있으면 「1」, 비표시가 되어 있으면 「0」

Focus

윈도우상의 입력초점을 가지고 있는 컨트롤의ClassNN(을)를 취득한다.
이 서브 커멘드에서는,ControlID(은)는 지정하지 않는다.
윈도우가 액티브하지 않은 경우, 입력초점을 가지는 컨트롤은 없기 때문에,OutputVar(은)는 비운다.

FocusV

Focus(와)과 같지만,ClassNN대신에 컨트롤에 할당한 변수명을 취득한다.
변수를 할당할 수 있지 않은 경우, 대신에 컨트롤의 텍스트의 최초의63문자까지가 취득된다.

Hwnd

DllCall(이)나PostMessage/SendMessage등에서 사용하는 윈도우 핸들을 얻는다.

Remarks

스크립트는 최대로10의 윈도우를 가질 수 있다.
디폴트 이외의 윈도우를 조작하려면 , 서브 커멘드의 전에 「2:」(와)과 같이 윈도우 번호와 코론을 추가한다.

기본적으로 디폴트의 윈도우 번호는 「1」이지만,2번째 이후의 윈도우상의GUI조작의 결과 실행된 스렛드에서는, 그 윈도우의 번호가 디폴트가 된다.

GuiControlGet, MyEdit, 2:
GuiControlGet, Outputvar, 2:Focus
GuiControlGet, OutputVar, 2:Pos, MyEdit

Related

Gui, GuiControl, ControlGet

Example(s)

GuiControlGet, MyEdit
GuiControlGet, CtrlContents,, MyEdit ; Same as the above except uses a non-default output variable.
GuiControlGet, MyCheckbox1 ; Retrieves 1 if it is checked, 0 if it is unchecked.
GuiControlGet, MyCheckbox1,,, Text ; Retrieves the caption/text of the checkbox. 
GuiControlGet, Pic, Pos, Static4 ; The position/size will be stored in PicX, PicY, PicW, and PicH

GuiControl

Gui커멘드로 작성한 윈도우에 배치된 컨트롤에 대해 각종 조작을 실시한다

GuiControl, SubCommand, ControlID [, Param3]

Parameters

ErrorLevel

무엇인가 문제가 있으면 「1」, 정상적으로 종료하면 「0」

SubCommand생략시

Param3에Gui,Add시간에Text인수로 설정하는 부분의 내용을 지정하는 것으로, 값을 재설정할 수 있다.
아래와 같은 컨트롤에 대해서는, 특기 사항 있어.

Hotkey

Param3에 공문자열이나 hot key를 지정한다.
hot key는 「^!C」 「^Home」 「^NumpadHome」(와)과 같은 hot key 라벨과 같은 형식에서 지정한다.수식 키는Ctrl(^),Alt(!),Shift(+)마셔 사용 가능.

Picture

Param3에 새롭게 읽어들이는 화상 파일명을 지정한다.
파일명의 전에 반각 스페이스에서 단락지어 이하의 옵션을 지정할 수 있다.
례:GuiControl,, MyPic, *icon2 *w100 *h-1 C:\My Application.exe

*wN

N에 컨트롤의 폭을 지정.「*w0」(으)로 화상의 실제의 폭.미지정의 경우는 현재의 컨트롤의 폭.「*w-1」(으)로 종횡비를 유지하도록(듯이) 「*hN」(으)로의 지정에 맞춘다.

*hN

N에 컨트롤의 높이를 지정.「*h0」(으)로 화상의 실제의 높이.미지정의 경우는 현재의 컨트롤의 높이.「*h-1」(으)로 종횡비를 유지하도록(듯이) 「*wN」(으)로의 지정에 맞춘다.

*IconN

N에 아이콘 번호를 지정.실행 파일등의 프로그램 파일중의 아이콘을 읽어들일 때 사용.

Checkbox

Param3에 체크 상태를 지정한다.
「0」(이)라면 체크 이루어, 「1」(이)라면 체크 있어, 「-1」(이)라면 반체크.
그 이외의 경우, 텍스트를 변경한다. 「0」 「-1」 「1」라고 하는 문자열을 텍스트에 설정하고 싶은 경우, 「Text」서브 커멘드를 사용한다.

Radio

Param3에 체크 상태를 지정한다.
「0」(이)라면 체크 이루어, 「1」(이)라면 체크 있어.
그 이외의 경우, 텍스트를 변경한다.
체크가 없음으로부터 있으가 되는 경우, 같은 그룹외의Radio의 체크는 자동적으로 빗나간다.

DateTime

Param3에YYYYMMDDHH24MISS의 서식그리고 표시 일시를 설정한다.
컨트롤의 옵션에 「2」(을)를 붙이고 체크 박스를 붙이고 있는 경우, 공문자열을 지정하는 것으로 체크를 떼어, 선택 없음을 나타내는 상태로 할 수 있다.

MonthCal

Param3에YYYYMMDDHH24MISS의 서식그리고 표시 일시를 설정한다.
컨트롤의 옵션에 「Multi」(을)를 붙여 복수 선택 상태로 하고 있는 경우, 「20050101-20050202」(와)과 같은 범위에서 지정한다.

UpDown/Slider/Progress

새로운 값/위치를 지정한다.
「+」에 계속치를 지정하면, 현재의 위치로부터의 상대 위치에서 지정할 수 있다.줄이는 경우도 「+-10」(와)과 같이 부의 값에+(을)를 붙여 지정한다.
설정된 범위외의 수치가 되는 경우는, 범위내에서 가까운 값이 된다.

DropDownList/ComboBox/ListBox

리스트에추가하는 텍스트 항목을 「|」(으)로 단락지어 열거.
리스트의 항목을 모두 설정 다시 하는 경우, 최초의 항목의 전에 「|」(을)를 넣는다.(례:「|aaa|bbb|ccc」)
항목의 뒤로 「||」(이)가 있으면, 그 항목이 선택된 상태가 된다.(례:「xxx||yyy|zzz」, 「xxx|yyy|zzz||」)

Tab

탭의 이름이나 수에 의하지 않고,1번째의 탭 시트에 배치되어 있던 컨트롤은1번째의 탭 시트에,N번째의 탭 시트에 배치되어 있던 컨트롤은N번째의 탭 시트에 배치된 채로 있다.
변경에 의해서 탭 시트의 수가 줄어 드는 경우, 제일 뒤의 탭 시트가 사라지게 되지만, 후에 탭의 수가 증가하면 탭 시트의 내용와도 부활한다.

ListView

리스트뷰의 조작은리스트뷰 조작용의 편입 함수(을)를 사용한다.

SubCommand

Text

서브 커멘드 생략시와 거의 같은 동작이지만,Checkbox(이)나Radio에 「0」 「-1」 「1」(을)를 지정했을 경우에서도, 텍스트로서 설정된다.
또,DateTime컨트롤에서는,Param3그리고 표시 포맷을 재설정할 수 있다.(Param3(을)를 생략 하면, 짧은 일자 문자열 포맷이 된다)
ComboBox그럼, 입력란의 내용을 변경할 수 있다.

Move

컨트롤을 이동/사이즈 변경한다.
Param3에는 「Xn」(n에X좌표를 지정)「Yn」(n에Y좌표를 지정)「Wn」(n에 폭을 지정)「Hn」(n에 높이를 지정)중, 변경하고 싶은 것을 스페이스 단락으로 열거한다.(례:「x10 y20 w200 h100」)
좌표는, 윈도우의 타이틀 바나 도구모음을 포함하지 않는 클라이언트 영역상에서의 좌표.

MoveDraw

Move(와)과 거의 같지만, 윈도우를 재묘화 시킨다.
표시 내용이 확실히 갱신되지만, 표시가 조금씩 날리는 경우가 있다.

Focus

컨트롤에 입력초점을 대면시킨다

Enable

Enable1

Disable0

무효화되고 있는 컨트롤을 유효화한다

Disable

Disable1

Enable0

컨트롤을 무효화한다

Show

Show1

Hide0

비표시가 되어 있는 컨트롤을 표시한다

Hide

Hide1

Show0

컨트롤을 비표시로 한다

Choose

Param3번째의 항목을 선택한다(DropDownList/ComboBox/ListBox전용).
이 커멘드로 선택을 변경했을 경우, 통상은 「g」옵션으로 할당할 수 있었던 써브루틴은 실행되지 않지만, 「GuiControl,,Choose,|3」(와)과 같이Param3의 숫자의 전에 「|」(을)를 붙이면, 써브루틴이 실행된다.
또, 「||」(을)를 붙이면,A_GuiControlEvent변수가DoubleClick(이)가 되어 있는 상태로 써브루틴이 실행된다.

ChooseString

Param3그리고 지정한 문자열에 전방 일치하는 항목을 선택한다(DropDownList/ComboBox/ListBox전용).
대문자 소문자는 구별되지 않는다.
이 커멘드로 선택을 변경했을 경우, 통상은 「g」옵션으로 할당할 수 있었던 써브루틴은 실행되지 않지만, 「GuiControl,,Choose,|3」(와)과 같이Param3의 숫자의 전에 「|」(을)를 붙이면, 써브루틴이 실행된다.
또, 「||」(을)를 붙이면,A_GuiControlEvent변수가DoubleClick(이)가 되어 있는 상태로 써브루틴이 실행된다.

Font

폰트를 현재Gui,Font그리고 윈도우로 설정되어 있는 폰트로 변경한다.「Gui,Font」참조.

+Redraw/-Redraw

리스트뷰등에서 대량의 항목을 추가·삭제·변경하기 전에GuiControl,-Redraw,ControlID그리고 재묘화를 정지해, 종료후에+Redraw그리고 재개시키는 것으로 퍼포먼스를 개선할 수 있다.

Remarks

스크립트는 최대로10의 윈도우를 가질 수 있다.
디폴트 이외의 윈도우를 조작하려면 , 서브 커멘드의 전에 「2:」(와)과 같이 윈도우 번호와 코론을 추가한다.

기본적으로 디폴트의 윈도우 번호는 「1」이지만,2번째 이후의 윈도우상의GUI조작의 결과 실행된 스렛드에서는, 그 윈도우의 번호가 디폴트가 된다.

GuiControl, 2:Show, MyButton
GuiControl, 2:, MyListBox, Item1|Item2

Related

Gui, GuiControlGet, Control

Example(s)

GuiControl,, MyListBox, |Red|Green|Blue ; Replace the current list with a new list.
GuiControl,, MyEdit, New text line 1.`nNew text line 2.
GuiControl,, MyRadio2, 1 ; Turn on this radio button and turn off all the others in its group.
GuiControl, Move, OK, x100 y200 ; Move the OK button to a new location.
GuiControl, Focus, LastName ; Set keyboard focus to the control whose variable or text is "LastName".

Gui,TreeView

GUI윈도우의 트리뷰 조작계 편입 함수로 대상이 되는 트리뷰콘트로르를 지정한다

Gui,TreeView,TreeViewName

Parameters

Remarks

Gui,Tab

GUI윈도우에Tab컨트롤이 배치되어 있을 때, 다음에 배치되는 컨트롤이 어느 탭 페이지에 배치되는지를 변경한다

Gui,Tab [, Item, ControlNo, Exact]

Parameters

Remarks

옵션 없이 실행하면, 탭 콘트롤상이 아니고, 윈도우의 직하에 배치되게 된다.

각 탭 페이지에 최초의 컨트롤을 배치할 때,X,Y옵션에 의한 좌표 지정을 생략 하면, 탭 페이지의 좌상에 배치된다.
또,X+n/Y+n옵션으로 상대 좌표를 지정하면, 탭 페이지의 좌상으로부터의 상대 좌표가 된다.

탭 페이지상의 컨트롤은, 탭 페이지에서는 봐 내 배치하는 일도 가능.
초과하고 있는 컨트롤은, 배치된 탭 페이지가 액티브한 때 마셔 표시된다.

Related

GUI, Gui,Add,Tab

Example

Gui, Tab   ; Future controls are not part of any tab control.

Gui, Tab, 3   ; Future controls are owned by the third tab of the current tab control.

Gui, Tab, 3, 2   ; Future controls are owned by the third tab of the second tab control.

Gui, Tab, Name   ; Future controls are owned by the tab whose name starts with Name (not case sensitive).

Gui, Tab, Name,, Exact  ; Same as above but requires exact match (case sensitive too). [v1.0.37.03+]

Gui,Submit

GUI윈도우를 비표시로 해, 컨트롤에의 입력 내용을 변수에 반영시킨다

GUI, Submit [, NoHide]

Parameters

Remarks

컨트롤 상태나 내용을 지정된 변수에 반영시킨다.
옵션에 「NoHide」(이)가 지정되지 않았던 경우, 윈도우는 비표시 상태가 된다.
윈도우가 존재하지 않았던 경우, 아무것도 일어나지 않는다.

Related

GUI

Gui,Show

GUI윈도우의 표시·표시 상태의 변경

GUI, Show [, Options, Title]

Parameters

Remarks

Options에 아무것도 지정되지 않았던 경우, 마지막에 표시되고 있던 위치와 사이즈로 표시되어 최소화되고 있으면 해제되어 액티브화 된다.
제일 최초로 표시될 때 위치나 사이즈가 지정되지 않았던 경우는,Center(이)나AutoSize하지만 지정된 것과 같게 된다.

최초로Gui,Show하지만 실행될 때까지는, 윈도우의x,y좌표, 폭, 높이는 모두 「0」(이)가 되어 있다.
윈도우를 표시하기 전에 작성했다GUI윈도우의 사이즈를 알고 싶은 경우, 미리 「Gui,Show,Hide」(을)를 실행해 사이즈를 결정시킬 필요가 있다.

Gui,Add,Edit
Gui,Show,Hide
Gui,+LastFound
WinGetPos,x,y

Gui,Restore

GUI윈도우의 최소화·최대화를 바탕으로 되돌린다

GUI, Restore

Remarks

GUI윈도우가 비표시가 되어 있는 경우는, 표시된다.

GUI윈도우가 존재하지 않는 경우는, 아무것도 일어나지 않는다.

Related

GUI

Gui,+/-Option

GUI윈도우의 옵션을 추가/삭제한다

Gui, [+Option|-Option]

Parameters

Option(으)로 지정할 수 있는 것

LastFound

윈도우 관련 커멘드로 대상 윈도우 지정을 생략 했을 때에 대상이 되는 「LastFoundWindow」(으)로 설정한다.
GUI윈도우가 아직 존재하지 않는 경우는, 하늘의 윈도우가 생성된다.

LastFoundExist

LastFound(와)과 같지만, 해당GUI윈도우가 존재하지 않는 경우, 윈도우의 생성은 하지 않고LastFoundWindow하지만 클리어 된다.
해당GUI윈도우가 이미 사용되고 있는지 어떤지를 알기 위해서 이용할 수 있다.

LabelNAME

윈도우가 닫았을 때 등에 실행되는 써브루틴 라벨의 접머리 글자열을NAME그리고 지정한 것으로 변경한다.
예를 들면, 「Gui,2:+LabelOptionWindow」라고 하면,2번째의GUI윈도우가 닫혀졌을 때에 「2GuiClose」(은)는 아니고 「OptionWindowClose」라고 하는 라벨의 써브루틴이 실행된다.
써브루틴내에서 이벤트가 일어났다GUI(을)를 특정하려면 , 「A_Gui」변수를 이용한다.

DelimiterC

리스트 박스나 combobox등의 항목을Gui,Add그리고 설정할 때나,Gui,Submit등에서 취득할 경우에 항목의 단락으로서 사용되는 단락 문자를 설정한다.
C에 단락 문자를 지정한다.(례:「Delimiter`n」)
반각 스페이스를 사용하고 싶을 때는 「DelimiterSpace」,Tab문자를 사용하고 싶을 때는 「DelimiterTab」라고 지정한다.
이 옵션의 변경은, 실행중외의 스렛드에도 영향을 준다.

Owner[N]

특정의 윈도우를 다른 윈도우의 종속 윈도우로 한다.
종속 윈도우는 태스크바에 표시되지 않고, 항상 주윈도우보다 전면에 표시되어 주윈도우가 파기될 때 함께 파기된다.
N에 주윈도우의 번호를 숫자로 지정한다.
숫자를 붙이지 않았던 경우,AutoHotkey의 메인 윈도우의 종속 윈도우가 된다.
이 옵션은, 주윈도우가 벌써 작성되고 있어 종속 위드우는 아직 작성되어 있지 않은 상태로 밖에 사용할 수 없다.
종속 윈도우가 작성되어 있지 않은 경우만, 「-Owner」(을)를 실행하는 것으로, 설정을 해제할 수 있다.
종속 윈도우가 표시되고 있는 동안, 주윈도우를 조작할 수 없게 하고 싶은 경우, 종속 윈도우를 표시할 경우에 「+Disabled」(으)로WS_DISABLED(을)를 추가해 조작 불가능하게 해, 종속 윈도우를 닫았을 때에 「-Disabled」(으)로 해제하도록(듯이) 한다.

OwnDialogs

다이얼로그가 표시되고 있는 동안은 친윈도우를 조작할 수 없는 모덜 다이얼로그를 표시시킨다.
대상이 되는 것은,MsgBox, InputBox, FileSelectFile, FileSelectFolder의 각 커멘드로 표시되는 다이얼로그이다.
또, ToolTip, Progress, SplashImage그리고 표시되는 윈도우도, 아이 윈도우라고 하는 취급이 되어, 친윈도우보다 반드시 전에 표시되어 친윈도우가 파기되는 것과 동시에 파기되게 된다.
이 설정은, 설정을 실시했다스렛드에서만 유효하다. 「Gui,+OwnDialogs」라고 하면, 스렛드의 디폴트GUI윈도우가 친윈도우가 된다.
「Gui,2:+OwnDialogs」(와)과 같이 하면, 명시적으로 친윈도우를 설정할 수 있다.
「Gui,-OwnDialogs」(와)과 같이 하면, 설정이 해제되어 모덜 다이얼로그를 표시한 후에 보통 다이얼로그를 표시하는 일도 가능.

AlwaysOnTop

항상 맨 앞면표시로 한다.

Disabled

조작 불가능하게 한다.

Border

윈도우의 테두리를 표시한다.
무효로 하면, 타이틀 바도 표시되지 않게 된다.

Caption

윈도우에 타이틀 바를 표시한다.
초기 상태는 유효하게 되어 있다.

MaximizeBox

윈도우를 최대화 가능하게 해, 타이틀 바에 최대화 버튼을 표시한다.
초기 상태는 유효하게 되어 있다.

MinimizeBox

윈도우를 최소화 가능하게 해, 타이틀 바에 최소화 버튼을 표시한다.
초기 상태는 유효하게 되어 있다.

Resize

윈도우를 리사이즈 가능하게 한다.
최대화 버튼은, 리사이즈 가능하게 하지 않으면 사용할 수 없다.

MaxSizeWxH

Resize옵션이 지정되어 있다Gui윈도우에 대하고, 클라이언트 영역의 최대의 폭을W피크셀, 최대의 높이를H피크셀에 제한한다.(례:「MaxSize320x240」)
W인가H의 다른 한쪽만을 지정할 수도 있다.이 경우, 생략 된 (분)편은 무제한하게 된다.(례:「MaxSize320x」 「MaxSizex240」)
WxH하지만 지정되어 있지 않은 경우, 현재의 사이즈를 상한으로 한다.한번도 윈도우를 표시하고 있지 않는 경우는, 최초로Gui,Show(을)를 실행했을 때의 사이즈가 된다.

MinSizeWxH

Resize옵션이 지정되어 있다Gui윈도우에 대하고, 클라이언트 영역의 최소의 폭을W피크셀, 최소의 높이를H피크셀에 제한한다.(례:「MinSize320x240」)
그 외는MaxSize(와)과 같다.

SysMenu

타이틀 바의 아이콘과 아이콘 클릭시에 표시되는 메뉴(「닫는다」등이 표시된다)(을)를 표시할지를 지정.
이것을 무효로 하면, 태스크바의 버튼을 오른쪽 클릭했을 때에 나오는 메뉴도 없어진다.

Theme

이후에 작성되는 컨트롤에WindowsXP의 비주얼 스타일을 적용할지를 지정.
초기 상태는 유효하게 되어 있다.

ToolWindow

타이틀 바가 가늘고(화면의 프롭퍼티의 설정에 의존), 태스크바에 버튼이 표시되지 않는 윈도우가 된다.

0xNNNNNNNN

컨트롤의 스타일을8자리수의16진수치로 지정한다.
자세한 것은스타일 일람(을)를 참조.

E0xNNNNNNNN

컨트롤의 확장 스타일을8자리수의16진수치로 지정한다.
자세한 것은스타일 일람(을)를 참조.

Related

GUI

Example(s)

;윈도우2(을)를 윈도우1의 종속 윈도우로 하는 예
Gui,add,text,,aaaaaaaa
Gui,2:+owner1

Gui,Minimize

GUI윈도우를 최소화한다

GUI, Minimize

Remarks

GUI윈도우가 비표시가 되어 있는 경우는, 표시된다.

GUI윈도우가 존재하지 않는 경우는, 아무것도 일어나지 않는다.

Related

Related

GUI

Gui,Menu

Gui윈도우의 도구모음에Menu커멘드로 작성한 메뉴를 할당한다

Gui, Menu [, MenuName]

Parameters

Remarks

도구모음으로서 할당할 수 있고 있는 메뉴는, 통상의 pop-up menu와는 취급이 다르기 위해,Menu커멘드로 항목을 조작하거나 pop-up menu로서 표시하거나 다른 메뉴의 부메뉴로 하거나 하는 것은 할 수 없다.
메뉴 항목을 조작하고 싶은 경우는, 일단MenuName없이 실행해 할당을 해제하고 나서 조작해, 재차 다시 할당한다.

도구모음의 부메뉴에 대해서는, 보통 메뉴로서 조작할 수 있다.

Related

GUI, Menu

Example(s)

Menu, FileMenu, Add, &Open, MenuHandler
Menu, FileMenu, Add, E&xit, MenuHandler
Menu, HelpMenu, Add, &About, MenuHandler
Menu, MyMenuBar, Add, &File, :FileMenu  ; Attach the two sub-menus that were created above.
Menu, MyMenuBar, Add, &Help, :HelpMenu
Gui, Menu, MyMenuBar