SetClassLong

De SetClassLong functie vervangt de opgegeven 32-bits (lange) waarde op de gespecificeerde offset in de klasse extra geheugen of de structuur van de WNDCLASSEX voor de klasse waartoe het opgegeven venster behoort.

(DWORD-SetClassLong HWND  hWnd, / / verwerken van vensterintnIndex, / / index van waarde te wijzigenLangedwNewLong / / nieuwe waarde);
 

Parameters

hWnd
Ingang naar de venster en, indirect, de klasse waartoe het venster behoort.
nIndex
Hiermee geeft u de 32-bits waarde te vervangen. U stelt een 32-bits waarde in de klasse extra geheugen, geven de positieve, op nul gebaseerde byteoffset van de waarde moet worden ingesteld. Geldige waarden zijn in het bereik door het aantal bytes van het geheugen van de extra klasse, nul minus 4; bijvoorbeeld, als u 12 of meer bytes van klasse extra geheugen opgegeven, zou een waarde van 8 een index op de derde 32-bits integer. Wilt instellen een andere waarde vanuit de WNDCLASSEX structuur, een van de volgende waarden opgeven:
Waarde Actie
GCL_CBCLSEXTRA Hiermee stelt de grootte, in bytes, van de extra geheugen gekoppeld is aan de klasse. Deze waarde verandert niet het aantal extra bytes al toegewezen.
GCL_CBWNDEXTRA Hiermee stelt de grootte, in bytes, van de extra venster geheugen elk venster in de klasse is gekoppeld. Deze waarde verandert niet het aantal extra bytes al toegewezen. Zie voor informatie over hoe u dit geheugen, SetWindowLong.
GCL_HBRBACKGROUND Vervangt het handvat van de achtergrond borstel die is gekoppeld aan de klasse.
GCL_HCURSOR Vervangt de greep van de cursor die is gekoppeld aan de klasse.
GCL_HICON Vervangt de greep van het pictogram dat hoort bij de klasse.
GCL_HMODULE Vervangt de greep van de module die de klasse geregistreerd.
GCL_MENUNAME Het adres van de tekenreeks van de naam van het menu vervangt. De tekenreeks geeft het menu bron die is gekoppeld aan de klasse.
GCL_STYLE Vervangt de bits stijl venster-klasse.
GCL_WNDPROC Vervangt het adres van de venster-procedure die is gekoppeld aan de klasse.

dwNewLong
Hiermee geeft u de vervangende waarde.

Retourwaarden

Als de functie slaagt, is de geretourneerde waarde de vorige waarde van de opgegeven 32-bits geheel getal. Als de waarde niet eerder werd ingesteld, is de retourwaarde nul.

Als de functie mislukt, is de retourwaarde nul. Te krijgen uitgebreide foutinformatie, Bel GetLastError.

Opmerkingen

Als u de functie SetClassLong en de GCL_WNDPROC-index gebruikt ter vervanging van de venster-procedure, moet de procedure venster voldoen aan de richtlijnen gespecificeerd in de beschrijving van de WindowProc callback functie.

SetClassLong aanroepen met de GCL_WNDPROC-index wordt gemaakt van een subklasse van de klasse venster dat is van invloed op alle windows vervolgens gemaakt met de klasse. Een toepassing kan subklasse een klasse systeem, maar moet niet de subklasse een venster klasse door een ander proces gemaakt.

Klasse extra geheugen reserveren door te geven een andere waarde dan nul in het lid cbClsExtra van de WNDCLASSEX structuur gebruikt met de functie RegisterClassEx.

De functie SetClassLong met zorg. Bijvoorbeeld, het is mogelijk om de achtergrondkleur voor een klasse wijzigen met behulp van SetClassLong, maar deze wijziging doet niet onmiddellijk alle vensters die behoren tot de klasse repaint.

Windows CE: De parameter nIndex is een byte compenseren maar moet een veelvoud van 4 bytes. Unaligned toegang wordt niet ondersteund.

Geen van de standaard GCL_ * waarden worden ondersteund in de parameter nIndex , met één uitzondering. Als het apparaat u bent doelgerichtheid een muiscursor ondersteunt, kunt u de GCL_HCURSOR waarde in de parameter nIndex.

Opmerking Windows CE versies die ondersteuning bieden voor muiscursors bevatten de onderdelen Iconcurs en Mcursor in plaats van het pictogram en Cursor componenten.

Syntaxisinfo

nbsp; Windows &NT: versie 3.1 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Versie 1.0 of hoger vereist.
Header:Verklaard in winuser.h.
Bibliotheek importeren:User32.lib gebruiken.
Unicode:Geïmplementeerd als Unicode en ANSI-versies van Windows NT.

Zie ook

Overzicht van venster klassen, venster klasse functies, GetClassLong, RegisterClassEx, SetWindowLong, WindowProc, WNDCLASSEX