Функция ShowWindow

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

Синтаксис

BOOL ShowWindow(

HWND hWnd,    // дескриптор окна
int
nCmdShow  // состояние показа окна

);

Параметры

hWnd

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

nCmdShow

[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, чтобы использовать информацию автозапуска, предоставленную программой, которая запустила приложение. Это поведение разработано для следующих ситуаций:

Пример

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

Смотри также

Краткий обзор Окна, AnimateWindow, CreateProcess, CreateWindow, ShowOwnedPopups, STARTUPINFO, WinMain

Размещение и совместимость ShowWindow

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

User32.lib

Заголовочный файл

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки
Перевод 28.11.2000 11:58 ©Copyright V. Sokovikov
Hosted by uCoz