Функция SetWindowPlacement

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

Синтаксис

BOOL SetWindowPlacement(

HWND hWnd,                     // дескриптор окна
CONST WINDOWPLACEMENT
*lpwndpl // адрес структуры с данными о позиции

);

Параметры

hWnd

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

lpwndpl

[in] Указатель на структуру WINDOWPLACEMENT, которая устанавливает новое состояние показа и позиции окна.

Перед вызовом SetWindowPlacement, установите член length структуры WINDOWPLACEMENT в значение sizeof (WINDOWPLACEMENT). SetWindowPlacement завершится ошибкой, если lpwndpl-> length установлен не правильно.

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

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

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

Замечания

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

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

Смотри также

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

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

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да

Windows Me

Да

Windows 98

Да

Windows 95

Да

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

User32.lib

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

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Нет

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

Не имеется

 

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