Gui,Add,ListBox

GUI윈도우에 리스트 박스를 추가한다

Gui, Add, ListBox [, Options, Text]

Parameters

고유의Option

Sort

항목을 항목명 순서에 줄서 바꾸어 표시한다
반각 문자를 타이프 치면 선두가 일치하는 항목으로 이동하는 「인크리멘탈 서치」의 기능도 유효하게 된다.

ReadOnly

선택 항목이 반전 표시되지 않게 된다.
V옵션으로 지정한 변수에서는, 포커스가 합쳐져 있는 항목이 취득된다.
Multi옵션과의 병용은 할 수 없다.

AltSubmit

Gui,Submit(이)나GuiControlGet그리고 취득되는 정보를 변경한다.
통상은, 선택된 항목의 텍스트가 취득되지만, 이 옵션을 지정하면, 선택된 항목의 번호가 취득된다.(1번째가 「1」, 미선택시는 공문자열)

Multi

Shift(을)를 누르면서 선택하는 것으로, 복수 선택이 가능하게 된다.Ctrl(을)를 누르면서 클릭하면, 연속하지 않은 항목도 선택 가능.
이 옵션을 지정했을 경우,V옵션으로 지정한 변수에는, 선택 항목(통상은 항목의 문자열,AltSubmit하지만 모두 지정되었을 경우는 항목의 번호)하지만 「|」(으)로 단락지어 취득된다.
단락 문자는 「Gui,+Delimiter`n」(와)과 같이 해 변경할 수 있다.
「Loop, parse, MyListBox, |」라고 하는 것으로, 각 선택 항목에 대해서 처리를 실시할 수 있다.

Tn

탭 위치를 지정한다.
n에는 수치를 지정.n×2피크셀 정도의 폭이 된다.
디폴트는32.
「t8 t16 t8」(와)과 같이 복수를 지정하면, 탭 위치를 개별적으로 지정할 수 있게 된다.
지정한 개수 이후의 탭 위치는, 마지막에 지정한 폭으로 새겨진다.
최대50개까지 지정할 수 있다.

ChooseN

N에 최초로 선택되는 항목의 번호를 지정한다.

Remarks

Multi옵션으로 복수 선택가능으로 하고 있는 경우, 아래와 같이 해 모든 항목을 선택·선택 해제할 수 있다.

Gui +LastFound  ; Avoids the need to specify WinTitle below.
If(V)
	PostMessage, 0x185, 1, -1, ListBox1  ; Select all items. 0x185 is LB_SETSEL.
else
	PostMessage, 0x185, 0, -1, ListBox1  ; Deselect all items.

Related

GUI, Gui,Add

Gui,Add,Hotkey

GUI윈도우에 키보드 쇼트 컷의 편성을 입력하기 위한 컨트롤을 추가한다

Gui, Add, Hotkey [, Options, Text]

Parameters

고유의Option

LimitN

Hotkey그리고 입력 금지로 할 수 있는 수식 키의 조를 설정한다.금지되고 있는 조를 입력하려고 하면, 대신에Ctrl+Alt의 조가 부가된다.
N에는 이하의 수의 화를 설정한다.

1

수식 키 없음을 금지(례:A)

2

Shift키만의 수식 키를 금지(례:Shift+A)

4

Ctrl키만의 수식 키를 금지(례:Ctrl+A)

8

Alt키만의 수식 키를 금지(례:Alt+A)

16

Ctrl+Shift의 수식 키를 금지(례:Ctrl+Shift+A)

32

Alt+Shift의 수식 키를 금지(례:Alt+Shift+A)

128

Ctrl+Alt+Shift의 수식 키를 금지(례:Ctrl+Alt+Shift+A)

Remarks

포커스를 대면시키면서 키를 누르면, 키와 수식 키가 입력된다.
컨트롤에는 「Ctrl + C」(와)과 같이 표시되지만,Text인수로 설정하는 디폴트치나GUI,Submit커멘드등에서 취득되는 값은,Hotkey커멘드나hot key 라벨그리고 사용되는 것과 같은 서식.(례:「^!C」 「^Home」 「^NumpadHome」)수식 키는Ctrl(^),Alt(!),Shift(+)마셔 사용 가능.

Related

GUI, Gui,Add

Gui,Add,GroupBox

GUI윈도우에 복수의 컨트롤을 둘러싸는 테두리를 추가한다

Gui, Add, GroupBox [, Options, Text]

Parameters

고유의Option

BackgroundTrans

배경 부분을 투과 해, 아래에 배치된 컨트롤이 보이도록(듯이) 한다.
나중에 해제하는데는,GuiControl그리고 「+Background」(을)를 설정한다.

Remarks

GroupBox의 안쪽에 컨트롤을 배치하려면 , 다음의 컨트롤을 「xp+」 「yp+」옵션으로 전의 컨트롤의 좌상으로부터의 상대 좌표로 위치를 지정하면 좋다.

Related

GUI, Gui,Add

Gui,Add,Edit

GUI윈도우에 텍스트 입력란을 추가한다

Gui, Add, Edit [, Options, Text]

Parameters

고유의Option

Multi

H(이)나R에 의한 높이의 지정이 없어도 복수행 에디트로 한다

Tn

탭 위치를 지정한다.
n에는 수치를 지정.n×2피크셀 정도의 폭이 된다.
디폴트는32.
「t8 t16 t8」(와)과 같이 복수를 지정하면, 탭 위치를 개별적으로 지정할 수 있게 된다.
지정한 개수 이후의 탭 위치는, 마지막에 지정한 폭으로 새겨진다.
최대50개까지 지정할 수 있다.

Number

10진수치만 입력 가능하게 한다.UpDown컨트롤에 의해, 수치를 증감시키기 위한▲▼버튼을 추가할 수 있다.

Lowercase

알파벳이 모두 소문자가 되도록(듯이) 한다

Uppercase

알파벳이 모두 대문자가 되도록(듯이) 한다

Limit[N]

입력할 수 있는 문자수를 제한한다.
「Limit16」(와)과 같이N에 수치를 지정하면, 그 문자수가 상한이 된다.
N(을)를 생략 했을 경우, 컨트롤의 크기 가득 표시할 수 있는 문자수가 상한이 된다.

WantReturn

통상,Default옵션의 지정되었다Button하지만 있는 경우, 윈도우상에서Enter키를 누르면 그 버튼이 밀리지만,WantReturn하지만 유효하게 되어 있는 복수행의Edit에 포커스가 있는 경우, 대신에 입력란에 개행이 입력된다.
복수행 에디트에서는, 디폴트로 유효하게 된다.「-WantReturn」(을)를 모두 지정하는 것으로 무효로 할 수 있다.

WantTab

Tab키를 눌렀을 때에, 다음의 컨트롤로 이동하는 것이 아니라,Tab문자가 입력되도록(듯이) 한다.
복수행의 경우, 이 옵션이 없어도,Ctrl+Tab그리고 탭 문자를 입력할 수 있다.

WatnCtrlA

Ctrl+A키를 눌렀을 때에 텍스트가 모두 선택되게 된다.
디폴트로 유효하게 되어 있다.

ReadOnly

편집 불가로 한다

Password*

패스워드 입력란과 같이 입력 내용이 마스크 되도록(듯이) 한다.
*에 대신해에 표시되는 문자를 지정

Remarks

복수행 입력란에 포커스가 있을 때는,Enter키는 디폴트 버튼의 눌러 인하는 아니고 개행의 입력이 된다.Tab키는 포커스의 이동인 채이지만,Ctrl+Tab그리고Tab문자를 입력할 수 있다.

변수에 취득될 때, 복수행 입력란의 개행은LF(`n)(이)가 된다.

Related

GUI, Gui,Add

Gui,Add,DropDownList

GUI윈도우에 드롭 다운 리스트를 추가

Gui, Add, DropDownList [, Options, Text]

Parameters

고유의Option

Sort

항목을 항목명 순서에 줄서 바꾸어 표시한다
반각 문자를 타이프 치면 선두가 일치하는 항목으로 이동하는 「인크리멘탈 서치」의 기능도 유효하게 된다.

Lowercase

알파벳이 모두 소문자가 되도록(듯이) 한다

Uppercase

알파벳이 모두 대문자가 되도록(듯이) 한다

AltSubmit

Gui,Submit(이)나GuiControlGet그리고 취득되는 정보를 변경한다.
통상은, 선택된 항목의 텍스트가 취득되지만, 이 옵션을 지정하면, 선택된 항목의 번호가 취득된다.(1번째가 「1」, 미선택시는 공문자열)

ChooseN

N에 최초로 선택되는 항목의 번호를 지정한다.

Remarks

드롭 다운 리스트는,1행의 텍스트 입력란을 닮아 있지만, 「▼」을 클릭하는 것으로 선택 가능 항목의 일람이 전개된다.

Related

GUI, Gui,Add

Gui,Add,DateTime

GUI윈도우에 일자 시각을 입력하는 컨트롤을 추가한다

Gui, Add, DateTime [, Options, Format]

Parameters

고유의Option

ChooseYYYYMMDDHH24MISS

YYYYMMDDHH24MISS(으)로 지정된 일자가 초기 상태로 입력된다.(례:「Choose20050831045349」) 미지정시는 현재 일시가 된다.

RangeMin-Max

Min(와)과Max에 선택 가능한 범위의 하한과 상한을YYYYMMDDHH24MISS의 서식그리고 설정한다.(례:「Range20050101-20051231」)
상한이나 하한의 다른 한쪽만을 지정할 수도 있다(례:「Range20050101」 「Range-20051231」)
지정되지 않았던 경우, 상한은9999년12월31일, 하한은1601년1월1일이 된다.

Right

캘린더가 드롭 다운 표시되는 위치를, 좌단을 컨트롤에 맞추는 것이 아니라, 우단을 대면시키도록(듯이) 한다.

1

드롭 다운 버튼 대신에, 업다운 버튼을 우측으로 부가한다.
이 버튼을 누르면, 컨트롤중의 포커스가 있는 요소가 증감한다.

2

입력란내의 좌측으로 체크 박스를 부가한다.
체크 박스의 체크를 떼면, 일자가 선택되어 있지 않게 된다.
이 때,V옵션으로 지정된 변수에 취득되는 값은 비운다.

ChooseNone

초기 상태로 체크 박스의 체크를OFF(으)로 한다.

Remarks

DateTime컨트롤로 배치되는 일자 시각 입력 컨트롤은, 일견 combobox같지만, 입력란에는 소정의 서식에서 일자 시각을 입력할 수 밖에 하지 못하고, 드롭 다운 버튼을 누른다고 캘린더 컨트롤이 표시되어 일자를 선택할 수 있다.

컨트롤상에서는, 일자 시각의 각 부분 마다 포커스가 이동해, 숫자 키로 직접 입력할 수 있는 것 외에 커서 키의 상하로 값을 증감시키는 것등을 할 수 있다.

Related

GUI, Gui,Add

Example

Gui,Add,DateTime,2 gDT vDTV Choose20040101121101 Range20040101120101,yyyy/MM/dd HH:mm:ss
Gui,Show


DT:
FormatTime,t,%DTV%,yyyy/MM/dd HH:mm:ss
Gui,Show,,%t%
return

Gui,Add,ComboBox

GUI윈도우에 combobox를 추가한다

Gui, Add, ComboBox [, Options, Text]

Parameters

고유의Option

Limit[N]

입력할 수 있는 문자수를, 입력란의 가로폭에 들어가는 문자수까지 제한한다.

Simple

드롭 다운식이 아니고,Edit의 아래에ListBox하지만 있는 형태의 컨트롤이 된다.

Sort

항목을 항목명 순서에 줄서 바꾸어 표시한다

Lowercase

알파벳이 모두 소문자가 되도록(듯이) 한다

Uppercase

알파벳이 모두 대문자가 되도록(듯이) 한다

AltSubmit

Gui,Submit(이)나GuiControlGet그리고 취득되는 정보를 변경한다.
통상은, 선택된 항목의 텍스트가 취득되지만, 이 옵션을 지정하면, 선택된 항목의 번호가 취득된다.(1번째가 「1」, 미선택시는 입력란의 문자열)

ChooseN

N에 최초로 선택되는 항목의 번호를 지정한다.

Remarks

combobox는은,1행의 텍스트 입력란의 오른쪽으로 「▼」버튼이 붙어 있어 이것을 클릭하면 선택 가능 항목이 전개되어 선택하면 그 내용이 입력란에 입력된다.

Related

GUI, Gui,Add

Gui,Add,Checkbox

GUI윈도우에 체크 박스를 추가한다

Gui, Add, Checkbox [, Options, Text]

Parameters

고유의Option

Check3

반체크를 가능하게 한다.

Checked

최초부터 체크된 상태로 한다.
Checked0,Checked1,Checked-1그리고 각각 체크 이루어, 체크 있어, 반체크가 된다.이것은,GUI, Submit등에서 얻을 수 있는 체크 상태를 변수X에 격납해 「Checked%X%」(와)과 같이 해 사용한다.

CheckedGray

초기 상태를 반체크된 상태로 한다.

Remarks

Related

GUI, Gui,Add

Gui,Add,Button

GUI윈도우에 버튼 컨트롤을 추가한다

Gui, Add, Button [, Options, Text]

Parameters

고유의Option

Default

Button(을)를 윈도우의 디폴트 버튼으로 한다.
윈도우가 액티브한 상태로Enter키를 누르면, 그 버튼이 밀린다.

Remarks

Button컨트롤에서는, 「G」옵션으로 써브루틴을 지정하지 않아도, 자동적으로 디폴트의 라벨을 할당할 수 있다.
예를 들어,Text인수가 「Text」의 버튼에서는, 「ButtonText」라고 하는 라벨에 할당할 수 있다.(해당하는 라벨이 존재하면)
다만,Text인수에 반각 스페이스나 「&」, 개행 문자등이 포함되는 경우, 그러한 문자를 제외한 문자열이 사용된다.

2번째 이후의 윈도우의 버튼에 대해서는, 「2ButtonText」(와)과 같은 최초로 윈도우 번호를 매긴 이름의 라벨에 할당할 수 있다.

GUI,Add,Button,,Exit

ButtonExit:
ExitApp

Related

GUI, Gui,Add

Gui,Add

GUI윈도우에 컨트롤을 추가한다

Gui, Add, ControlType [, Options, Text]

Parameters

Options

배치 관계

Xn

n에 컨트롤의 수평 위치를 윈도우의 클라이언트 영역의 좌상으로부터의 상대 좌표로 지정.(례:X100)
생략시는 자동적으로 결정된다.

Yn

n에 컨트롤의 수직 위치를 윈도우의 클라이언트 영역의 좌상으로부터의 상대 좌표로 지정.
생략시는 자동적으로 결정된다.

x+n

컨트롤의 수평 위치를, 직전에 추가한 컨트롤의 우단으로부터의 거리로 지정한다.n에는 부의 값도 지정 가능(례:x+-10)

y+n

컨트롤의 수직 위치를, 직전에 추가한 컨트롤의 하단으로부터의 거리로 지정한다.n에는 부의 값도 지정 가능(례:y+-10)

xp+n

컨트롤의 수평 위치를, 직전에 추가한 컨트롤의 좌단으로부터의 거리로 지정한다.
GroupBox의 안쪽에 컨트롤을 배치하고 싶을 때에 사용한다.

yp+n

컨트롤의 수직 위치를, 직전에 추가한 컨트롤의 상단으로부터의 거리로 지정한다.
GroupBox의 안쪽에 컨트롤을 배치하고 싶을 때에 사용한다.

xm[+n|-n|]

컨트롤의 수평 위치를, 좌단으로 설정한다.「x0」라고 달라, 마진(Remarks참조)(은)는 고려된다.
「xm+100」(이)나 「xm-10」(와)과 같이 수치를 지정하면, 마진을 고려한 좌단으로부터 한층 더 지정 피크셀만 늦추어서 배치된다.

ym[+n|-n|]

컨트롤의 수직 위치를, 상단으로 설정한다.「y0」라고 달라, 마진(Remarks참조)(은)는 고려된다.
「ym+100」(이)나 「ym-10」(와)과 같이 수치를 지정하면, 마진을 고려한 상단으로부터 한층 더 지정 피크셀만 늦추어서 배치된다.

Section

그 컨트롤의 위치를 그 후 사용된다xs,ys옵션을 위한 기준 위치로 설정한다.
제일 최초로 배치되는 컨트롤은, 자동적으로 기준 위치로 설정된다.

xs[+n|-n|]

컨트롤의 수평 위치를,Section그리고 설정한 컨트롤과 같은 위치로 설정한다.
「xm+100」(이)나 「xm-10」(와)과 같이 수치를 지정하면, 지정 피크셀만 늦춘 위치로 설정된다.

ys[+n|-n|]

컨트롤의 수직 위치를,Section그리고 설정한 컨트롤과 같은 위치로 설정한다.
「ym+100」(이)나 「ym-10」(와)과 같이 수치를 지정하면, 지정 피크셀만 늦춘 위치로 설정된다.

Wn

n에 컨트롤의 가로폭을 피크셀수로 지정한다.
생략시는, 일부의 컨트롤은Text인수의 내용이 들어가도록(듯이) 자동 설정되어 그 이외의 경우는 font size의15배로 설정된다.

Hn

n에 컨트롤의 높이를 피크셀수로 지정한다.
H옵션과R의 모두 지정되지 않았던 경우, 높이는 자동적으로 결정된다.
DropDownList,ComboBox그럼, 전개된 드롭 다운의 높이의 지정이 된다.(지정하지 않으면 스크린의 높이 가득 전개된다)

wp[+n|-n]

직전에 배치한 컨트롤의 폭으로부터의 상대치로 폭을 지정한다.
「wp」(이)라면 전의 컨트롤과 같은 폭, 「wp+10」(이)라면10피크셀 넓고, 「wp-10」(이)라면10피크셀 좁아진다.

hp[+n|-n]

직전에 배치한 컨트롤의 높이로부터의 상대치로 높이를 지정한다.

Rn

컨트롤의 높이를 텍스트의 행수로 지정.
n에 행수를 지정한다.소수로의 지정도 가능.
H옵션과 함께 사용했을 경우,R옵션 쪽이 우선된다.
GroupBox그럼, 세로 방향에 늘어놓을 수가 있는 컨트롤의 수가 된다.
DropDownList,ComboBox그럼, 전개된 드롭 다운에 한 번에 표시되는 항목수가 변경된다.

실행 제어 관계

Vn

컨트롤의 입력 내용을 취득하는 변수명을 설정.
n에 변수명을 지정한다.(례:「vName」)
글로벌 변수나 함수내의 스태틱 변수,ByRef인수로 건네받은 글로벌 변수를 지정할 수 있다.
입력 내용을 변수에 반영시키려면 , 「GUI, Submit」(을)를 실행할 필요가 있다.
유저가 값을 입력하는 타입의 컨트롤 이외에도, 변수를 할당해 두는 것으로 「GuiControl」(이)나 「GuiControlGet」커멘드로, 할당한 변수명을 사용해 컨트롤을 지정할 수 있다.

Gn

그 컨트롤이 클릭이나 선택의 변경등의 조작을 하셨을 때에 실행되는 써브루틴을 설정한다.
n에 써브루틴 라벨을 지정한다.
예를 들어, 「gClicked」라고 지정하면 「Clicked」라고 하는 써브루틴이 실행되게 된다.
「gCancel」라고 하는 지정은 특수하고, 「Cancel」라고 하는 라벨이 존재하지 않는 경우, 「GUI, Cancel」의 동작이 대신에 실행되게 된다.
실행되는 써브루틴내에서는, 편입 변수A_GuiControlEvent그리고 더블 클릭 등 특수한 조작을 하신 것을 알 수 있다.(Text,Pictrue,Radio,ListBox등)

HwndN

N그리고 지정한 이름의 변수에 작성된 컨트롤의 윈도우 핸들을 격납한다.(례:「HwndHandle」)
Gui,Add시간만 유효.

스타일 관계

Redraw

표시 내용에 변화가 있었을 때에 재묘화를 실시한다.
디폴트로ON(이)가 되어 있다.
리스트뷰등에서 대량의 항목을 추가·삭제·변경하기 전에GuiControl,-Redraw,ControlID그리고 재묘화를 정지해, 종료후에+Redraw그리고 재개시키는 것으로 퍼포먼스를 개선할 수 있다.

Remarks

윈도우에 최초로 컨트롤을 추가할 경우에, 자동적으로 윈도우가 작성된다.

X/Y옵션으로 좌표를 지정하지 않았던 경우, 컨트롤의 위치는 자동적으로 결정된다.
최초로 추가되는 컨트롤은, 윈도우의 좌상에 배치되어 2번째 이후의 컨트롤은, 직전의 컨트롤의 아래 쪽에 다른 컨트롤과 겹치지 않게 배치된다.
X/Y 중 다른 한쪽만 지정했을 경우, 또 하나의 좌표만이 자동적으로 결정된다.

컨트롤의 사이즈도, 컨트롤의 종류나 텍스트의 내용등에 의해서 자동적으로 결정된다.

자동 레이아웃시에는, 다른 컨트롤로부터 일정한 간격을 열어서 배치된다.
상하의 간격은 선택되고 있는 폰트의 높이의1.25배, 좌우의 간격은0.75배가 된다.
「Gui,Show」(으)로 윈도우가 최초로 표시될 때도, 폭이나 높이가 지정되지 않는 이상 이 마진을 고려해 사이즈가 결정된다.

Related

GUI