WinSetWindowPos - Parameters

hwnd (HWND) - input

Window handle.

hwndInsertBehind (HWND) - input

Relative window-placement order.

Ignored if SWP_ZORDER is not selected. Values that can be specified are:

HWND_TOP

Place hwnd on top of all siblings
HWND_BOTTOM
Place hwnd behind all siblings
Other
Identifies the sibling window behind which hwnd is to be placed.

x (LONG) - input

Window position, x-coordinate.

This is the x-coordinate of hwnd. It is in window coordinates relative to the bottom left corner of its parent, but is ignored if SWP_MOVE is not selected.

y (LONG) - input

Window position, y-coordinate.

This is the y-coordinate of hwnd. It is in window coordinates relative to the bottom left corner of its parent, but is ignored if SWP_MOVE is not selected.

cx (LONG) - input

Window size.

This specifies the width of hwnd in device units, but is ignored if SWP_SIZE is not selected.

cy (LONG) - input

Window size.

This specifies the depth of hwnd in device units, but is ignored if SWP_SIZE is not selected.

fl (ULONG) - input

Window-positioning options.

One or more of these options can be specified:

SWP_SIZE

Change the window size.
SWP_MOVE
Change the window x,y position.
SWP_ZORDER
Change the relative window placement.
SWP_SHOW
Show the window.
SWP_HIDE
Hide the window.
SWP_NOREDRAW
Changes are not redrawn.
SWP_NOADJUST
Do not send a WM_ADJUSTWINDOWPOS message before moving or sizing.
SWP_ACTIVATE
Activate the hwnd window if it is a frame window. This indicator has no effect on other windows.

The frame window is made the topmost window, unless SWP_ZORDER is specified also in which instance the hwndInsertBehind window is used.

SWP_DEACTIVATE
Deactivate the hwnd window if it is a frame window. This indicator has no effect on other windows.

The frame window is made the bottommost window, unless SWP_ZORDER is specified, in which instance the hwndInsertBehind window is used.

SWP_MINIMIZE
Minimize the window. This indicator has no effect if the window is in a minimized state, and is also mutually exclusive with SWP_MAXIMIZE and SWP_RESTORE.
SWP_MAXIMIZE
Maximize the window. This indicator has no effect if the window is in a maximized state, and is also mutually exclusive with SWP_MINIMIZE and SWP_RESTORE.
SWP_RESTORE
Restore the window. This indicator has no effect if the window is in its normal state, and is also mutually exclusive with SWP_MINIMIZE and SWP_MAXIMIZE.

The position and size of the window in its normal state is remembered in its window words when it is first maximized or minimized, although these values can be altered by use of the WinSetWindowUShort function.

The window is restored to the position and size remembered in its window words, unless the SWP_MOVE or SWP_SIZE indicators are set. These indicators cause the position and size values specified in this function to be used.

rc (BOOL) - returns

Repositioning indicator.

TRUE

Window successfully repositioned
FALSE
Window not successfully repositioned.

---

[Back: WinSetWindowPos Return Value - rc]
[Next: WinSetWindowPos - Remarks]