ShowWindow 함수(winuser.h)

아티클
06/08/2023

지정된 창의 표시 상태를 설정합니다.

구문

BOOL ShowWindow(
  [in] HWND hWnd,
  [in] int  nCmdShow
);

매개 변수

[in] hWnd

형식: HWND

창에 대한 핸들입니다.

[in] nCmdShow

형식: int

창을 표시하는 방법을 제어합니다. 애플리케이션을 시작한 프로그램이 STARTUPINFO 구조를 제공하는 경우 이 매개 변수는 애플리케이션이 ShowWindow를 처음 호출할 때 무시됩니다. 그렇지 않으면 ShowWindow가 처음 호출될 때 값은 해당 nCmdShow 매개 변수에서 WinMain 함수에서 가져온 값이어야 합니다. 후속 호출에서 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
SW_HIDE 0	창을 숨기고 다른 창을 활성화합니다.
SW_SHOWNORMAL SW_NORMAL 1	창을 활성화하고 표시합니다. 창을 최소화, 최대화 또는 정렬하면 시스템은 창을 원래 크기와 위치로 복원합니다. 애플리케이션은 창을 처음으로 표시할 때 이 플래그를 지정해야 합니다.
SW_SHOWMINIMIZED 2	창을 활성화하고 최소화된 창으로 표시합니다.
SW_SHOWMAXIMIZED SW_MAXIMIZE 3	창을 활성화하고 최대화된 창으로 표시합니다.
SW_SHOWNOACTIVATE 4	창의 최근 크기와 위치를 표시합니다. 이 값은 창이 활성화되지 않았다는 점을 제외하고 SW_SHOWNORMAL 비슷합니다.
SW_SHOW 5	창을 활성화하고 현재 크기와 위치에 표시합니다.
SW_MINIMIZE 6	지정된 창을 최소화하고 Z 순서로 다음 최상위 창을 활성화합니다.
SW_SHOWMINNOACTIVE 7	창을 최소화된 창으로 표시합니다. 이 값은 창이 활성화되지 않은 경우를 제외하고 SW_SHOWMINIMIZED 비슷합니다.
SW_SHOWNA 8	창을 현재 크기와 위치로 표시합니다. 이 값은 창이 활성화되지 않았다는 점을 제외하고 SW_SHOW 비슷합니다.
SW_RESTORE 9	창을 활성화하고 표시합니다. 창을 최소화, 최대화 또는 정렬하면 시스템은 창을 원래 크기와 위치로 복원합니다. 애플리케이션은 최소화된 창을 복원할 때 이 플래그를 지정해야 합니다.
SW_SHOWDEFAULT 10	애플리케이션을 시작한 프로그램에서 CreateProcess 함수에 전달된 STARTUPINFO 구조체에 지정된 SW_ 값을 기반으로 표시 상태를 설정합니다.
SW_FORCEMINIMIZE 11	창을 소유하는 스레드가 응답하지 않더라도 창을 최소화합니다. 이 플래그는 다른 스레드에서 창을 최소화할 때만 사용해야 합니다.

반환 값

형식: BOOL

창이 이전에 표시된 경우 반환 값은 0이 아닌 값입니다.

창이 이전에 숨겨져 있으면 반환 값은 0입니다.

설명

창을 표시하거나 숨길 때 특정 특수 효과를 수행하려면 AnimateWindow를 사용합니다.

애플리케이션이 ShowWindow를 처음 호출할 때 WinMain 함수의 nCmdShow 매개 변수를 nCmdShow 매개 변수로 사용해야 합니다. ShowWindow에 대한 후속 호출은 WinMain 함수의 nCmdShow 매개 변수로 지정된 값 대신 지정된 목록의 값 중 하나를 사용해야 합니다.

nCmdShow 매개 변수에 대한 설명에서 설명한 대로 애플리케이션을 시작한 프로그램이 구조체의 시작 정보를 지정하는 경우 ShowWindow에 대한 첫 번째 호출에서 nCmdShow 값이 무시됩니다. 이 경우 ShowWindow 는 STARTUPINFO 구조에 지정된 정보를 사용하여 창을 표시합니다. 후속 호출 시 애플리케이션은 애플리케이션을 시작한 프로그램에서 제공하는 시작 정보를 사용하려면 nCmdShow가 SW_SHOWDEFAULT 설정된 ShowWindow를 호출해야 합니다. 이 동작은 다음과 같은 상황에 맞게 설계되었습니다.

애플리케이션은 WS_VISIBLE 플래그가 설정된 CreateWindow를 호출하여 기본 창을 만듭니다.
애플리케이션은 WS_VISIBLE 플래그가 지워진 상태에서 CreateWindow를 호출하여 기본 창을 만들고, 나중에 표시되도록 SW_SHOW 플래그가 설정된 ShowWindow를 호출합니다.

예제

예제는 주 창 만들기를 참조하세요.

요구 사항


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