GetWindow

Funksjonen GetWindow henter en referanse til et vindu som har det angitte forholdet (Z-rekkefølge eller eier) til det angitte vinduet.

() HWND GetWindow HWND  hWnd, / / håndtere til opprinnelige vinduetUINTuCmd / / flag relasjon);
 

Parametere

hWnd
Håndtere til et vindu. Vindusreferansen hentet er relativ til dette vinduet, basert på verdien for parameteren uCmd.
uCmd
Angir forholdet mellom det angitte vinduet og vinduet der referansen er som skal hentes. Denne parameteren kan være en av følgende verdier:
Verdi Betydning
GW_CHILD Hentede håndtaket identifiserer det underordnede vinduet på toppen av Z-rekkefølgen, hvis det angitte vinduet er et overordnet vindu; Ellers er hentede håndtaket NULL. Funksjonen undersøker bare underordnede vinduer av det angitte vinduet. Det ikke undersøke etterkommer windows.
GW_ENABLEDPOPUP Windows NT 5.0 og senere: Hentede håndtaket identifiserer aktiverte popup-vinduet som eies av det angitte vinduet (Søk bruker først slike vinduet funnet ved hjelp av GW_HWNDNEXT); Ellers, hvis det finnes ingen aktiverte popup-vinduer, hentede håndtak er at av det angitte vinduet.
GW_HWNDFIRST Hentede håndtaket identifiserer vinduet av samme type som er høyest i Z-rekkefølge. Hvis det angitte vinduet er en vindu, identifiserer håndtaket det øverste vinduet som er høyest i Z-rekkefølge. Hvis det angitte vinduet er et vindu på øverste nivå, identifiserer håndtaket vinduet på øverste nivå som er høyest i Z-rekkefølge. Hvis det angitte vinduet er et underordnet vindu, identifiserer håndtaket vinduet søsken som er høyest i Z-rekkefølge.
GW_HWNDLAST Hentede håndtaket identifiserer vinduet av samme type som er lavest i Z-rekkefølge. Hvis det angitte vinduet er en vindu, identifiserer håndtaket det øverste vinduet som er lavest i Z-rekkefølge. Hvis det angitte vinduet er et vindu på øverste nivå, identifiserer håndtaket vinduet på øverste nivå som er lavest i Z-rekkefølge. Hvis det angitte vinduet er et underordnet vindu, identifiserer håndtaket vinduet søsken som er lavest i Z-rekkefølge.
GW_HWNDNEXT Hentede håndtaket identifiserer vinduet under det angitte vinduet i Z-rekkefølge. Hvis det angitte vinduet er en vindu, identifiserer det øverste vinduet under det angitte vinduet i håndtaket. Hvis det angitte vinduet er et vindu på øverste nivå, identifiserer håndtaket vinduet på øverste nivå under det angitte vinduet. Hvis det angitte vinduet er et underordnet vindu, identifiserer håndtaket vinduet søsken under det angitte vinduet.
GW_HWNDPREV Hentede håndtaket identifiserer vinduet ovenfor det angitte vinduet i Z-rekkefølge. Hvis det angitte vinduet er en vindu, identifiserer det øverste vinduet ovenfor det angitte vinduet i håndtaket. Hvis det angitte vinduet er et vindu på øverste nivå, identifiserer håndtaket vinduet på øverste nivå over angitte vinduet. Hvis det angitte vinduet er et underordnet vindu, identifiserer håndtaket vinduet søsken over angitte vinduet.
GW_OWNER Hentede håndtaket identifiserer det angitte vinduet eier-vinduet, hvis noen.

Returverdier

Hvis funksjonen er vellykket, er verdien som returneres en vindusreferanse. Hvis det finnes ingen vinduet med angitte forholdet til det angitte vinduet, er verdien som returneres NULL. Til å vise utvidet feilinformasjon, kan du ringe GetLastError.

Merknader

Funksjonen EnumChildWindows , er mer pålitelig enn kalle GetWindow i en løkke. Et program som er at kall GetWindow for å utføre denne oppgaven risikerer å bli fanget i en uendelig løkke eller refererer til en referanse til et vindu som er ødelagt.

Windows CE: I Windows CE versjon 1.0 støttes GW_OWNER flagg verdien for parameteren uCmd bare for dialogbokser.

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 3.1 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Krever versjon 1.0 eller senere.
Topptekst:Deklarert i winuser.h.
Importere biblioteket:Bruk user32.lib.

Se også

Oversikt over Windows, vinduet funksjoner, EnumChildWindows

Index