GetWindowLong

A GetWindowLong função recupera informações sobre a janela especificada. A função também recupera a 32-bit (longo) valor no deslocamento especificado para a adicional memória janela de uma janela.

LONG GetWindowLong ( HWND  hWnd, / / identificador da janelaintnIndex / / deslocamento do valor para recuperar);
 

Parâmetros

hWnd
Identificador para a janela e, indiretamente, a classe à qual pertence a janela.
nIndex
Especifica o deslocamento baseada em zero para o valor a ser recuperados. Os valores válidos estão no intervalo zero através de número de bytes de adicional memória janela, menos quatro; por exemplo, se você especificou 12 ou mais bytes de memória extra, um valor igual a 8 seria um índice para o terceiro 32-bit inteiro. Para recuperar qualquer outro valor, especifique um dos seguintes valores:
Valor Ação
GWL_EXSTYLE Recupera os estilos janela estendido.
GWL_STYLE Recupera os estilos janela.
GWL_WNDPROC Recupera o endereço do procedimento de janela, ou um identificador que representa o endereço do procedimento de janela. Você deve usar o CallWindowProc função para chamar o procedimento janela.
GWL_HINSTANCE Recupera o identificador de instância do aplicativo.
GWL_HWNDPARENT Recupera o identificador da janela pai, se qualquer.
GWL_ID Recupera o identificador da janela.
GWL_USERDATA Recupera o 32-bit valor associado com a janela. Cada janela possui um correspondente 32-bit valor destinado ao uso pelo aplicativo que criou a janela.

Os valores a seguir também estão disponíveis quando o hWnd parâmetro identifica uma caixa de diálogo:
Valor Ação
DWL_DLGPROC Recupera o endereço do procedimento de caixa de diálogo, ou um identificador que representa o endereço do procedimento de caixa de diálogo. Você deve usar o CallWindowProc função para chamar o procedimento de caixa de diálogo.
DWL_MSGRESULT Recupera o valor de retorno de uma mensagem processada no procedimento de caixa de diálogo.
DWL_USER Recupera adicional informações particulares para o aplicativo, such as alças ou ponteiros.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é o valor de 32 bits pedido.

Se a função falhar, o valor de retorno é zero. Para informações de erro estendidas get, chamar GetLastError.

Observações

Reserve adicional memória janela, especificando um valor diferente de zero no cbWndExtra membro da estrutura WNDCLASSEX usado com a função de RegisterClassEx.

Windows CE: O nÍndice parâmetro deve ser um múltiplo de 4 bytes. Não é com suporte unaligned acessar.

Windows CE não oferece suporte os valores GWL_HINSTANCE e GWL_HWNDPARENT in a nÍndice parâmetro.

Windows CE 1.0 também não suporte o DWL_DLGPROC e GWL_USERDATA valor in a nÍndice parâmetro.

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.
Unicode:Implementado como versões Unicode e ANSI no Windows NT.

Ver também

Visão geral da janela Classes, funções de classe de janela, CallWindowProc, RegisterClassEx, SetParent, SetWindowLong, WNDCLASS

Index