GetClassLong

A GetClassLong função recupera o especificado 32-bit (longo) valor da estrutura de WNDCLASSEX associada com a janela especificada.

(DWORD GetClassLong 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 32-bit valor para recuperar. Para recuperar um valor de 32 bits de adicional memória classe, especifica o deslocamento de byte positivo, baseada em zero do valor a ser recuperados. Os valores válidos estão no intervalo zero através de número de bytes de adicional memória classe, menos quatro; por exemplo, se você especificou 12 ou mais bytes de adicional memória classe, um valor igual a 8 seria um índice para o terceiro 32-bit inteiro. Para recuperar qualquer outro valor a estrutura WNDCLASSEX , especifique um dos seguintes valores:
Valor Ação
GCW_ATOM Recupera um valor de átomo que identifica a classe janela. Este é o mesmo átomo que retorna a função de RegisterClassEx.
GCL_CBCLSEXTRA Recupera o tamanho, em bytes, da adicional memória associado com a classe.
GCL_CBWNDEXTRA Recupera o tamanho, em bytes, da memória extra janela associado com cada janela na classe. Para obter informações sobre como acessar essa memória, consulte GetWindowLong .
GCL_HBRBACKGROUND Recupera o identificador do pincel segundo plano associado com a classe.
GCL_HCURSOR Recupera o identificador do cursor associado com a classe.
GCL_HICON Recupera o identificador do ícone associado com a classe.
GCL_HICONSM Recupera o identificador de ícone pequeno associado com a classe.
GCL_HMODULE Recupera o identificador do módulo que registrou a classe.
GCL_MENUNAME Recupera o endereço da Cadeia de caracteres do nome de menu. A seqüência de caracteres identifica o recurso menu associado com a classe.
GCL_STYLE Recupera os bits de estilo de classe de janela.
GCL_WNDPROC Recupera o endereço do procedimento de janela associado com a classe.

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 classe, especificando um valor diferente de zero in a cbClsExtra membro da estrutura WNDCLASSEX usada com a função de RegisterClassEx.

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

Os únicos valores com suporte para o nÍndice parâmetro são GCL_HICON e GCL_STYLE.

Se você estiver usando o componente Iconcurs do Windows CE, que oferece suporte a cursores de mouse em plataformas de destino apropriado, você também pode usar o valor GCL_HCURSOR in a nÍndice parâmetro.

Observação Versões do Windows CE que mouse suportam cursores incluem os componentes de Iconcurs e Mcursor ao invés dos componentes de ícones e cursores.

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, GetWindowLong, RegisterClassEx, SetClassLong, WNDCLASSEX

Index