CWnd::SetWindowPos

BOOL SetWindowPos ( const 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;  Перемещает окно в верхней части всех nontopmost окон (то есть, за все верхнего окна). Этот флаг не работает, если это уже nontopmost окно.

  Эта функция для правил о том, как используется этот параметр в разделе «Примечания».

x

Определяет новое положение в левой части окна.

y

Определяет новое положение в верхней части окна.

cx

Определяет новую ширину окна.

cy

Определяет новую высоту окна.

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;  Изменения не перерисовывать. Если этот флаг установлен, не перекраску любого вида происходит. Это относится к клиентской области, неклиентской области (включая полосы, название и прокрутки) и любой части родительского окна, обнаружили из перемещаемых окон. Когда этот флаг установлен, приложение должно явно недействительной или перерисовать любой части окна и родительского окна, которая должна быть перерисована.
  
  
• SWP_&NOREPOSITIONnbsp;  Же самое, что SWP_NOOWNERZORDER.
  
  
• SWP_&NOSENDCHANGINGnbsp;  Предотвращает получение сообщения WM_WINDOWPOSCHANGING окна.
  
  
• SWP_&NOSIZEnbsp;  Сохраняет текущий размер (игнорирует параметры cx и cy ).
  
  
• SWP_&NOZORDERnbsp;  Сохраняет текущий заказ (не pWndInsertAfter).
  
  
• SWP_SHOWWI&NDOWnbsp;  Отображение окна.

Примечания

Вызовите эту функцию-член изменить размер, положение и Z-порядка, всплывающее и верхнего уровня окон ребенка,.

Windows располагаются на экране в соответствии с их Z-порядком; окно в верхней части Z-порядка появляется поверх всех остальных окон в порядке.

Все координаты для дочерних окон являются клиентские координаты (относительно верхнего левого угла родительского окна клиентской области) . 

Окно можно переместить в начало Z-порядка, либо с помощью параметра pWndInsert&After amp; wndTopMost и обеспечению, SWP_NOZORDER флага не задано или путем установки окна Z-порядка, таким образом, чтобы это выше любой существующий верхний windows. Когда nontopmost окно переднего плана, его собственные окна также верхний. Его владельцы не изменяются.

Верхний окно больше не является верхним если изменении его положения в нижнюю (& wndBottom) в конец Z-порядка или после любого nontopmost окна. Когда окно верхнего nontopmost, все его владельцев и его собственные окна также nontopmost windows.

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

• В параметре pWndInsert&After не указаны ни amp; wndTopMost , ни и wndNoTopMost.
  
  
• Это окно не является активным окном.

Приложение не может активировать неактивного окна без также привести его в начало Z-порядка. Приложения можно изменить Z-порядок активированное окно без ограничений.

Nontopmost окно может владеть окно переднего плана, но не наоборот. Сам по себе сделал верхнего окна, чтобы гарантировать, что все владел windows оставаться выше их владельцем является любое окно (например, диалоговое окно), принадлежащие в верхнем окне.

ОС с Windows версии 3.1 и более поздних, windows может быть переехал в верхней части Z-порядка и там, установив их WS_EX_TOPMOST стили. Верхний окно сохраняет свою верхнюю позицию даже при деактивации. Например при выборе команды WinHelp поверх всех делает верхнего окна справки и затем остается видимым после возврата в приложение.

Для создания верхнего окна, вызвать SetWindowPos с параметром pWndInsert&After равным amp; wndTopMost, или задать стиль WS_EX_TOPMOST при создании окна.

Если Z-порядка содержит все окна с WS_EX_TOPMOST стилем, окно с & wndTopMost значение помещается в верхней всех nontopmost окон, но ниже верхнего windows. Когда приложение активирует неактивного окна без WS_EX_TOPMOST бит, окно перемещается над всеми nontopmost windows, но ниже верхнего windows.

Если SetWindowPos вызывается, когда параметр pWndInsert&After является amp; wndBottom CWnd представляет собой верхний окно, окно теряет свой верхний статус (WS_EX_TOPMOST снимается), и система помещает окно в нижней части Z-порядка.

Обзор CWnd |nbsp; Члены класса | Иерархическая схема

См. такжеnbsp; :: DeferWindowPos, :: SetWindowPos