GetDlgItem

O GetDlgItem função recupera o identificador de um controle na caixa de diálogo especificado.

(HWND GetDlgItem HWND  hDlg, / / identificador da caixa de diálogointnIDDlgItem / / identificador do controle);
 

Parâmetros

hDlg
Identifica a caixa de diálogo que contém o Controlarar.
nIDDlgItem
Especifica o identificador do controle a ser recuperados.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é o identificador de janela do Controlarar fornecido.

Se a função falhar, o valor de retorno é NULL, que indica um identificador de caixa de diálogo inválido ou um controle inexistente. Para informações de erro estendidas get, chamar GetLastError.

Observações

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

Windows CE: O GetDlgItem função funciona somente para controles filho imediato de uma caixa de diálogo — ele não irá procurar pelas caixas de diálogo aninhados.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.

Ver também

Visão geral de caixas de diálogo, funções de caixa de diálogo, CreateWindow, CreateWindowEx, GetDlgItemInt, GetDlgItemText

Index