Функция SetWindowPlacement (winuser.h)
Задает состояние отображения и восстановленные, свернутые и развернутые позиции указанного окна.
Синтаксис
BOOL SetWindowPlacement(
[in] HWND hWnd,
[in] const WINDOWPLACEMENT *lpwndpl
);
Параметры
[in] hWnd
Тип: HWND
Дескриптор окна.
[in] lpwndpl
Тип: const WINDOWPLACEMENT*
Указатель на структуру WINDOWPLACEMENT , которая задает новое состояние отображения и позиции окна.
Перед вызовом SetWindowPlacement задайте для элемента длины структуры WINDOWPLACEMENT значение sizeof(WINDOWPLACEMENT). SetWindowPlacement завершается ошибкой , если член длины задан неправильно.
Возвращаемое значение
Тип: BOOL
Если функция выполняется успешно, возвращается ненулевое значение.
Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
Если информация, указанная в windowplacement , приведет к тому, что окно полностью отключается от экрана, система автоматически корректирует координаты таким образом, чтобы окно было видимым, учитывая изменения в разрешении экрана и конфигурации нескольких мониторов.
Элемент длиныWINDOWPLACEMENT должен иметь значение sizeof(WINDOWPLACEMENT). Если этот элемент задан неправильно, функция возвращает значение FALSE. Дополнительные замечания о правильном использовании координат размещения окна см. в разделе WINDOWPLACEMENT.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | winuser.h (включая Windows.h) |
| Библиотека | User32.lib |
| DLL | User32.dll |
| Набор API | ext-ms-win-ntuser-window-l1-1-3 (появилось в Windows 10 версии 10.0.10240) |
См. также раздел
Основные понятия
Справочные материалы