Function Reference


_WinAPI_GetDlgCtrlID

Show description in

Returns the identifier of the specified control

#include <WinAPIDlg.au3>
_WinAPI_GetDlgCtrlID ( $hWnd )

Parameters

$hWnd Handle to the control

Return Value

Success: Identifier of the control
Failure: 0, call _WinAPI_GetLastError() to get extended error information

Remarks

GetDlgCtrlID accepts child window handles as well as handles of controls in dialog boxes.
An application sets the identifier for a child window when it creates the window by assigning the identifier value to the hmenu parameter when calling the CreateWindow or CreateWindowEx function.
Although GetDlgCtrlID may return a value if $hWnd identifies a top-level window, top-level windows cannot have identifiers and such a return value is never valid.

See Also

Search GetDlgCtrlID in MSDN Library.

Example

#include <MsgBoxConstants.au3>
#include <WinAPIDlg.au3>

Example()

Func Example()
        Local $idButton
        GUICreate("test")
        $idButton = GUICtrlCreateButton("testing", 0, 0)
        MsgBox($MB_SYSTEMMODAL, "ID", "Dialog Control ID: " & _WinAPI_GetDlgCtrlID(GUICtrlGetHandle($idButton)))
EndFunc   ;==>Example