Funzione GetWindow (winuser.h)
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 |
|---|---|
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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
Riferimento