Compartilhar via


GetDlgCtrlID

Windows Mobile SupportedWindows Embedded CE Supported

9/9/2008

Essa função retorna o identificador do controle especificado.

Syntax

int GetDlgCtrlID( 
  HWND hwndCtl
); 

Parameters

  • hwndCtl
    [no] Identificador para o controle.

Return Value

O identificador do controle indica sucesso. Zero indica falha. Um valor inválido para a hwndCtl parâmetro, de exemplo, irá causar a função falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

Os identificadores são válido somente para janelas filho. Um aplicativo Define o identificador passando-lo em como o hMenu parâmetro para o CreateWindowEx função. Ele também pode ser definido e recuperado por chamado de SetWindowLong e GetWindowLong funções com o nÍndice parâmetro definido como GWL_ID.

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

Requirements

Header winuser.h
Library Dlgmgr.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

CreateWindow
CreateWindowEx
GetDlgItem
GetWindowLong
SetWindowLong
Dialog Boxes Functions