WinQueryMsgPos
Appearance
This function returns the pointer position, in screen coordinates, when the last message obtained from the current message queue is posted.
Syntax
WinQueryMsgPos(hab, pptl)
Parameters
- hab (HAB) - Input
- Anchor-block handle.
- pptl (PPOINTL) - Output
- Pointer position in screen coordinates.
- rc (BOOL) - Returns
- Success indicator. TRUE for success, FALSE for error.
Returns
- rc (BOOL) - returns
- Success indicator.
- TRUE
- Successful completion
- FALSE
- Error occurred.
Remarks
The pointer position is the same as that in the parameter of a QMSG structure.
To obtain the current position of the pointer, use the WinQueryPointerPos function.
Example Code
#define INCL_WINMESSAGEMGR /* Or use INCL_WIN, INCL_PM, */ #include <os2.h> HAB hab; /* Anchor-block handle. */ PPOINTL pptl; /* Pointer position in screen coordinates. */ BOOL rc; /* Success indicator. */ rc = WinQueryMsgPos(hab, pptl);
This example returns position and time of the the last message obtained from the current message queue.
#define INCL_WINMESSAGEMGR #define INCL_WINDIALOGS #include <OS2.H> #include <stdio.h> HAB hab; POINTL ptl; CHAR szMsg[100]; HWND hwnd; ULONG ulTime; WinQueryMsgPos(hab, &ptl); ulTime = WinQueryMsgTime(hab); sprintf(szMsg, "x = %ld\n\ny = %ld\n\ntime = %ld", ptl.x, ptl.y, ulTime); WinMessageBox(HWND_DESKTOP, hwnd, /* client-window handle */ szMsg, /* body of the message */ "Debugging information", /* title of the message */ 0, /* message box id */ MB_NOICON | MB_OK); /* icon and button flags */
Related Functions
- WinBroadcastMsg
- WinCreateMsgQueue
- WinDestroyMsgQueue
- WinDispatchMsg
- WinGetDlgMsg
- WinGetMsg
- WinInSendMsg
- WinPeekMsg
- WinPostMsg
- WinPostQueueMsg
- WinQueryMsgTime
- WinQueryQueueInfo
- WinQueryQueueStatus
- WinSendDlgItemMsg
- WinSendMsg
- WinSetClassMsgInterest
- WinSetMsgInterest
- WinSetMsgMode
- WinSetSynchroMode
- WinWaitMsg