SetWindowLongPtrW-Funktion (winuser.h)
Ändert ein Attribut des angegebenen Fensters. Die Funktion legt auch einen Wert am angegebenen Offset im zusätzlichen Fensterspeicher fest.
Syntax
LONG_PTR SetWindowLongPtrW(
[in] HWND hWnd,
[in] int nIndex,
[in] LONG_PTR dwNewLong
);
Parameter
[in] hWnd
Typ: HWND-
Ein Handle für das Fenster und indirekt die Klasse, zu der das Fenster gehört. Die SetWindowLongPtr--Funktion schlägt fehl, wenn der Prozess, der das durch den hWnd Parameter angegebene Fenster besitzt, in einer höheren Prozessberechtigung in der UIPI-Hierarchie liegt als der Prozess, in dem sich der aufrufende Thread befindet.
Windows XP/2000: Die SetWindowLongPtr--Funktion schlägt fehl, wenn das durch den hWnd Parameter angegebene Fenster nicht zum gleichen Prozess wie der aufrufende Thread 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, abzüglich der Größe eines LONG_PTR. 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. |
Die folgenden Werte sind auch verfügbar, wenn der hWnd Parameter ein Dialogfeld identifiziert.
[in] dwNewLong
Typ: LONG_PTR
Der Ersetzungswert.
Rückgabewert
Typ: LONG_PTR
Wenn die Funktion erfolgreich ist, ist der Rückgabewert der vorherige Wert des angegebenen Offsets.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Wenn der vorherige Wert null ist und die Funktion erfolgreich ausgeführt wird, ist der Rückgabewert null, aber die Funktion löscht die letzten Fehlerinformationen nicht. Um Erfolg oder Fehler zu ermitteln, löschen Sie die letzten Fehlerinformationen, indem Sie SetLastError- mit 0 aufrufen, und rufen Sie dann SetWindowLongPtrauf. Funktionsfehler werden 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 SetWindowLongPtr vornehmen, erst wirksam werden, wenn Sie die SetWindowPos-Funktion aufrufen.
Wenn Sie SetWindowLongPtr mit dem GWLP_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 SetWindowLongPtr- mit dem DWLP_MSGRESULT Index verwenden, um den Rückgabewert für eine nachricht festzulegen, die von einer Dialogfeldprozedur verarbeitet wird, sollte die Dialogfeldprozedur 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 meldung mit geschachtelten Fenstern den von Ihnen festgelegten Rückgabewert mit DWLP_MSGRESULTüberschreiben.
Durch Aufrufen SetWindowLongPtr- mit dem GWLP_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 SetWindowLongPtr--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.
Rufen Sie nicht SetWindowLongPtr mit dem GWLP_HWNDPARENT Index auf, 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_PARENTDCaufweist, legen Sie die erweiterten Fensterformatvorlagen nicht WS_EX_COMPOSITED oder WS_EX_LAYEREDfest.
Wenn Sie SetWindowLongPtr- aufrufen, um die Formatvorlage für eine Statusleiste festzulegen, wird die Position zurückgesetzt.
Anmerkung
Der winuser.h-Header definiert SetWindowLongPtr 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-