Функция ShowWindow

Функция ShowWindow устанавливает состояние показа определяемого окна.

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

Значение	Предназначение
SW_FORCEMINIMIZE	Windows 2000/XP: Свертывает окно, даже если поток, который владеет окном, зависает. Этот флажок должен быть использоваться только при свертывании окон другого потока.
SW_HIDE	Скрывает окно и активизирует другое окно.
SW_MAXIMIZE	Развертывает заданное окно.
SW_MINIMIZE	Свертывает заданное окно и активизирует следующее окно верхнего уровня в Z-последовательности.
SW_RESTORE	Активизирует и показывает на экране окно. Если окно свернуто или развернуто, система восстанавливает в его первоначальных размерах и позиции. Прикладная программа должна установить этот флажок при восстановлении свернутого окна.
SW_SHOW	Активизирует окно и показывает на экране в его текущих размерах и позиции.
SW_SHOWDEFAULT	Устанавливает состояние показа, основанное на флажке SW_, определенном в структуре STARTUPINFO, переданной в функцию CreateProcess программой, которая запустила прикладную программу.
SW_SHOWMAXIMIZED	Активизирует окно и отображает его как развернутое окно.
SW_SHOWMINIMIZED	Активизирует окно и отображает его как свернутое окно.
SW_SHOWMINNOACTIVE	Показывает на экране окно как свернутое окно. Это значение походит на флажок SW_SHOWMINIMIZED, исключая окна, которые не активны.
SW_SHOWNA	Показывает на экране окно в его текущем размере и позиции. Это значение походит на флажок SW_SHOW, исключая окна, которые не активны.
SW_SHOWNOACTIVATE	Показывает окно в его самом современном размере и позиции. Это значение походит на флажок SW_SHOWNORMAL, исключая окна, которые не активны.
SW_SHOWNORMAL	Активизирует и показывает окно. Если окно свернуто или развернуто, система восстанавливает его в первоначальном размере и позиции. Прикладная программа должна установить этот флажок при отображении окна впервые.

Чтобы выполнять некоторые специальные эффекты при показе или сокрытии окна, используйте функцию AnimateWindow.

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

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

Размещение и совместимость ShowWindow
Windows. NET Server	Да
Windows XP	Да
Windows 2000	Да
Windows NT	Да
Windows Me	Да
Windows 98	Да
Windows 95	Да
Используемая библиотека	User32.lib
Заголовочный файл
- объявлено в	Winuser.h
- включено в	Windows.h
Unicode	Нет
Замечания по платформе	Не имеется