Поделиться через


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

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

Синтаксис

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

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

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

Комментарии

Для выполнения определенных специальных эффектов при отображении или скрытии окна используйте AnimateWindow.

При первом вызове 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)

См. также раздел

AnimateWindow

Основные понятия

CreateProcess

CreateWindow

Другие ресурсы

Справочные материалы

STARTUPINFO

ShowOwnedPopups

ShowWindowAsync

WinMain

Windows