Функция SetWindowPos

Функция SetWindowPos изменяет размер, позицию и Z-последовательность дочернего, выскакивающего или верхнего уровня окна. Дочерние, выскакивающие и верхнего уровня окна размещаются по порядку согласно их появлению на экране. Самое верхнее окно принимает самый высокий ранг и становится первым окном в Z-последовательности.

Значение	Предназначение
HWND_BOTTOM	Помещает окно внизу Z-последовательности. Если параметр *hWnd* идентифицирует самое верхнее окно, окно теряет свой статус самого верхнего и помещается внизу всех других окон.
HWND_NOTOPMOST	Помещает окно перед всеми не самыми верхними окнами (то есть позади всех самых верхних окон). Этот флажок не имеет никакого влияния, если окно - уже не самое верхнее окно.
HWND_TOP	Помещает окно наверху Z-последовательности.
HWND_TOPMOST	Помещает окно перед не самыми верхними окнами. Окно сохраняет свою самую верхнюю позицию даже тогда, когда оно теряет активность.

Значение	Предназначение
SWP_ASYNCWINDOWPOS	Если вызывающий поток и поток, который владеет окном, подключены к разным очередям ввода данных, система посылает запрос потоку, который владеет окном. Это не допускает блокирования работы вызывающего потока, в то время пока другие потоки обрабатывают запрос.
SWP_DEFERERASE	Препятствует созданию сообщения WM_SYNCPAINT.
SWP_DRAWFRAME	Выводит рамку (определенную в описании класса окна) вокруг окна.
SWP_FRAMECHANGED	Применяет новую установку стилей рамок, используя функцию SetWindowLong. Отправляет сообщение WM_NCCALCSIZE окну, даже тогда, когда размер окна не изменяется. Если этот флажок не установлен, WM_NCCALCSIZE отправляется только тогда, когда размер окна изменяется.
SWP_HIDEWINDOW	Скрывает окно.
SWP_NOACTIVATE	Не активизирует окно. Если этот флажок не установлен, окно активизируется и перемещается в верхнюю часть или самой верхней, или не самой верхней группы (в зависимости от установки параметра *hWndInsertAfter*.)
SWP_NOCOPYBITS	Сбрасывает все содержание рабочей области. Если этот флажок не установлен, допустимое содержание рабочей области сохраняется и копируется обратно в рабочую область после того, как окно изменило размер или переустановлено.
SWP_NOMOVE	Сохраняет текущую позицию (игнорирует X и Y параметры).
SWP_NOOWNERZORDER	Не изменяет позицию окна владельца в Z-последовательности.
SWP_NOREDRAW	Не перерисовывает изменения. Если этот флажок установлен, то не происходит никакой перерисовки любого вида. Это применяется к рабочей области, нерабочей области (включая строку заголовка и линейки прокрутки) и любую часть родительского окна, раскрытого в результате перемещения окна. Когда этот флажок установлен, прикладная программа должна явно признать недействительной или перерисовать любые части окна и родительского окна, которые требуют перерисовки.
SWP_NOREPOSITION	То же самое, что и флажок SWP_NOOWNERZORDER.
SWP_NOSENDCHANGING	Предохраняет окно от приема сообщения WM_WINDOWPOSCHANGING.
SWP_NOSIZE	Сохраняет текущий размер (игнорирует cx и cy параметры).
SWP_NOZORDER	Сохраняет текущую Z-последовательность (игнорирует параметр *hWndInsertAfter*).
SWP_SHOWWINDOW	Отображает окно на экране.

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

Если флажки SWP_SHOWWINDOW или SWP_HIDEWINDOW установлены, окно не может быть перемещено или изменен его размер.

Если Вы изменили некоторые данные окна, используя функцию SetWindowLong, Вы должны вызвать функцию SetWindowPos, чтобы получить ожидаемый результат отменены. Используйте нижеследующую комбинацию флажков для uFlags: SWP_NOMOVE | SWP_NOSIZE | SWP_NOZORDER | SWP_FRAMECHANGED.

Окно может быть сделано самым верхним окном или, путем установки параметра hWndInsertAfter в HWND_TOPMOST с гарантией того, что флажок SWP_NOZORDER не установлен, или, путем установки позиции окна в Z-последовательности так, чтобы оно было выше любого существующего самого верхнего окна. Когда не самое верхнее окно делается самым верхним, находящиеся в его собственности окна также делаются самыми верхними. Его владельцы, однако, не изменяются.

Если, ни флажок SWP_NOACTIVATE, ни флажок SWP_NOZORDER не установлен (то есть, когда прикладная программа потребовала, чтобы окно было одновременно, и активизировано, и чтобы его позиция изменилась в Z-последовательности), значение, заданное в hWndInsertAfter, используются только в следующих обстоятельствах:

Если самое верхнее окно переустановлено в нижней части (HWND_BOTTOM) Z-последовательности или после любого не самого верхнего окна, оно больше не самое верхнее. Когда самое верхнее окно сделано не самым верхним, его владельцы и находящиеся в его собственности окна также делаются не самыми верхними окнами.

Если прикладная программа не в приоритетном режиме, а должна быть в нем, она должна вызвать функцию SetForegroundWindow.

Размещение и совместимость SetWindowPos
Windows. NET Server	Да
Windows XP	Да
Windows 2000	Да
Windows NT	Да
Windows Me	Да
Windows 98	Да
Windows 95	Да
Используемая библиотека	User32.lib
Заголовочный файл
- объявлено в	Winuser.h
- включено в	Windows.h
Unicode	Нет
Замечания по платформе	Не имеется