SetClassLong

Funcţia SetClassLong înlocuieşte valoarea specificată pe 32 de biţi (lung) a la decalajul specificate în memoria clasa extra sau structura WNDCLASSEX clasei de care aparţine fereastra specificat.

(DWORD SetClassLong HWND  hWnd, / / ocupa de fereastraintnIndex, / / index de valoare pentru a modificaLungdwNewLong / / new valoarea);
 

Parametrii

hWnd

Mâner pentru fereastra şi, indirect, clasa de care aparţine fereastra.

nIndex

Specifică valoarea de 32 de biţi pentru a înlocui. Pentru a seta o valoare de 32-biţi în memoria clasa extra, specificaţi decalajul octet pozitive, zero-based de valoare pentru a stabili. Valorile valide sunt în intervalul zero prin numărul de bytes de memorie de clasa extra, minus patru; de exemplu, dacă aţi specificat 12 sau mai multe bytes de memorie de clasa extra, o valoare de 8 ar fi un index la ter?e întreg pe 32 de biţi. Pentru a seta orice altă valoare din structura WNDCLASSEX , specificaţi una din următoarele valori:

Valoarea	Acţiune
GCL_CBCLSEXTRA	Setează dimensiunea, în octeţi, de memorie suplimentar asociate cu clasa. Setarea această valoare nu se modifică numărul de octeţi suplimentare alocate deja.
GCL_CBWNDEXTRA	Setează dimensiunea, în octeţi, fereastra suplimentare de memorie asociate cu fiecare fereastră în clasa de. Setarea această valoare, nu se modifică numărul de octeţi suplimentare alocate deja. Pentru informaţii despre cum să acceseze această memorie, consultaţi SetWindowLong.
GCL_HBRBACKGROUND	Înlocuieşte ghidajul pensulei fundal asociate cu clasa.
GCL_HCURSOR	Înlocuieşte mâner cursorul care asociate cu clasa.
GCL_HICON	Înlocuieşte mâner pictograma asociată cu clasa.
GCL_HMODULE	Înlocuieşte ghidajul de modulul care înregistrează clasa.
GCL_MENUNAME	Înlocuieşte adresa şirul de nume de meniu. Şirul identifică resursa meniu asociate cu clasa.
GCL_STYLE	Înlocuieşte în fereastra-clasa stil bits.
GCL_WNDPROC	Înlocuieşte adresa procedura fereastra asociate cu clasa.

dwNewLong

Specifică valoarea de înlocuire.

Valorile întroarse

Dacă funcţia reuşeşte, valoarea returnată este valoarea anterioară a specificat întreg pe 32 de biţi. Dacă valoarea nu a fost setată anterior, valoarea returnată este zero.

Dacă funcţia nu reuşeşte, valoarea returnată este zero. Pentru a obţine extins informa?ii eroare, apel GetLastError.

Observaţii

Dacă utilizaţi funcţia de SetClassLong şi indicele de GCL_WNDPROC pentru a înlocui procedura fereastra, procedura fereastra trebuie să fie conforme cu liniile directoare specificate în descrierea funcţia de apel invers WindowProc.

Apelarea SetClassLong cu indicele GCL_WNDPROC creează o subclasă de clasa fereastra care afectează toate windows create ulterior cu clasa. Cererea poate subclasă o clasă de sistem, dar ar trebui să nu subclasă o clasă fereastra creat de un alt proces.

Clasa extra memoria de rezervă specificând o valoare nenul în membre cbClsExtra structurii WNDCLASSEX utilizate cu funcţia RegisterClassEx.

Utilizaţi funcţia SetClassLong cu grijă. De exemplu, este posibil pentru a schimba culoarea de fundal pentru o clasă prin folosirea SetClassLong, dar această schimbare nu repaint imediat toate ferestrele din clasa.

Windows CE: Parametrul nIndex este un octet compensată, dar trebuie să fie un multiplu de 4 octeţi. Nealiniată acces nu este acceptată.

Nici unul dintre GCL_ * valorile standard sunt acceptate în parametrul nIndex , cu o singură excepţie. Dacă dispozitivul vă sunt de orientare acceptă un cursor de mouse-ul, utilizaţi valoarea GCL_HCURSOR în parametrul nIndex.

Notă Versiunile Windows CE care acceptă cursoare de mouse-ului includ componentele Iconcurs şi Mcursor, mai degrabă decât componentele Icon şi Cursor.

QuickInfo

nbsp; Windows &NT: necesită versiunea 3.1 sau mai târziu.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Necesită versiunea 1.0 sau mai târziu.
Antet:A declarat în winuser.h.
Import Biblioteca:Utilizarea user32.lib.
Unicode:Pus în aplicare ca Unicode şi ANSI versiuni Windows NT.

A se vedea, de asemenea

Fereastra clase de prezentare, fereastra clasa funcţii, GetClassLong, RegisterClassEx, SetWindowLong, WindowProc, WNDCLASSEX