Função GetDlgItem (winuser.h)
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) |
Confira também
Conceitual
Referência