GetClassLong

La funzione GetClassLong recupera il valore (lungo) a 32 bit specificato dalla struttura WNDCLASSEX associata alla finestra specificata.

(DWORD GetClassLong HWND  hWnd, / / handle di finestraintnIndex / / offset di valore da recuperare);
 

Parametri

hWnd
Gestire la finestra e, indirettamente, la classe a cui appartiene la finestra.
nIndex
Specifica il valore a 32 bit per recuperare. Per recuperare un valore a 32 bit dalla memoria categoria extra, specificare l'offset di byte positivo, in base zero del valore da recuperare. I valori validi sono nella gamma zero attraverso il numero di byte di memoria categoria extra, meno quattro; ad esempio, se è stato specificato 12 o più byte di memoria categoria extra, un valore di 8 sarebbe un indice per il terzo integer a 32 bit. Per recuperare un altro valore dalla struttura WNDCLASSEX , specificare uno dei seguenti valori:
Valore Azione
GCW_ATOM Recupera un valore di atomo che identifica in modo univoco la classe finestra. Questo è l'atomo stesso che restituisce la funzione RegisterClassEx.
GCL_CBCLSEXTRA Recupera la dimensione in byte di memoria supplementare associato alla classe.
GCL_CBWNDEXTRA Recupera la dimensione in byte di memoria supplementare finestra associati a ogni finestra nella classe. Per informazioni su come accedere a questa memoria, vedere GetWindowLong.
GCL_HBRBACKGROUND Recupera l'handle del pennello sfondo associato alla classe.
GCL_HCURSOR Recupera l'handle del cursore associato alla classe.
GCL_HICON Recupera l'handle dell'icona associato alla classe.
GCL_HICONSM Recupera l'handle della piccola icona associata alla classe.
GCL_HMODULE Recupera l'handle del modulo che ha registrato la classe.
GCL_MENUNAME Recupera l'indirizzo della stringa del nome dal menu. La stringa identifica la risorsa di menu associata alla classe.
GCL_STYLE Recupera i bit di stile della classe della finestra.
GCL_WNDPROC Recupera l'indirizzo di una routine di finestra associata alla classe.

Valori restituiti

Se la funzione ha esito positivo, il valore restituito è il valore richiesto a 32-bit.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni di errore estese, chiamare GetLastError.

Osservazioni

Riserva di memoria categoria extra specificando un valore diverso da zero nel membro cbClsExtra della struttura WNDCLASSEX utilizzata con la funzione RegisterClassEx.

Windows CE: Il parametro nIndex è un byte compensata ma deve essere un multiplo di 4 byte. Windows CE non supporta l'accesso non allineato.

Gli unici valori supportati per il parametro nIndex sono GCL_HICON e GCL_STYLE.

Se si utilizza il componente Windows CE Iconcurs, che supporta cursori del mouse su piattaforme di destinazione appropriata, è anche possibile utilizzare il valore GCL_HCURSOR nel parametro nIndex.

Nota Versioni di Windows CE che supportano i cursori del mouse includono i componenti Iconcurs e Mcursor, piuttosto che i componenti di icone e cursori.

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 1.0 o successiva.
Intestazione:Dichiarati in winuser.
Importare librerie:Utilizzare user32.lib.
Unicode:Implementato come versioni Unicode e ANSI su Windows NT.

Vedi anche

Finestra panoramica di classi, funzioni di classe Window, GetWindowLong, RegisterClassEx, SetClassLong, WNDCLASSEX

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index