Funzione GetParent (winuser.h)

Articolo
03/04/2024

Recupera un handle per l'elemento padre o il proprietario della finestra specificata.

Per recuperare un handle in un predecessore specificato, usare la funzione GetAncestor .

Sintassi

HWND GetParent(
  [in] HWND hWnd
);

Parametri

[in] hWnd

Tipo: HWND

Handle per la finestra il cui handle della finestra padre deve essere recuperato.

Valore restituito

Tipo: HWND

Se la finestra è una finestra figlio, il valore restituito è un handle per la finestra padre. Se la finestra è una finestra di primo livello con lo stile WS_POPUP , il valore restituito è un handle per la finestra del proprietario.

Se la funzione ha esito negativo, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Questa funzione in genere ha esito negativo per uno dei motivi seguenti:

La finestra è una finestra di primo livello non creata o non ha lo stile WS_POPUP .
La finestra del proprietario ha WS_POPUP stile.

Commenti

Per ottenere la finestra del proprietario di una finestra, invece di usare GetParent, usare GetWindow con il flag GW_OWNER . Per ottenere la finestra padre e non il proprietario, anziché usare GetParent, usare GetAncestor con il flag GA_PARENT .

Esempio

Per un esempio, vedere Inizializzazione di una finestra di dialogo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-window-l1-1-0 (introdotto in Windows 8)