« FindWindowEx, funkcja »
Pobiera uchwyt okna, którego nazwa odpowiada określonym łańcuchom znaków. (funkcja)
Logowanie
Panel użytkownika
Nazwa użytkownika:
Hasło:
Nie masz jeszcze konta?
Zapomniałem hasła
Polska dokumentacja C++ » Biblioteki C/C++ » WinAPI » Okno » Praca z oknem
Hasło nie zostało zweryfikowane
Niniejsze hasło zostało opracowane, jednak nie zostało ono zweryfikowane przez administrację serwisu. Jeżeli znalazłeś błędy merytoryczne w niniejszym dokumencie, prosimy o ich zgłoszenie na forum w dziale Znalezione błędy.
Opracował: jankowalski25
Biblioteki C/C++

FindWindowEx

[funkcja] Pobiera uchwyt okna, którego nazwa odpowiada określonym łańcuchom znaków.

Składnia

C/C++
#include <windows.h>

HWND WINAPI FindWindowEx( HWND hwndParent, HWND hwndChildAfter, LPCTSTR lpszClass, LPCTSTR lpszWindow );

Argumenty

Wszystkie poniższe argumenty są opcjonalne.
ArgumentOpis
hwndParentUchwyt do okna narzędnego, którego okna podrzędne będą przeszukiwane. Jeśli wartość tego argumentu wynosi NULL, funkcja używa okna pulpitu jako okna nadrzędnego i szuka okien, których okna podrzędne znajdują się na pulpicie. Jeśli wartość tego argumentu wynosi HWND_MESSAGE, funkcja szuka tylko okien komunikatów.
hwndChildAfterUchwyt do okna podrzędnego. Wyszukiwanie rozpoczyna się od następnego okna podrzędnego w tak zwanej "osi Z" (Z-order). Okno podrzędne musi być oknem podrzędnym okna określonego przez argument hwndParent. Jeśli wartość tego argumentu wynosi NULL, szukanie rozpoczyna się od pierwszego okna podrzędnego argumentu hwndParent.
lpszClassNazwa klasy utworzonej przez wywołanie funkcji » WinAPI ♦ RegisterClass lub » WinAPI ♦ RegisterClassEx. Wartość musi być umieszczona w dolnym słowie tego argumentu, a górne słowo musi być równe zero. Jeśli wartość tego argumentu jest łańcuchem znaków, to określa nazwę klasy. Nazwa klasy musi być zarejestrowana przez funkcję » WinAPI ♦ RegisterClass lub » WinAPI ♦ RegisterClassEx. Może również być predefiniowaną nazwą kontrolną lub mieć wartość
MAKEINTATOM( 0x8000 )
. W tym ostatnim przypadku 0x8000 jest identyfikatorem klasy menu. Więcej informacji można znaleźć w "Dodatkowych informacjach".
lpszWindowNazwa okna (jego tytuł), jeśli ma wartość NULL, nazwa szukanego okna jest dowolna.

Zwracana wartość

Jeśli funkcja zakończy się normalnie, zwracana wartość jest uchwytem do szukanego okna, inaczej NULL. Aby uzyskać dodatkowe informacje o błędach, wywołaj funkcję » WinAPI ♦ GetLastError.

Dodatkowe informacje

Ta funkcja nie rozróżnia małych i wielkich liter.
Jeśli argumenty hwndParent i hwndChildAfter mają wartość NULL, funkcja szuka tylko nadrzędnych okien komunikatów. Jeśli wartość argumentu lpszWindow nie wynosi NULL, funkcja FindWindowEx wywołuje funkcję » WinAPI ♦ GetWindowText, aby pobrać nazwę okna do porównania.
Programista może wywołać tą funkcję na kilka sposobów, na przykład:
FindWindowEx( NULL, NULL, MAKEINTATOM( 0x8000 ), NULL );

Wartość 0x8000 jest identyfikatorem klasy menu. Kiedy programista wywołuje tą funkcję, funkcja sprawdza, czy kontekst menu będzie wyświetlany.

Wymagania

Minimalny system klientaWindows 2000 Professional (tylko aplikacje biurowe).
Minimalny system serweraWindows 2000 Server (tylko aplikacje biurowe).
NagłówekWinuser.h (dołącza Windows.h)
BibliotekaUser32.lib
DLLUser32.dll
UNICODEFindWindowExW
ANSIFindWindowExA

Zagadnienia powiązane

FindWindowPobiera uchwyt do okna o określonej nazwie i klasie. (funkcja)

Linki zewnętrzne

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.
Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.
© Wszelkie prawa zastrzeżone 2005-2024