CWnd::SetWindowPos

BOOL SetWindowPos ( константа CWnd * pWndInsertAfter, int x, int y, int cx, int cy, UINT nFlags );

Значення, яке повертається

Ненульовий, якщо функція успішно; в іншому випадку 0.

Параметри

pWndInsertAfter

Визначає CWnd об'єкт, який передуватиме CWnd об'єкт в Z-послідовності. Цей параметр може бути вказівник на CWnd або вказівник на одне з таких значень:

w&ndBottomnbsp; Розташовує вікно в нижній частині Z-послідовності. Якщо цей CWnd найвищий вікно, вікно втрачає її найвищому статус; система Розташовує вікно в нижній частині всіх інших вікон.
w&ndTopnbsp; Розташовує вікна у верхній частині Z-послідовності.
w&ndTopMostnbsp; Розташовує вікна перш за все nontopmost windows. Вікна утримується його верхню позицію, навіть тоді, коли вона буде деактивовано.
wnd&NoTopMostnbsp; Repositions вікна до верхньої частини всіх nontopmost windows (тобто, за всі найвищого windows). Цей прапор має ніякого ефекту, якщо вікно вже nontopmost вікна.
Перегляньте розділ «Зауваження» для цієї функції для правила про те, як використовувати цей параметр.

Визначає нові положення в лівій частині вікна.

Визначає нові положення у верхній частині вікна.

Визначає нові ширину вікна.

Визначає висоту нового вікна.

nFlags

Визначає розмір і параметри розташування. Цей параметр може бути поєднання таких:

SWP_DRAWFRAME Малює (визначено під час створення вікна) рамки навколо вікна.
SWP_FRAMECHA&NGEDnbsp; Надсилає повідомлення WM_NCCALCSIZE вікна, навіть якщо не будучи змінюється розмір вікна. Якщо не вказано цей прапор, WM_NCCALCSIZE надсилається лише тоді, коли змінюється розмір вікна.
SWP_HIDEWI&NDOWnbsp; Приховування вікна.
SWP_&NOACTIVATEnbsp; Не вдалося активувати вікно. Якщо не встановлено цю позначку, у вікні активується і переїхав у верхній частині або за верхнім або nontopmost групи (в залежності від значення параметра pWndInsertAfter ).
SWP_&NOCOPYBITSnbsp; Видаляє весь вміст області клієнта. Якщо не вказано цей прапор, дійсний вміст області клієнта зберігаються й скопійовані назад в області клієнта після вікна розміром або переміщено.
SWP_&NOMOVEnbsp; Зберігає поточну позицію (ігнорує параметри x та y ).
SWP_&NOOWNERZORDERnbsp; Не змінити власника вікно позицію в Z-послідовності.
SWP_&NOREDRAWnbsp; Не перемальовування зміни. Якщо цей прапор, немає фарбування будь-якого відбувається. Це стосується клієнтської області, nonclient районі (в тому числі на назву та смуги прокручування) і будь-якій частині вікна батьків, виявили з вікна переміщений. Коли встановлено цю позначку, застосунок має явно недійсними або перемальовування будь-якої частини вікно та вікно з батьків, які повинні бути Перемальовує.
SWP_&NOREPOSITIONnbsp; Так само, як SWP_NOOWNERZORDER.
SWP_&NOSENDCHANGINGnbsp; Запобігає вікна повідомлення WM_WINDOWPOSCHANGING.
SWP_&NOSIZEnbsp; Зберігає поточний розмір (ігнорує cx і cy параметри).
SWP_&NOZORDERnbsp; Зберігає поточний замовлення (ігнорує pWndInsertAfter).
SWP_SHOWWI&NDOWnbsp; Відображає вікно.

Зауваження

Цю функцію член, щоб змінити розмір, розташування та Z-послідовності дитини, спливаюче і верхнього рівня Windows.

Windows впорядковуються на екрані в Z-порядку їх; у вікні у верхній частині Z-послідовності з'являється у верхній частині всіх інших вікон в порядку.

Всі координати для дитини wi&ndows є клієнтом .nbsp координати (по відношенню до верхньому лівому куті вікна батьківського клієнтської області);

Вікно можна переміщати верхню Z-замовлення або установивши параметр pWndInsert&After підсилювача; wndTopMost і забезпечення того, що SWP_NOZORDER прапор встановлена або встановлення у вікні Z-послідовності, так, щоб будь-який верхнього вікна. Після nontopmost вікно верхнього свого належить windows також зроблені найвищого. Його власники не змінюється.

Найвищий вікно вже не найвищого, якщо його переміщено до нижньої (& wndBottom) Z-порядку, або після будь-якого nontopmost вікна. Після найвищого вікно nontopmost всі його власників і його власності windows також зроблені nontopmost windows.

Якщо ні SWP_NOACTIVATE , ні SWP_NOZORDER (тобто, коли застосування запитує, що вікно одночасно бути активована і розміщено в указаному порядку Z), значення, вказаного в pWndInsertAfter використовується тільки в нижче обставин:

Ні amp; wndTopMost , ні & wndNoTopMost визначається параметром pWndInsertAfter.
Це вікно не є активного вікна.

Застосунку не вдалося активувати неактивного вікна без також приведення його у верхній частині Z-послідовності. Додатки можна змінити порядок z активованого вікна без обмежень.

Nontopmost вікно може володіти верхнього вікна, а не навпаки. Будь-яке вікно (наприклад, у діалоговому вікні), належать найвищому вікно є сам зробив верхнього вікна, щоб переконатися, що все у власності windows залишатися над їх власника.

З Windows версії 3.1 і пізніше windows може переміщено на початок Z-послідовності і замкнули там, встановивши їх WS_EX_TOPMOST стилі. Найвищий вікно зберігає його першому місці, навіть якщо відключена. Наприклад, вибір команди WinHelp завжди на верхній робить верхнього вікна довідки і це то залишався видимим, коли ви повернетеся до вашого застосування.

Створити вікно верхнього, виклику SetWindowPos із параметром pWndInsert&After дорівнює amp; wndTopMost, або встановити стиль WS_EX_TOPMOST , під час створення вікна.

Z-послідовності містить будь-яких windows з WS_EX_TOPMOST стилю, переїхав зі значенням & wndTopMost вікно знаходиться на вершині всі nontopmost Windows, але нижче верхнього вікна. Коли програма Активація неактивного вікна без трохи WS_EX_TOPMOST , вікна переміщується вище всіх nontopmost windows, але нижче верхнього вікна.

Якщо SetWindowPos це називається, коли pWndInsert&After параметр є amp; wndBottom і CWnd це найвищий вікно, вікно втрачає свого найвищого статусу (знятоWS_EX_TOPMOST ) і системи Розташовує вікно в нижній частині Z-послідовності.

Огляд CWnd |nbsp; Члени класу | Ієрархічна діаграма

Дивіться такожnbsp; :: DeferWindowPos, :: SetWindowPos

Index