Funzione SetWindowLongA (winuser.h)
Modifica un attributo della finestra specificata. La funzione imposta anche il valore a 32 bit (long) in corrispondenza dell'offset specificato nella memoria della finestra aggiuntiva.
Sintassi
LONG SetWindowLongA(
[in] HWND hWnd,
[in] int nIndex,
[in] LONG dwNewLong
);
Parametri
[in] hWnd
Tipo: HWND
Handle alla finestra e, indirettamente, alla classe a cui appartiene la finestra.
[in] nIndex
Tipo: int
Offset in base zero al valore da impostare. I valori validi si trovano nell'intervallo zero tramite il numero di byte di memoria finestra aggiuntiva, meno le dimensioni di un intero. Per impostare qualsiasi altro valore, specificare uno dei valori seguenti.
| Valore | Significato |
|---|---|
|
Imposta un nuovo stile della finestra estesa. |
|
Imposta un nuovo handle di istanza dell'applicazione. |
|
Imposta un nuovo identificatore della finestra figlio. La finestra non può essere una finestra di primo livello. |
|
Imposta un nuovo stile di finestra. |
|
Imposta i dati utente associati alla finestra. Questi dati sono destinati all'uso da parte dell'applicazione che ha creato la finestra. Il valore è inizialmente zero. |
|
Imposta un nuovo indirizzo per la routine della finestra.
Non è possibile modificare questo attributo se la finestra non appartiene allo stesso processo del thread chiamante. |
I valori seguenti sono disponibili anche quando il parametro hWnd identifica una finestra di dialogo.
[in] dwNewLong
Tipo: LONG
Valore sostitutivo.
Valore restituito
Tipo: LONG
Se la funzione ha esito positivo, il valore restituito è il valore precedente dell'intero a 32 bit specificato.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Se il valore precedente dell'intero a 32 bit specificato è zero e la funzione ha esito positivo, il valore restituito è zero, ma la funzione non cancella le ultime informazioni sull'errore. Ciò rende difficile determinare l'esito positivo o negativo. Per risolvere questo problema, è necessario cancellare le ultime informazioni sull'errore chiamando SetLastError con 0 prima di chiamare SetWindowLong. Quindi, l'errore della funzione verrà indicato da un valore restituito pari a zero e da un risultato GetLastError diverso da zero.
Commenti
Alcuni dati della finestra vengono memorizzati nella cache, pertanto le modifiche apportate tramite SetWindowLong non avranno effetto finché non si chiama la funzione SetWindowPos . In particolare, se si modifica uno degli stili di frame, è necessario chiamare SetWindowPos con il flag di SWP_FRAMECHANGED per l'aggiornamento corretto della cache.
Se si usa SetWindowLong con l'indice GWL_WNDPROC per sostituire la procedura della finestra, la procedura della finestra deve essere conforme alle linee guida specificate nella descrizione della funzione di callback WindowProc .
Se si usa SetWindowLong con l'indice DWL_MSGRESULT per impostare il valore restituito per un messaggio elaborato da una procedura di dialogo, è necessario restituire TRUE direttamente in seguito. In caso contrario, se si chiama una funzione che comporta la ricezione di un messaggio di finestra, il messaggio della finestra annidata potrebbe sovrascrivere il valore restituito impostato usando DWL_MSGRESULT.
La chiamata a SetWindowLong con l'indice GWL_WNDPROC crea una sottoclasse della classe di finestra usata per creare la finestra. Un'applicazione può sottoclassere una classe di sistema, ma non deve sottoclasse una classe finestra creata da un altro processo. La funzione SetWindowLong crea la sottoclasse della finestra modificando la routine della finestra associata a una determinata classe di finestra, causando al sistema di chiamare la nuova routine della finestra anziché quella precedente. Un'applicazione deve passare qualsiasi messaggio non elaborato dalla nuova procedura della finestra alla procedura della finestra precedente chiamando CallWindowProc. Ciò consente all'applicazione di creare una catena di procedure di finestra.
Riservare memoria finestra aggiuntiva specificando un valore diverso da zero nel membro cbWndExtra della struttura WNDCLASSEX usato con la funzione RegisterClassEx .
Non è necessario chiamare SetWindowLong con l'indice GWL_HWNDPARENT per modificare l'elemento padre di una finestra figlio. Usare invece la funzione SetParent .
Se la finestra ha uno stile di classe di CS_CLASSDC o CS_OWNDC, non impostare gli stili di finestra estesi WS_EX_COMPOSITED o WS_EX_LAYERED.
La chiamata a SetWindowLong per impostare lo stile su una barra di avanzamento reimposta la posizione.
Esempio
Per un esempio, vedere Sottoclassing di una finestra.
Nota
L'intestazione winuser.h definisce SetWindowLong come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winuser.h (include Windows.h) |
| Libreria | User32.lib |
| DLL | User32.dll |
| Set di API | ext-ms-win-ntuser-windowclass-l1-1-0 (introdotto in Windows 8) |
Vedi anche
Informazioni concettuali
Riferimento