GuiControlGet()
OutputVar := Mfunc.GuiControlGet([Sub-command, ControlID, Param4])
Retrieves various types of information about a control in a GUI window.
Sub
command - See list below.
ControlID
If the target control has an associated variable, specify the variable's name as the ControlID (this method takes precedence over the ones described next). For this reason, it is usually best to assign a variable to any control that will later be accessed via GuiControl or GuiControlGet, even if that control is not input-capable (such as GroupBox or Text).
Otherwise, ControlID can be either ClassNN (the classname and instance number of the control) or the control's text, both of which can be determined via Window Spy. When using text, the matching behavior is determined by SetTitleMatchMode. Note: a picture control's file name (as it was specified at the time the control was created) may be used as its ControlID.
AutoHotkey [v1.1.04+]: ControlID can be the HWND of a control. As with any other ControlID, Sub-command must also include the name or number of the GUI if it is not the default window.
For example, Value := GuiControlGet("2:", Hwnd).
Param4 This parameter is omitted except where noted in the list of sub
commands below.
Returns result of Sub-command. If the command cannot complete (see ErrorLevel below), this variable is made blank.
(Blank): Leave Sub-command blank to retrieve the control's contents. All control types are self-explanatory except the following:
Picture: Retrieves the picture's file name as it was originally specified when the control was created. This name does not change even if a new picture file name is specified.
Edit: Retrieves the contents but any line breaks in the text will be represented as plain linefeeds (`n) rather than the traditional CR+LF (`r`n) used by non-GUI commands such as ControlGetText and ControlSetText.
Hotkey: Retrieves a blank value if there is no hotkey in the control. Otherwise it retrieves the modifiers and key name. Examples: ^!C, ^Home, +^NumpadHome.
Checkbox /Radio: Retrieves 1 if the control is checked, 0 if it is unchecked, or -1 if it has a gray checkmark. To retrieve the control's text/caption instead, specify the word Text for Param4. Note: Unlike the Gui Submit command, radio buttons are always retrieved individually, regardless of whether they are in a radio group.
UpDown/ Slider/ Progress: Retrieves the control's current position.
Tab/ DropDownList/ ComboBox/ ListBox: Retrieves the text of the currently selected item/tab (or its position if the control has the AltSubmit property). For a ComboBox, if there is no selected item, the text in the control's edit field is retrieved instead. For a multi-select ListBox, the output uses the window's current delimiter.
ListView and TreeView: These are not supported when Sub-command is blank. Instead, use the built-in ListView functions and TreeView functions
StatusBar: Retrieves only the first part's text.
ActiveX: Retrieves a new wrapper object for the control's ActiveX component.
Note: To unconditionally retrieve any control's text/caption rather than its contents, specify the word Text for Param4.
GuiControlGet, OutputVar, Pos: Retrieves the position and size of the control. The position is relative to the GUI window's client area, which is the area not including title bar, menu bar, and borders. The information is stored in four variables whose names all start with OutputVar. For example:
MyEdit := Mfunc.GuiControlGet("Pos", "MyEdit")
MsgBox The X coordinate is %MyEditX%. The Y coordinate is %MyEditY%. The width is %MyEditW%. The height is %MyEditH%.
Within a function, to create a set of variables that is global instead of local, declare OutputVar as a global variable prior to using this command (the converse is true for assume-global functions).
GuiControlGet, OutputVar, Focus: Retrieves the control identifier (ClassNN) for the control that currently has keyboard focus. Since the specified GUI window must be active for one of its controls to have focus, OutputVar will be made blank if it is not active. Example usage: focused_control := Mfunc.GuiControlGet("focus").
GuiControlGet, OutputVar, FocusV [v1.0.43.06+]: Same as Focus (above) except that it retrieves the name of the focused control's associated variable. If that control lacks an associated variable, the first 63 characters of the control's text/caption is retrieved instead (this is most often used to avoid giving each button a variable name).
GuiControlGet, OutputVar, Enabled: Retrieves 1 if the control is enabled or 0 if it is disabled.
GuiControlGet, OutputVar, Visible: Retrieves 1 if the control is visible or 0 if it is hidden.
GuiControlGet, OutputVar, Hwnd [v1.0.46.16+]: Retrieves the window handle (HWND) of the control. A control's HWND is often used with PostMessage, SendMessage, and DllCall. Note: HwndOutputVar is usually a more concise way to get the HWND.
GuiControlGet, OutputVar, Name [v1.1.03+]: Retrieves the name of the control's associated variable if it has one, otherwise return value is made blank.
Wrapper for AutoHotkey Docs - GuiControlGet.
Static method.
To operate upon a window other than the default (see below), include its name or number followed by a colon in front of the sub-command as in these examples:
MyEdit := Mfunc.GuiControlGet("MyGui:")
MyEdit := Mfunc.GuiControlGet("MyGui:Pos")
Outputvar := Mfunc.GuiControlGet("MyGui:Focus")
This is required even if ControlID is a control's associated variable or HWND.
A GUI thread is defined as any thread launched as a result of a GUI action. GUI actions include selecting an item from a GUI window's menu bar, or triggering one of its g-labels (such as by pressing a button).
The default window name for a GUI thread is that of the window that launched the thread. Non-GUI threads use 1 as their default.
Any and/or all parameter for this function can be instance of MfString or var containing string.
See Also:AutoHotkey Docs - GuiControlGet.
Throws MfException throw any errors with InnerException set to the Autohotkey - FileRemoveDir error message.
Throws MfException any other general error occurs.
MyEdit := Mfunc.GuiControlGet(, "MyEdit")
CtrlContents := Mfunc.GuiControlGet(, "MyEdit") ; Same as the above except uses a non-default output variable.
MyCheckbox1 := Mfunc.GuiControlGet(, "MyCheckbox1") ; Retrieves 1 if it is checked, 0 if it is unchecked.
MyCheckbox1 := Mfunc.GuiControlGet(, "MyCheckbox1", "Text") ; Retrieves the caption/text of the checkbox.
Pic := Mfunc.GuiControlGet(, "Pos", "Static4") ; The position/size will be stored in PicX, PicY, PicW, and PicH