Функция GetWindowPlacement

Функция GetWindowPlacement извлекает данные о состоянии показа на экране и позиции восстановления, свертывания и развертывания заданного окна.

Синтаксис

BOOL GetWindowPlacement(
HWND hWnd,               // дескриптор окна
WINDOWPLACEMENT *lpwndpl // адрес структуры для расположения данных
);

Параметры

hWnd

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

lpwndpl

[out] Указатель на структуру WINDOWPLACEMENT, которая принимает информацию о позиции и состоянии показа окна на экране. Перед вызовом GetWindowPlacement, установите член length структуры WINDOWPLACEMENT в sizeof (WINDOWPLACEMENT). Функция GetWindowPlacement завершится ошибкой, если lpwndpl-> length установлена не правильно.

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

Если функция завершается успешно, возвращаемое значение не нуль.

Если функция завершается ошибкой, возвращаемое значение нулевое. Чтобы получить расширенные данные об ошибках, вызовите GetLastError.

Замечания

Член flags структуры WINDOWPLACEMENT, извлеченной этой функцией - всегда нуль. Если окно, идентифицированное параметром hWnd, развернуто, член структуры showCmd равен SW_SHOWMAXIMIZED. Если окно свернуто, showCmd - SW_SHOWMINIMIZED. Иначе, он равен SW_SHOWNORMAL.

Член length структуры WINDOWPLACEMENT должен быть установлен в sizeof (WINDOWPLACEMENT). Если этот член установлен не правильно, функция возвратит значение ЛОЖЬ (FALSE). Дополнительные замечания по надлежащему использованию координат размещения окна, см. статью о структуре WINDOWPLACEMENT

Смотри также

Краткий обзор Окна, SetWindowPlacement, WINDOWPLACEMENT

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

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да

Windows Me

Да

Windows 98

Да

Windows 95

Да

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

User32.lib

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

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Нет

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

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz