Função GetDlgCtrlID (winuser.h)

Artigo
08/27/2023

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)