Funzione GetWindow (winuser.h)

  • Articolo

Recupera un handle in una finestra con la relazione specificata (Z-Order o proprietario) nella finestra specificata.

Sintassi

HWND GetWindow(
  [in] HWND hWnd,
  [in] UINT uCmd
);

Parametri

[in] hWnd

Tipo: HWND

Handle di una finestra. L'handle della finestra recuperato è relativo a questa finestra, in base al valore del parametro uCmd .

[in] uCmd

Tipo: UINT

Relazione tra la finestra specificata e la finestra il cui handle deve essere recuperato. Questo parametro può avere uno dei valori seguenti.

Valore Significato
GW_CHILD
5
 L'handle recuperato identifica la finestra figlio nella parte superiore dell'ordine Z, se la finestra specificata è una finestra padre; in caso contrario, l'handle recuperato è NULL. La funzione esamina solo le finestre figlio della finestra specificata. Non esamina le finestre discendenti.
GW_ENABLEDPOPUP
6
 L'handle recuperato identifica la finestra popup abilitata di proprietà della finestra specificata (la ricerca usa la prima finestra trovata usando GW_HWNDNEXT); in caso contrario, se non sono presenti finestre popup abilitate, l'handle recuperato è quello della finestra specificata.
GW_HWNDFIRST
0
 L'handle recuperato identifica la finestra dello stesso tipo più alto nell'ordine Z.

Se la finestra specificata è una finestra superiore, l'handle identifica una finestra superiore. Se la finestra specificata è una finestra di primo livello, l'handle identifica una finestra di primo livello. Se la finestra specificata è una finestra figlio, l'handle identifica una finestra di pari livello.
GW_HWNDLAST
1
 L'handle recuperato identifica la finestra dello stesso tipo più bassa nell'ordine Z.

Se la finestra specificata è una finestra superiore, l'handle identifica una finestra superiore. Se la finestra specificata è una finestra di primo livello, l'handle identifica una finestra di primo livello. Se la finestra specificata è una finestra figlio, l'handle identifica una finestra di pari livello.
GW_HWNDNEXT
2
 L'handle recuperato identifica la finestra sotto la finestra specificata nell'ordine Z.

Se la finestra specificata è una finestra superiore, l'handle identifica una finestra superiore. Se la finestra specificata è una finestra di primo livello, l'handle identifica una finestra di primo livello. Se la finestra specificata è una finestra figlio, l'handle identifica una finestra di pari livello.
GW_HWNDPREV
3
 L'handle recuperato identifica la finestra sopra la finestra specificata nell'ordine Z.

Se la finestra specificata è una finestra superiore, l'handle identifica una finestra superiore. Se la finestra specificata è una finestra di primo livello, l'handle identifica una finestra di primo livello. Se la finestra specificata è una finestra figlio, l'handle identifica una finestra di pari livello.
GW_OWNER
4
 L'handle recuperato identifica la finestra del proprietario della finestra specificata, se presente. Per altre informazioni, vedere Windows di proprietà.

Valore restituito

Tipo: HWND

Se la funzione ha esito positivo, il valore restituito è un handle di finestra. Se non esiste alcuna finestra con la relazione specificata alla finestra specificata, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione EnumChildWindows è più affidabile rispetto alla chiamata a GetWindow in un ciclo. Un'applicazione che chiama GetWindow per eseguire questa attività rischia di essere rilevata in un ciclo infinito o facendo riferimento a un handle a una finestra che è stata eliminata.

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)

Vedi anche

Informazioni concettuali

EnumChildWindows

Riferimento

Windows