GetDlgCtrlID
The GetDlgCtrlID
function returns the identifier of the specified control.
int
GetDlgCtrlID(
|
HWND hwndCtl |
// handle of control
|
|
); |
|
Parameters
hwndCtl
Identifies
the control.
Return Values
If the
function succeeds, the return value is the identifier of the control.
If the
function fails, the return value is NULL. An invalid value for the hwndCtl
parameter, for example, will cause the function to fail.
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 hwndCtl identifies a top-level window, top-level
windows cannot have identifiers and such a return value is never valid.
See Also