WinSetWindowPos

This function allows the general positioning of a window.

Note: Messages may be received from other processes or threads during the processing of this function.

Syntax

WinSetWindowPos(hwnd, hwndInsertBehind, x, y, cx, cy, fl);

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.

Returns

rc (BOOL) - returns

Repositioning indicator.

TRUE

Window successfully repositioned

FALSE

Window not successfully repositioned.

ERRORS

Possible returns from WinGetLastError

PMERR_INVALID_HWND (0x1001)

An invalid window handle was specified.

PMERR_INVALID_FLAG (0x1019)

An invalid bit was set for a parameter. Use constants defined by PM for options, and do not set any reserved bits.

Example Code

This example uses the recommended size, position and status from the WinQueryTaskSize call to position the first window of a newly-started application (typically the main window).

#define INCL_WINSWITCHLIST
#define INCL_WINFRAMEMGR
#include <OS2.H>

HAB  hab;
SWP  winpos;
HWND hwndFrame;

WinQueryTaskSizePos(hab, 0, &winpos);

 WinSetWindowPos(hwndFrame, HWND_TOP,
     winpos.x,                                       /* x pos */
     winpos.y,                                       /* y pos */
     winpos.cx,                                      /* x size */
     winpos.cy,                                      /* y size */
     SWP_ACTIVATE | SWP_MOVE | SWP_SIZE | SWP_SHOW); /* flags*/

Definition

#define INCL_WINWINDOWMGR /* Or use INCL_WIN, INCL_PM, */
#include <os2.h>

HWND     hwnd;              /*  Window handle. */
HWND     hwndInsertBehind;  /*  Relative window-placement order. */
LONG     x;                 /*  Window position, x-coordinate. */
LONG     y;                 /*  Window position, y-coordinate. */
LONG     cx;                /*  Window size. */
LONG     cy;                /*  Window size. */
ULONG    fl;                /*  Window-positioning options. */
BOOL     rc;                /*  Repositioning indicator. */

rc = WinSetWindowPos(hwnd, hwndInsertBehind, x, y, cx, cy, fl);

Related Functions

• WinGetMinPosition
• WinQueryActiveWindow
• WinQueryWindowPos
• WinSaveWindowPos
• WinSetActiveWindow
• WinSetMultWindowPos
• WinSetWindowPos

Related Messages

• WM_ACTIVATE
• WM_ADJUSTWINDOWPOS
• WM_CALCVALIDRECTS
• WM_ERASEBACKGROUND
• WM_MOVE
• WM_SIZE