win12.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.
WinSetMultWindowPos (1.2)
Function Group                                      Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_WINMESSAGEMGR
 
BOOL WinSetMultWindowPos(hab, pswp, cswp)
HAB hab;        /* handle of the anchor block         */
PSWP pswp;      /* address of array of SWP structures */
USHORT cswp;    /* number of SWP structures           */
 
The WinSetMultWindowPos function performs the WinSetWindowPos function for
specified windows using the pswp parameter, an array of structures whose
elements correspond to the input parameters of WinSetWindowPos. All windows
being positioned must have the same parent window.
 
It is more efficient to use this function than to issue multiple
WinSetWindowPos calls, as it causes less screen updating.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hab        Identifies an anchor block.
 
pswp       Points to an array of SWP data structures whose elements
           correspond to the input parameters of WinSetWindowPos.
 
cswp       Specifies the number of SWP structures.
 
Return Value
 
The return value is TRUE if the function is successful or FALSE if an error
occurs.
 
Comments
 
This function sends the following messages. If you process these messages,
you must be careful to not cause an infinite loop by calling the
WinSetWindowPos or WinSetMultWindowPos functions.
 
     WM_ACTIVATE
     WM_ADJUSTWINDOWPOS
     WM_CALCVALIDRECTS
     WM_MOVE
     WM_SHOW
     WM_SIZE
 
See Also
 
WinSetWindowPos, SWP, WM_ACTIVATE, WM_ADJUSTWINDOWPOS, WM_CALCVALIDRECTS,
WM_MOVE, WM_SHOW, WM_SIZE, WM_WINDOWPOSCHANGED