Функция ShowWindow (winuser.h)

Статья
06/08/2023

Задает состояние отображения указанного окна.

Синтаксис

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

Параметры

[in] hWnd

Тип: HWND

Дескриптор окна.

[in] nCmdShow

Тип: int

Управляет тем, как должно отображаться окно. Этот параметр игнорируется при первом вызове приложения ShowWindow, если программа, которая запустила приложение, предоставляет структуру STARTUPINFO . В противном случае при первом вызове ShowWindow значение должно быть значением, полученным функцией WinMain в ее параметре nCmdShow . В последующих вызовах этот параметр может иметь одно из следующих значений.

Значение	Значение
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	Задает состояние отображения на основе значения SW_ , указанного в структуре STARTUPINFO , переданной в функцию CreateProcess программой, которая запустила приложение.
SW_FORCEMINIMIZE 11	Свертывание окна, даже если поток, которому принадлежит окно, не отвечает. Этот флаг следует использовать только при минимизации окон из другого потока.

Возвращаемое значение

Тип: BOOL

Если окно было ранее видимым, возвращаемое значение будет ненулевым.

Если окно ранее было скрыто, возвращаемое значение равно нулю.

При первом вызове ShowWindow приложение должно использовать параметр nCmdShow функции WinMain в качестве параметра nCmdShow. Последующие вызовы ShowWindow должны использовать одно из значений в заданном списке вместо значения, указанного параметром nCmdShow функции WinMain.

Как отмечалось в обсуждении параметра nCmdShow , значение nCmdShow игнорируется при первом вызове ShowWindow , если программа, которая запустила приложение, указывает сведения о запуске в структуре. В этом случае ShowWindow использует сведения, указанные в структуре STARTUPINFO , для отображения окна. При последующих вызовах приложение должно вызывать ShowWindow с параметром nCmdShow , для SW_SHOWDEFAULT, чтобы использовать сведения о запуске, предоставленные программой, которая запустила приложение. Такое поведение предназначено для следующих ситуаций:

Приложения создают окно main путем вызова CreateWindow с установленным флагом WS_VISIBLE.
Приложения создают свое окно main, вызывая CreateWindow с снятым флагом WS_VISIBLE, а затем вызывая ShowWindow с установленным флагом SW_SHOW, чтобы сделать его видимым.

Примеры

Пример см. в разделе Создание главного окна.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-window-l1-1-0 (появилось в Windows 8)