GetDlgCtrlID

A função GetDlgCtrlID retorna o identificador do controle especificado.

int (GetDlgCtrlID HWND  hwndCtl / / identificador do controle);
 

Parâmetros

hwndCtl
Identifica o controle.

Retornar valores

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

Se a função falhar, o valor de retorno é zero. Um valor inválido para o hwndCtl parâmetro, por exemplo, irá causar a função falha. Para informações de erro estendidas get, chamar GetLastError.

Observações

GetDlgCtrlID aceita identificadores de janela de filho, bem como alças de controles nas caixas de diálogo. Um aplicativo define o identificador para um janela filho quando ele cria a janela, atribuindo o valor de identificador para o hmenu parâmetro ao chamar o CreateWindow ou CreateWindowEx função.

Embora GetDlgCtrlID pode retornar um valor se hwndCtl identifica uma janela de alto nível, de alto nível windows não podem ter identificadores e um valor de retorno nunca é válido.

Windows CE: Identificadores são somente válidas para filho windows.

O identificador pode ser definido, passando-lo em como o hMenu parâmetro para o CreateWindowEx função. Também pode ser definido e recuperado por chamado SetWindowLong e GetWindowLong funções com o nÍndice parâmetro definido como GWL_ID.

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, GetDlgItem

Index