GetParent-Funktion (winuser.h)
Ruft ein Handle an das übergeordnete Element oder den Besitzer des angegebenen Fensters ab.
Verwenden Sie die GetAncestor-Funktion , um ein Handle für einen angegebenen Vorgänger abzurufen.
Syntax
HWND GetParent(
[in] HWND hWnd
);
Parameter
[in] hWnd
Typ: HWND
Ein Handle für das Fenster, dessen Übergeordnetes Fensterhandle abgerufen werden soll.
Rückgabewert
Typ: HWND
Wenn das Fenster ein untergeordnetes Fenster ist, ist der Rückgabewert ein Handle für das übergeordnete Fenster. Wenn es sich bei dem Fenster um ein Fenster auf oberster Ebene mit dem WS_POPUP Stil handelt, ist der Rückgabewert ein Handle für das Besitzerfenster.
Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Diese Funktion schlägt in der Regel aus einem der folgenden Gründe fehl:
- Das Fenster ist ein Fenster auf oberster Ebene, das nicht vorhanden ist oder nicht über den WS_POPUP-Stil verfügt.
- Das Besitzerfenster weist WS_POPUP Stil auf.
Hinweise
Verwenden Sie GetWindow mit dem Flag GW_OWNER, um das Besitzerfenster eines Fensters abzurufen, anstatt GetParent zu verwenden. Verwenden Sie GetAncestor mit dem flag GA_PARENT, um das übergeordnete Fenster und nicht den Besitzer zu erhalten, anstatt GetParent zu verwenden.
Beispiele
Ein Beispiel finden Sie unter Initialisieren eines Dialogfelds.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winuser.h (windows.h einschließen) |
| Bibliothek | User32.lib |
| DLL | User32.dll |
| APIs | ext-ms-win-ntuser-window-l1-1-0 (eingeführt in Windows 8) |
Siehe auch
Konzept
Referenz