GetWindowLongA-Funktion (winuser.h)
Ruft Informationen zum angegebenen Fenster ab. Die Funktion ruft auch den 32-Bit-Wert (DWORD) am angegebenen Offset im zusätzlichen Fensterspeicher ab.
Syntax
LONG GetWindowLongA(
[in] HWND hWnd,
[in] int nIndex
);
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 abzurufenden Wert. Gültige Werte liegen im Bereich 0 bis zur Anzahl der Bytes des zusätzlichen Fensterspeichers minus vier; Wenn Sie beispielsweise 12 oder mehr Bytes zusätzlichen Arbeitsspeicher angegeben haben, wäre ein Wert von 8 ein Index für die dritte 32-Bit-Ganzzahl. Um einen anderen Wert abzurufen, geben Sie einen der folgenden Werte an.
Wert | Bedeutung |
---|---|
|
Ruft die erweiterten Fensterformatvorlagenab. |
|
Ruft ein Handle für die Anwendungsinstanz ab. |
|
Ruft ggf. ein Handle für das übergeordnete Fenster ab. |
|
Ruft den Bezeichner des Fensters ab. |
|
Ruft die Fensterformatvorlagenab. |
|
Ruft die Benutzerdaten ab, 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. |
|
Ruft die Adresse der Fensterprozedur oder ein Handle ab, das die Adresse der Fensterprozedur darstellt. Sie müssen die CallWindowProc--Funktion verwenden, um die Fensterprozedur aufzurufen. |
Die folgenden Werte sind auch verfügbar, wenn der hWnd Parameter ein Dialogfeld identifiziert.
Wert | Bedeutung |
---|---|
|
Ruft die Adresse der Dialogfeldprozedur oder ein Handle ab, das die Adresse der Dialogfeldprozedur darstellt. Sie müssen die CallWindowProc--Funktion verwenden, um die Dialogfeldprozedur aufzurufen. |
|
Ruft den Rückgabewert einer Nachricht ab, die in der Dialogfeldprozedur verarbeitet wird. |
|
Ruft zusätzliche Informationen privat für die Anwendung ab, z. B. Handles oder Zeiger. |
Rückgabewert
Typ: LONG
Wenn die Funktion erfolgreich ist, ist der Rückgabewert der angeforderte Wert.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Wenn SetWindowLong- zuvor nicht aufgerufen wurde, gibt GetWindowLong für Werte im zusätzlichen Fenster oder Klassenspeicher Null zurück.
Bemerkungen
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.
Beispiele
Ein Beispiel finden Sie unter Creating, Enumerating und Sizing Child Windows.
Anmerkung
Der winuser.h-Header definiert GetWindowLong 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-