Microsoft Foundation Classes (mfc.hlp) (
Table of Contents;
Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software,
purely for historical purposes.
If you're looking for up-to-date documentation, particularly for programming,
you should not rely on the information found here, as it will be woefully
out of date.
CWnd::SetWindowPos
◄CWnd► ◄Up► ◄Contents► ◄Index► ◄Back►
──Microsoft Foundation Classes──────────────────────────────────────────────
void SetWindowPos( const CWnd* pWndInsertAfter, int x, int y, int cx,
int cy, UINT nFlags );
Parameter Description
<pWndInsertAfter> Identifies a CWnd in the window manager's list that
will precede the positioned window.
<x> Specifies the x-coordinate of the new upper-left
corner.
<y> Specifies the y-coordinate of the new upper-left
corner.
<cx> Specifies the new window's width.
<cy> Specifies the new window's height.
<nFlags> Specifies sizing and positioning options. It can be a
combination of the following values:
Value Meaning
SWP_DRAWFRAME Draws a frame (defined in the CWnd
class description) around the
window.
SWP_HIDEWINDOW Hides the CWnd.
SWP_NOACTIVATE Does not activate the CWnd.
SWP_NOMOVE Retains current position (ignores the
<x> and <y> parameters).
SWP_NOREDRAW Does not redraw changes.
SWP_NOSIZE Retains current size (ignores the
<cx> and <cy> parameters).
SWP_NOZORDER Retains current ordering (ignores
<pWndInsertAfter>).
SWP_SHOWWINDOW Displays the CWnd.
Remarks
Changes the size, position, and ordering of child, pop-up, and top-level
windows. Child, pop-up, and top-level windows are ordered according to
their appearance on the screen; the topmost window receives the highest
rank, and it is the first window in the list. This ordering is recorded
in a window list.
If the SWP_NOACTIVATE flag is not specified, the <pWndInsertAfter>
parameter is ignored and CWnd is activated and placed at the top of the
Z order, in front of any other windows.
If the SWP_NOZORDER flag is not specified, Windows places CWnd in the
position following the window identified by <pWndInsertAfter>. If
<pWndInsertAfter> is &wndTop, Windows places CWnd at the top of the
list. If <pWndInsertAfter> is set to &wndBottom, Windows places CWnd at
the bottom of the list.
If the SWP_SHOWWINDOW or the SWP_HIDEWINDOW flag is set, CWnd cannot be
moved or sized.
All coordinates for child windows are relative to the upper-left corner
of the parent window's client area.
See Also
◄::DeferWindowPos►, ◄::SetWindowPos►
-♦-