GetWindow

Funkcja GetWindow pobiera dojście do okna, które ma określoną relację (współrzędną lub właściciela) do określonego okna.

(HWND GetWindow HWND  hWnd, / / dojście do okna oryginalnegoUINTuCmd / / relacji Flaga);
 

Parametry

hWnd
Dojście do okna. Dojście do okna pobierane jest względem tego okna, na podstawie wartości parametru uCmd.
uCmd
Określa relację między określonego okna i okna, którego uchwyt ma być pobrana. Ten parametr może mieć jedną z następujących wartości:
Wartość Znaczenie
GW_CHILD Pobrane uchwyt identyfikuje okno podrzędne na górze kolejności z określonego okna jest okno nadrzędne; w przeciwnym razie pobrane dojście jest NULL. Funkcja analizuje tylko okien podrzędnych określonego okna. Nie zbadała podrzędnych systemu windows.
GW_ENABLEDPOPUP Systemu Windows NT 5.0 i nowsze: Pobrane uchwyt identyfikuje okno podręczne włączone własnością określonego okna (wyszukiwanie wykorzystuje pierwsze takie okno uznane za pomocą GW_HWNDNEXT); w przeciwnym razie w przypadku nie włączony wyskakujących okienek, pobrane uchwyt jest określonego okna.
GW_HWNDFIRST Pobrane uchwyt identyfikuje okna tego samego typu, który jest najwyższy w kolejności Z. Jeśli okno jest określone okno, uchwyt identyfikuje wierzchu okno, w którym jest najwyższy w kolejności Z. Jeśli określonego okna jest okno najwyższego poziomu, uchwyt identyfikuje okna najwyższego poziomu, który jest najwyższy w kolejności Z. Jeśli określonego okna jest okno potomne, uchwyt identyfikuje okna równorzędny, który jest najwyższy w kolejności z.
GW_HWNDLAST Pobrane uchwyt identyfikuje okna tego samego typu, który jest najniższe w kolejności Z. Jeśli okno jest określone okno, uchwyt identyfikuje wierzchu okno, w którym jest najniższe w kolejności Z. Jeśli określonego okna jest okno najwyższego poziomu, uchwyt identyfikuje okna najwyższego poziomu, który jest najniższe w kolejności Z. Jeśli określonego okna jest okno potomne, uchwyt identyfikuje okna równorzędny, który jest najniższe w kolejności z.
GW_HWNDNEXT Pobrane uchwyt identyfikuje okno poniżej okna określoną w kolejności Z. Jeśli okno jest określone okno, uchwyt identyfikuje okno poniżej określonego okna. Jeśli określonego okna jest okno najwyższego poziomu, uchwyt identyfikuje okna najwyższego poziomu poniżej określonego okna. Jeśli określonego okna jest okno potomne, uchwyt identyfikuje okna równorzędny poniżej określonego okna.
GW_HWNDPREV Pobrane uchwyt identyfikuje okna powyżej określonego okna w kolejności Z. Jeśli okno jest określone okno, uchwyt identyfikuje okno powyżej określonego okna. Jeśli określonego okna jest okno najwyższego poziomu, uchwyt identyfikuje okna najwyższego poziomu powyżej określonego okna. Jeśli określonego okna jest okno potomne, uchwyt identyfikuje okna równorzędny powyżej określonego okna.
GW_OWNER Pobrane uchwyt identyfikuje okno właściciela określonego okna, jeżeli.

Zwraca wartości

Jeśli funkcja, wartość zwracany jest dojście do okna. Jeśli żadne okno nie istnieje z określoną relację do określonego okna, wartość zwracana jest wartość NULL. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Uwagi

Funkcja EnumChildWindows jest bardziej wiarygodne niż wywołanie GetWindow w pętli. Wniosek, że wywołania GetWindow do wykonania tego zadania ryzyka są złowionych w nieskończoną pętlę či odkazy na dojście do okna, który został zniszczony.

Systemu Windows CE: W systemie Windows CE w wersji 1.0 wartość flagi GW_OWNER dla parametru uCmd obsługiwany jest tylko dla okien dialogowych.

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Wymaga wersja 1.0 lub nowsza.
Nagłówka:Zadeklarowane w pliku winuser.h.
Importowanie biblioteki:Użycie user32.lib.

Zobacz też

Omówienie Windows, okno funkcji, EnumChildWindows

Index