FindWindowExW 함수(winuser.h)

클래스 이름 및 창 이름이 지정된 문자열과 일치하는 창에 대한 핸들을 검색합니다. 이 함수는 지정된 자식 창 다음에 있는 자식 창부터 시작하여 자식 창을 검색합니다. 이 함수는 대/소문자를 구분하는 검색을 수행하지 않습니다.

통사론

HWND FindWindowExW(
  [in, optional] HWND    hWndParent,
  [in, optional] HWND    hWndChildAfter,
  [in, optional] LPCWSTR lpszClass,
  [in, optional] LPCWSTR lpszWindow
);

매개 변수

[in, optional] hWndParent

형식: HWND

자식 창을 검색할 부모 창에 대한 핸들입니다.

hwndParent NULL경우 함수는 데스크톱 창을 부모 창으로 사용합니다. 이 함수는 바탕 화면의 자식 창인 창에서 검색합니다.

hwndParentHWND_MESSAGE경우 함수는 모든 메시지 전용 창검색합니다.

[in, optional] hWndChildAfter

형식: HWND

자식 창에 대한 핸들입니다. 검색은 Z 순서의 다음 자식 창으로 시작합니다. 자식 창은 하위 창이 아니라 hwndParent직접 자식 창이어야 합니다.

hwndChildAfter NULL경우 검색은 hwndParent첫 번째 자식 창으로 시작합니다.

hwndParent 및 hwndChildAfter 모두 NULL경우 함수는 모든 최상위 및 메시지 전용 창을 검색합니다.

[in, optional] lpszClass

형식: LPCWSTR

RegisterClass 또는 RegisterClassEx 함수에 대한 이전 호출에서 만든 클래스 이름 또는 클래스 원자입니다. 원자는 lpszClass;의 하위 단어에 배치되어야 합니다. 상위 단어는 0이어야 합니다.

lpszClass 문자열인 경우 창 클래스 이름을 지정합니다. 클래스 이름은 RegisterClass 또는 RegisterClassEx등록한 이름 또는 미리 정의된 컨트롤 클래스 이름이거나 MAKEINTATOM(0x8000)수 있습니다. 이 후자의 경우 0x8000 메뉴 클래스의 원자입니다. 자세한 내용은 이 항목의 설명 섹션을 참조하세요.

[in, optional] lpszWindow

형식: LPCWSTR

창 이름(창의 제목)입니다. 이 매개 변수가 NULL경우 모든 창 이름이 일치합니다.

반환 값

형식: HWND

함수가 성공하면 반환 값은 지정된 클래스와 창 이름을 가진 창에 대한 핸들입니다.

함수가 실패하면 반환 값은 NULL. 확장 오류 정보를 얻으려면 GetLastError호출합니다.

발언

FindWindowEx 함수는 직접 자식 창만 검색합니다. 다른 하위 항목을 검색하지 않습니다.

lpszWindow 매개 변수가 NULL않으면 FindWindowEx GetWindowText 함수를 호출하여 비교를 위해 창 이름을 검색합니다. 발생할 수 있는 잠재적인 문제에 대한 설명은 GetWindowText설명 섹션을 참조하세요.

애플리케이션은 다음과 같은 방법으로 이 함수를 호출할 수 있습니다.

FindWindowEx( NULL, NULL, MAKEINTATOM(0x8000), NULL );

0x8000 메뉴 클래스의 원자입니다. 애플리케이션이 이 함수를 호출할 때 함수는 애플리케이션이 만든 상황에 맞는 메뉴가 표시되는지 여부를 확인합니다.

요구 사항

참고 항목

개념

EnumWindows

FindWindow

GetClassName

GetWindowText

참조

RegisterClass

RegisterClassEx

windows