다음을 통해 공유


SetActiveWindow 함수(winuser.h)

창을 활성화합니다. 창은 호출 스레드의 메시지 큐에 연결되어야 합니다.

구문

HWND SetActiveWindow(
  [in] HWND hWnd
);

매개 변수

[in] hWnd

형식: HWND

활성화할 최상위 창에 대한 핸들입니다.

반환 값

형식: HWND

함수가 성공하면 반환 값은 이전에 활성 상태였던 창에 대한 핸들입니다.

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

설명

SetActiveWindow 함수는 창을 활성화하지만 애플리케이션이 백그라운드에 있는 경우에는 활성화되지 않습니다. 시스템이 창을 활성화할 때 애플리케이션이 포그라운드에 있는 경우 창이 전경( Z 순서의 맨 위)으로 이동합니다.

hWnd 매개 변수로 식별된 창이 호출 스레드에 의해 만들어진 경우 호출 스레드의 활성 창 상태 hWnd로 설정됩니다. 그렇지 않으면 호출 스레드의 활성 창 상태 NULL로 설정됩니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 winuser.h(Windows.h 포함)
라이브러리 User32.lib
DLL User32.dll
API 세트 ext-ms-win-ntuser-window-l1-1-4(Windows 10 버전 10.0.14393에 도입됨)

추가 정보

개념

GetActiveWindow

키보드 입력

참조

SetForegroundWindow

WM_ACTIVATE