SetWindowLongW-Funktion (winuser.h)
Ändert ein Attribut des angegebenen Fensters. Die Funktion legt auch den 32-Bit-Wert (lang) am angegebenen Offset in den zusätzlichen Fensterspeicher fest.
Syntax
LONG SetWindowLongW(
[in] HWND hWnd,
[in] int nIndex,
[in] LONG dwNewLong
);
Parameter
[in] hWnd
Typ: HWND-
Ein Handle für das Fenster und indirekt die Klasse, zu der das Fenster gehört.
[in] nIndex
Typ: int
Der nullbasierte Offset auf den festzulegenden Wert. Gültige Werte liegen im Bereich 0 bis zur Anzahl der Bytes des zusätzlichen Fensterspeichers, minus der Größe einer ganzen Zahl. Wenn Sie einen anderen Wert festlegen möchten, geben Sie einen der folgenden Werte an.
| Wert | Bedeutung |
|---|---|
|
Legt eine neue erweiterte Fensterformatvorlagefest. |
|
Legt ein neues Anwendungsinstanzhandle fest. |
|
Legt einen neuen Bezeichner des untergeordneten Fensters fest. Das Fenster kann kein Fenster der obersten Ebene sein. |
|
Legt eine neue Fensterformatvorlagefest. |
|
Legt die Benutzerdaten fest, die dem Fenster zugeordnet sind. Diese Daten sind für die Verwendung durch die Anwendung vorgesehen, die das Fenster erstellt hat. Der Wert ist anfangs null. |
|
Legt eine neue Adresse für die Fensterprozedur fest.
Sie können dieses Attribut nicht ändern, wenn das Fenster nicht zum gleichen Prozess wie der aufrufende Thread gehört. |
Die folgenden Werte sind auch verfügbar, wenn der hWnd Parameter ein Dialogfeld identifiziert.
[in] dwNewLong
Typ: LONG
Der Ersetzungswert.
Rückgabewert
Typ: LONG
Wenn die Funktion erfolgreich ist, ist der Rückgabewert der vorherigen Wert der angegebenen 32-Bit-Ganzzahl.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Wenn der vorherige Wert der angegebenen 32-Bit-Ganzzahl null ist und die Funktion erfolgreich ist, ist der Rückgabewert null, die Funktion löscht jedoch nicht die letzten Fehlerinformationen. Dies macht es schwierig, Erfolg oder Fehler zu ermitteln. Um dies zu umgehen, sollten Sie die letzten Fehlerinformationen löschen, indem Sie SetLastError- mit 0 aufrufen, bevor Sie SetWindowLong-aufrufen. Dann wird funktionsfehler durch einen Rückgabewert von Null und ein GetLastError Ergebnis angegeben, das ungleich Null ist.
Bemerkungen
Bestimmte Fensterdaten werden zwischengespeichert, sodass Änderungen, die Sie mit SetWindowLong- vornehmen, erst wirksam werden, wenn Sie die SetWindowPos-Funktion aufrufen. Wenn Sie eines der Frameformatvorlagen ändern, müssen Sie SetWindowPos- mit dem SWP_FRAMECHANGED Flag aufrufen, damit der Cache ordnungsgemäß aktualisiert wird.
Wenn Sie SetWindowLong- mit dem GWL_WNDPROC Index verwenden, um die Fensterprozedur zu ersetzen, muss die Fensterprozedur den Richtlinien entsprechen, die in der Beschreibung der WindowProc- Rückruffunktion angegeben sind.
Wenn Sie SetWindowLong- mit dem DWL_MSGRESULT Index verwenden, um den Rückgabewert für eine nachricht festzulegen, die von einer Dialogfeldprozedur verarbeitet wird, sollten Sie TRUE- direkt danach zurückgeben. Wenn Sie andernfalls eine Funktion aufrufen, die dazu führt, dass ihre Dialogfeldprozedur eine Fenstermeldung empfängt, könnte die geschachtelte Fensternachricht den Rückgabewert überschreiben, den Sie mit DWL_MSGRESULTfestgelegt haben.
Durch Aufrufen SetWindowLong- mit dem GWL_WNDPROC Index wird eine Unterklasse der Fensterklasse erstellt, die zum Erstellen des Fensters verwendet wird. Eine Anwendung kann eine Systemklasse unterklassen, sollte jedoch keine Fensterklasse unterklassen, die von einem anderen Prozess erstellt wurde. Die SetWindowLong--Funktion erstellt die Fensterunterklasse, indem die Fensterprozedur geändert wird, die einer bestimmten Fensterklasse zugeordnet ist, wodurch das System die neue Fensterprozedur anstelle des vorherigen Aufrufs aufruft. Eine Anwendung muss alle Nachrichten übergeben, die nicht von der neuen Fensterprozedur an die vorherige Fensterprozedur verarbeitet werden, indem CallWindowProcaufgerufen wird. Auf diese Weise kann die Anwendung eine Kette von Fensterprozeduren erstellen.
Reservieren Sie zusätzlichen Fensterspeicher, indem Sie einen Wert ungleich Null im cbWndExtra- Member der WNDCLASSEX- Struktur angeben, die mit der RegisterClassEx--Funktion verwendet wird.
Sie dürfen nicht SetWindowLong- mit dem GWL_HWNDPARENT Index aufrufen, um das übergeordnete Element eines untergeordneten Fensters zu ändern. Verwenden Sie stattdessen die funktion SetParent.
Wenn das Fenster eine Klassenformatvorlage von CS_CLASSDC oder CS_OWNDCaufweist, legen Sie die erweiterten Fensterformatvorlagen nicht WS_EX_COMPOSITED oder WS_EX_LAYEREDfest.
Wenn Sie SetWindowLong- aufrufen, um die Formatvorlage für eine Statusleiste festzulegen, wird die Position zurückgesetzt.
Beispiele
Ein Beispiel finden Sie unter Subclassing a Window.
Anmerkung
Der winuser.h-Header definiert SetWindowLong als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | winuser.h (enthalten Windows.h) |
| Library | User32.lib |
| DLL- | User32.dll |
| API-Satz | ext-ms-win-ntuser-windowclass-l1-1-0 (eingeführt in Windows 8) |
Siehe auch
Konzeptionelle
Referenz-