WinGetMinPosition
This function returns the position to which a window is minimized.
Syntax
WinGetMinPosition(hwnd, pswp, pptl)
Parameters
- hwnd (HWND) - Input
- Frame-window handle.
- pswp (PSWP) - Output
- Set window position structure.
- The SWP_SIZE and SWP_MOVE indicators are set in this parameter on return from this function, implying that the parameters have been initialized.
- pptl (PPOINTL) - Input
- Preferred position.
- NULL
- System is to choose the position
- Other
- System is to choose the position nearest to the specified point.
Returns
- rc (BOOL) - returns
- Success indicator.
- TRUE
- Successful completion.
- The WS_MINIMIZE style is set for Template:Hp1. This enables the system to determine which other frame windows are minimized, during the enumeration process performed by this function. Also, the window words QWS_XMINIMIZE and QWS_YMINIMIZE for Template:Hp1 are initialized. This enables the system to ensure that no windows that have been, or are being, minimized use the same position.
- FALSE
- Error occurred.
Remarks
This function chooses the position for a minimized window. It enumerates all the siblings of the specified window to determine the first available position.
Example Code
#define INCL_WINFRAMEMGR /* Or use INCL_WIN, INCL_PM, */ #include <os2.h> HWND hwnd; /* Frame-window handle. */ PSWP pswp; /* Set window position structure. */ PPOINTL pptl; /* Preferred position. */ BOOL rc; /* Success indicator. */ rc = WinGetMinPosition(hwnd, pswp, pptl);
This example uses WinGetMinPosition to determine the minimized position for the window in response to a minimize message (WM_MINMAXFRAME), and then calls WinSetWindowPos to minimize the window to that position.
#define INCL_WINFRAMEMGR /* Window Frame Functions */
#include <os2.h>
BOOL fSuccess; /* Success indicator */
HWND hwnd; /* window handle */
MPARAM mpParam1; /* Parameter 1 (window position) */
PSWP pSwp; /* Set window position structure */
case WM_MINMAXFRAME:
pSwp = (PSWP)PVOIDFROMMP(mpParam1);
switch(pSwp->fl)
{
case SWP_MINIMIZE:
fSuccess = WinGetMinPosition(hwnd, pSwp, NULL);
WinSetWindowPos(hwnd, 0L,
pSwp->x, /* x pos */
pSwp->y, /* y pos */
pSwp->cx, /* x size */
pSwp->cy, /* y size */
SWP_MINIMIZE); /* flags */
break;
}