Função GetWindowLongA (winuser.h)

Recupera informações sobre a janela especificada. A função também recupera o valor de 32 bits (DWORD) no deslocamento especificado para a memória da janela extra.

Observação Se você estiver recuperando um ponteiro ou um identificador, essa função foi substituída pela função GetWindowLongPtr. (Ponteiros e identificadores são de 32 bits no Windows de 32 bits e 64 bits no Windows de 64 bits.) Para escrever um código compatível com versões de 32 bits e 64 bits do Windows, use GetWindowLongPtr.

 

Sintaxe

LONG GetWindowLongA(
  [in] HWND hWnd,
  [in] int  nIndex
);

Parâmetros

[in] hWnd

Tipo: HWND

Um identificador para a janela e, indiretamente, a classe à qual a janela pertence.

[in] nIndex

Tipo: int

O deslocamento baseado em zero para o valor a ser recuperado. Os valores válidos estão no intervalo zero até o número de bytes de memória de janela extra, menos quatro; por exemplo, se você especificou 12 ou mais bytes de memória extra, um valor de 8 seria um índice para o terceiro inteiro de 32 bits. Para recuperar qualquer outro valor, especifique um dos valores a seguir.

Valor	Significado
GWL_EXSTYLE -20	Recupera os estilos de janela estendidos .
GWL_HINSTANCE -6	Recupera um identificador para a instância do aplicativo.
GWL_HWNDPARENT -8	Recupera um identificador para a janela pai, se houver.
GWL_ID -12	Recupera o identificador da janela.
GWL_STYLE -16	Recupera os estilos de janela .
GWL_USERDATA -21	Recupera os dados do usuário associados à janela. Esses dados são destinados ao uso pelo aplicativo que criou a janela. Seu valor é inicialmente zero.
GWL_WNDPROC -4	Recupera o endereço do procedimento de janela ou um identificador que representa o endereço do procedimento de janela. Você deve usar a função CallWindowProc para chamar o procedimento de janela.

 

Os valores a seguir também estão disponíveis quando o parâmetro hWnd identifica uma caixa de diálogo.

Valor	Significado
DWL_DLGPROC DWLP_MSGRESULT + sizeof(LRESULT)	Recupera o endereço do procedimento da caixa de diálogo ou um identificador que representa o endereço do procedimento da caixa de diálogo. Você deve usar a função CallWindowProc para chamar o procedimento da caixa de diálogo.
DWL_MSGRESULT 0	Recupera o valor retornado de uma mensagem processada no procedimento da caixa de diálogo.
DWL_USER DWLP_DLGPROC + sizeof(DLGPROC)	Recupera informações adicionais privadas para o aplicativo, como identificadores ou ponteiros.

Valor de retorno

Tipo: LONG

Se a função for bem-sucedida, o valor retornado será o valor solicitado.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Se SetWindowLong não tiver sido chamado anteriormente, GetWindowLong retornará zero para valores na janela extra ou na memória de classe.

Observações

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

Exemplos

Para obter um exemplo, consulte Criando, Enumerando e dimensionandofilho do Windows .

Nota

O cabeçalho winuser.h define GetWindowLong como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	winuser.h (inclua Windows.h)
biblioteca	User32.lib
de DLL	User32.dll
conjunto de API	ext-ms-win-ntuser-windowclass-l1-1-0 (introduzido no Windows 8)

Consulte também

CallWindowProc

Conceitual

getWindowLongPtr

de referência de

RegisterClassEx

SetParent

SetWindowLong

WNDCLASS

classes de janela