Função GetDlgItem (winuser.h)

Artigo
03/04/2024

Recupera um identificador para um controle na caixa de diálogo especificada.

Sintaxe

HWND GetDlgItem(
  [in, optional] HWND hDlg,
  [in]           int  nIDDlgItem
);

Parâmetros

[in, optional] hDlg

Digite: HWND

Um identificador para a caixa de diálogo que contém o controle .

[in] nIDDlgItem

Tipo: int

O identificador do controle a ser recuperado.

Retornar valor

Digite: HWND

Se a função for bem-sucedida, o valor retornado será o identificador de janela do controle especificado.

Se a função falhar, o valor retornado será NULL, indicando um identificador de caixa de diálogo inválido ou um controle inexistente. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Você pode usar a função GetDlgItem com qualquer par de janelas pai-filho, não apenas com caixas de diálogo. Desde que o parâmetro hDlg especifique uma janela pai e a janela filho tenha um identificador exclusivo (conforme especificado pelo parâmetro hMenu na função CreateWindow ou CreateWindowEx que criou a janela filho), GetDlgItem retorna um identificador válido para a janela filho.

Exemplos

Para obter um exemplo, consulte Inicializando uma caixa de diálogo.

Requisitos

Requisito	Valor
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 em Windows 8)