ShowWindow

ShowWindow функция устанавливает состояние указанного окна шоу.

 (BOOL ShowWindow HWND  hWnd, / / дескриптор окнаintnCmdShow / / показать состояние окна);
 

Параметры

hWnd
Дескриптор окна.
nCmdShow
Определяет, как будет показано окно. Если этот параметр игнорируется впервые приложение вызывает ShowWindow, программа, запустили приложение обеспечивает структуры STARTUPINFO . В противном случае в первый раз вызывается ShowWindow , значение должно быть значение, полученное функцией WinMain в его параметра nCmdShow . В последующих вызовах этот параметр может принимать одно из следующих значений
Значение Значение
SW_FORCEMINIMIZE Windows NT 5.0 и более поздних: Сворачивает окно, даже если висела поток, владеющий окна. Этот флаг следует использовать только при минимизации окон из другого потока.
SW_HIDE Скрывает окно и активирует другое окно.
SW_MAXIMIZE Развертывает указанное окно.
SW_MINIMIZE Минимизирует указанное окно и активирует следующее окно верхнего уровня в Z-порядке.
SW_RESTORE Активируется и выводится окно. Если свернутого или развернутого окна, системы восстанавливает исходный размер и положение. Приложение должно указывать этот флаг при восстановлении свернутого окна.
SW_SHOW Активирует окно и отображает его в свой текущий размер и положение.
SW_SHOWDEFAULT Задает состояние отображения на основе флага SW_, указанный в структуры STARTUPINFO передан функции CreateProcess программой, запустившего приложение.
SW_SHOWMAXIMIZED Активирует окно и отображает его в развернутом окне.
SW_SHOWMINIMIZED Активирует окно и отображает его в виде свернутого окна.
SW_SHOWMINNOACTIVE Отображает окно в свернутом окне. Активное окно остается активным.
SW_SHOWNA Отображение окна в ее текущем состоянии. Активное окно остается активным.
SW_SHOWNOACTIVATE Отображает окно в свои последние размер и положение. Активное окно остается активным.
SW_SHOWNORMAL Активируется и выводится окно. Если свернутого или развернутого окна, системы восстанавливает исходный размер и положение. Приложение должно указывать этот флаг при отображении окна в первый раз.

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

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

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

Примечания

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

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

Windows CE: Параметр nCmdShow не поддерживает следующие значения

SW_MAXIMIZE

SW_MINIMIZE

SW_RESTORE

SW_SHOWDEFAULT

SW_SHOWMAXIMIZED

SW_SHOWMINIMIZED

SW_SHOWMINNOACTIVE

QuickInfo

nbsp; Windows &NT: требует версии 3.1 или более поздней версии.
Windows:Требует Windows 95 или более поздней версии.
Windows CE:Требует версии 1.0 или более поздней версии.
Заголовок:Объявленные в winuser.h.
Импорта библиотеки:Использование user32.lib.

Родственные слова

Обзор Windows, функции окна, CreateProcess, CreateWindow, ShowOwnedPopups, STARTUPINFO, WinMain

Index