GetWindow

La funzione GetWindow recupera un handle a una finestra che ha la relazione specificata (ordine z o proprietario) per la finestra specificata.

(HWND GetWindow HWND  hWnd, / / handle di finestra originaleUINTuCmd / / rapporto bandiera);
 

Parametri

hWnd
Handle per una finestra. L'handle di finestra estratto relativo a questa finestra, sulla base del valore del parametro uCmd.
uCmd
Specifica la relazione tra la finestra specificata e la finestra in cui manico da recuperare. Questo parametro pu essere uno dei seguenti valori:
Valore Significato
GW_CHILD L'handle recuperato identifica finestra secondaria nella parte superiore dell'ordine Z, se la finestra specificata una finestra padre; in caso contrario, l'handle recuperato NULL. La funzione esamina solo finestre figlio della finestra specificata. Esso non esamina finestre.
GW_ENABLEDPOPUP Windows NT 5.0 e versioni successive: L'handle recuperato identifica la finestra di pop-up attivato propriet della finestra specificata (la ricerca utilizza la prima come finestra trovato utilizzando GW_HWNDNEXT); in caso contrario, se non ci sono finestre popup abilitati, l'handle recuperato quella della finestra specificata.
GW_HWNDFIRST L'handle recuperato identifica la finestra dello stesso tipo che pi alto nell'ordine Z. Se la finestra specificata una finestra in primo piano, la maniglia identifica la finestra in primo piano che pi alta nell'ordine Z. Se la finestra specificata una finestra di primo livello, l'handle identifica la finestra di primo livello pi alta nell'ordine Z. Se la finestra specificata un bambino, la maniglia identifica la finestra di pari livello che pi alta nell'ordine z.
GW_HWNDLAST L'handle recuperato identifica la finestra dello stesso tipo che pi basso nell'ordine Z. Se la finestra specificata una finestra in primo piano, la maniglia identifica la finestra in primo piano che pi bassa nell'ordine Z. Se la finestra specificata una finestra di primo livello, l'handle identifica la finestra di primo livello pi bassa nell'ordine Z. Se la finestra specificata un bambino, la maniglia identifica la finestra di pari livello che pi bassa nell'ordine z.
GW_HWNDNEXT L'handle recuperato identifica la finestra sotto la finestra specificata nell'ordine Z. Se la finestra specificata una finestra in primo piano, la maniglia identifica la finestra in primo piano sotto la finestra specificata. Se la finestra specificata una finestra di primo livello, l'handle identifica la finestra di primo livello di sotto la finestra specificata. Se la finestra specificata un bambino, la maniglia identifica la finestra di pari livello sotto la finestra specificata.
GW_HWNDPREV L'handle recuperato identifica la finestra sopra la finestra specificata nell'ordine Z. Se la finestra specificata una finestra in primo piano, la maniglia identifica la finestra in primo piano sopra la finestra specificata. Se la finestra specificata una finestra di primo livello, l'handle identifica la finestra di primo livello sopra la finestra specificata. Se la finestra specificata un bambino, la maniglia identifica la finestra di pari livello sopra la finestra specificata.
GW_OWNER L'handle recuperato identifica la finestra proprietaria della finestra specificata, se del caso.

Valori restituiti

Se la funzione ha esito positivo, il valore restituito un handle di finestra. Se nessuna finestra esiste con la relazione specificata nella finestra specificata, il valore restituito NULL. Per ottenere informazioni di errore estese, chiamare GetLastError.

Osservazioni

La funzione EnumChildWindows pi affidabile di chiamare GetWindow in un ciclo. Un'applicazione che chiamate GetWindow per eseguire questa operazione rischia di essere catturato in un ciclo infinito o che fa riferimento a un handle a una finestra che stata distrutta.

Windows CE: In Windows CE versione 1.0, il valore del flag GW_OWNER per il parametro uCmd supportato solo per le finestre di dialogo.

Descrizione

nbsp;Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 1.0 o successiva.
Intestazione:Dichiarati in winuser.
Importare librerie:Utilizzare user32.lib.

Vedi anche

Panoramica di Windows, le funzioni finestra, EnumChildWindows

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index