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