Função GetDlgCtrlID (winuser.h)
Recupera o identificador do controle especificado.
Sintaxe
int GetDlgCtrlID(
[in] HWND hWnd
);
Parâmetros
[in] hWnd
Digite: HWND
Um identificador para o controle.
Valor retornado
Tipo: int
Se a função for bem-sucedida, o valor retornado será o identificador do controle .
Se a função falhar, o valor retornado será zero. Um valor inválido para o parâmetro hwndCtl , por exemplo, fará com que a função falhe. Para obter informações de erro estendidas, chame GetLastError.
Comentários
GetDlgCtrlID aceita identificadores de janela filho, bem como identificadores de controles em caixas de diálogo. Um aplicativo define o identificador de uma janela filho quando cria a janela atribuindo o valor do identificador ao parâmetro hmenu ao chamar a função CreateWindow ou CreateWindowEx .
Embora GetDlgCtrlID possa retornar um valor se hwndCtl for um identificador para uma janela de nível superior, as janelas de nível superior não poderão ter identificadores e esse valor retornado nunca será válido.
Exemplos
Para obter um exemplo, consulte Inicializando uma caixa de diálogo.
Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winuser.h (inclua Windows.h) |
| Biblioteca | User32.lib |
| DLL | User32.dll |
| Conjunto de APIs | ext-ms-win-ntuser-dialogbox-l1-1-0 (introduzido no Windows 8) |
Confira também
Conceitual
Referência