GetWindowLong

La funzione GetWindowLong recupera informazioni sulla finestra specificata. La funzione recupera anche il valore a 32 bit (lungo) all'offset specificato nella memoria di una finestra supplementare finestra.

LONG GetWindowLong ( 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 l'offset in base zero, il valore viene recuperato. I valori validi sono nella gamma zero attraverso il numero di byte di memoria finestra supplementare, meno quattro; ad esempio, se è stato specificato 12 o più byte di memoria aggiuntiva, un valore di 8 sarebbe un indice per il terzo integer a 32 bit. Per recuperare un altro valore, specificare uno dei seguenti valori:

Valore	Azione
GWL_EXSTYLE	Recupera gli stili estesi finestra.
GWL_STYLE	Recupera gli stili della finestra.
GWL_WNDPROC	Recupera l'indirizzo della routine di finestra o una maniglia che rappresenta l'indirizzo di una routine di finestra. È necessario utilizzare la funzione CallWindowProc per chiamare la routine della finestra.
GWL_HINSTANCE	Recupera l'handle dell'istanza application.
GWL_HWNDPARENT	Recupera l'handle della finestra padre, se del caso.
GWL_ID	Recupera l'identificatore della finestra.
GWL_USERDATA	Recupera il valore a 32-bit associato alla finestra. Ogni finestra ha un valore corrispondente a 32-bit destinato all'uso dall'applicazione che ha creato la finestra.

I valori seguenti sono disponibili anche quando il parametro hWnd identifica una finestra di dialogo:

Valore	Azione
DWL_DLGPROC	Recupera l'indirizzo della procedura della casella di dialogo o una maniglia che rappresenta l'indirizzo della procedura di dialogo casella. È necessario utilizzare la funzione CallWindowProc per chiamare la routine di finestra di dialogo.
DWL_MSGRESULT	Recupera il valore restituito di un messaggio elaborato nella procedura di dialogo casella.
DWL_USER	Recupera informazioni extra privata all'applicazione, quali maniglie o puntatori.

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 supplementare finestra specificando un valore diverso da zero nel membro cbWndExtra della struttura WNDCLASSEX utilizzata con la funzione RegisterClassEx.

Windows CE: Il parametro nIndex deve essere un multiplo di 4 byte. Accesso non allineato non è supportato.

Windows CE non supporta i valori GWL_HINSTANCE e GWL_HWNDPARENT nel parametro nIndex.

Windows CE 1.0 non supporta inoltre il valore DWL_DLGPROC e GWL_USERDATA nel parametro nIndex.

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, CallWindowProc, RegisterClassEx, SetParent, SetWindowLong, WNDCLASS

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

Index