ShowWindow

ShowWindow

지정된 윈도우의 표시 상태를 설정합니다.

BOOL ShowWindow(
    HWND hWnd,     // 윈도우 핸들
    int  nCmdShow  // 표시 상태
);

USER32.DLL

인수

hWnd

표시 상태를 변경하는 윈도우의 핸들을 지정합니다.

nCmdShow

윈도우의 표시 상태를 지정합니다.어플리케이션을 기동한 프로세스가, 기동시에 STARTUPINFO 구조체를 제공하고 있었을 경우에는, 어플리케이션이 최초로 호출했다 ShowWindow 함수에서는 이 파라미터는 무시됩니다.이하의 값의 어느쪽이든을 지정합니다.그 이외의 경우, 어플리케이션이 최초로 호출한다 ShowWindow 함수에는, WinMain 함수의 nCmdShow 파라미터의 값을 지정해야 합니다.그 이후의 호출에서는, 이하의 값의 어느쪽이든을 지정할 수 있습니다.

치	의미
0 (SW_HIDE)	윈도우를 비표시로 하고, 다른 윈도우를 액티브하게 합니다.
1 (SW_SHOWNORMAL)	윈도우를 액티브하게 해 표시합니다.윈도우가 최소화 또는 최대화되고 있는 경우는, 윈도우의 위치와 사이즈를 바탕으로 되돌립니다.어플리케이션은, 최초로 윈도우를 표시시킬 때 이 플래그를 지정해야 합니다.
2 (SW_SHOWMINIMIZED)	윈도우를 액티브하게 하고, 최소화된 윈도우로서 표시합니다.
3 (SW_SHOWMAXIMIZED, SW_MAXIMIZE)	윈도우를 액티브하게 하고, 최대화된 윈도우로서 표시합니다.
4 (SW_SHOWNOACTIVATE)	윈도우를 액티브하게는 하지 않고 표시합니다.
5 (SW_SHOW)	윈도우를 액티브하게 하고, 현재의 위치와 사이즈로 표시합니다.
6 (SW_MINIMIZE)	지정된 윈도우를 최소화하고, 다음의 Z 오더에 있는 톱 레벨 윈도우를 액티브하게 합니다.
7 (SW_SHOWMINNOACTIVE)	윈도우가 최소화된 윈도우로서 표시합니다.윈도우는 액티브화 되지 않습니다.
8 (SW_SHOWNA)	윈도우를 현재의 위치와 사이즈로 표시합니다.윈도우는 액티브화 되지 않습니다.
9 (SW_RESTORE)	윈도우를 액티브하게 해 표시합니다.윈도우가 최소화 또는 최대화되고 있는 경우는, 윈도우의 위치와 사이즈를 바탕으로 되돌립니다.어플리케이션은, 최소화된 윈도우의 위치와 사이즈를 바탕으로 되돌릴 때 이 플래그를 지정해야 합니다.
10 (SW_SHOWDEFAULT)	어플리케이션을 기동한 프로그램이 CreateProcess 함수에 파라미터로서 건네주었다 STARTUPINFO 구조체로 지정되어 있다 SW_ 값에 근거해 표시 상태가 설정됩니다.
11 (SW_FORCEMINIMIZE)	Windows 2000/XP： 윈도우를 소유하고 있는 스렛드가 행 하고 있는 상태여도, 윈도우를 최소화합니다.다른 스렛드로부터 윈도우를 최소화시키는 경우에게만, 이 플래그를 사용해야 합니다.

반환값

윈도우가 이전에 표시되고 있었을 경우에는 0 이외의 값이 돌아갑니다.

윈도우가 이전에 표시되어 있지 않았던 경우에는 0 하지만 돌아갑니다.

대응 정보

Windows 95 이후 / Windows NT 3.1 이후