The TrackPopupMenu function displays a shortcut menu at the specified location and tracks the selection of items on the menu. The shortcut menu can appear anywhere on the screen.
BOOL TrackPopupMenu(
HMENU hMenu, |
// handle of shortcut menu |
UINT uFlags, |
// screen-position and mouse-button flags |
int x, |
// horizontal position, in screen coordinates |
int y, |
// vertical position, in screen coordinates |
int nReserved, |
// reserved, must be zero |
HWND hWnd, |
// handle of owner window |
CONST RECT *prcRect |
// points to RECT that specifies no-dismissal area |
); |
Use one of the following bit flag constants to specify how the function positions the shortcut menu horizontally.
Value |
Meaning |
TPM_CENTERALIGN |
If this flag is set, the function centers the shortcut menu horizontally relative to the coordinate specified by the x parameter. |
TPM_LEFTALIGN |
If this flag is set, the function positions the shortcut menu so that its left side is aligned with the coordinate specified by the x parameter. |
TPM_RIGHTALIGN |
Positions the shortcut menu so that its right side is aligned with the coordinate specified by the x parameter. |
Use one of the following bit flag constants to specify how the function positions the shortcut menu vertically.
Value |
Meaning |
TPM_BOTTOMALIGN |
If this flag is set, the function positions the shortcut menu so that its bottom side is aligned with the coordinate specified by the y parameter. |
TPM_TOPALIGN |
If this flag is set, the function positions the shortcut menu so that its top side is aligned with the coordinate specified by the y parameter. |
TPM_VCENTERALIGN |
If this flag is set, the function centers the shortcut menu vertically relative to the coordinate specified by the y parameter. |
Use the following bit flag constants to determine the user selection without having to set up a parent window for the menu.
Value |
Meaning |
TPM_NONOTIFY |
If this flag is set, the function does not send notification messages when the user clicks on a menu item. |
TPM_RETURNCMD |
If this flag is set, the function returns the menu item identifier of the user's selection in the return value. |
Use one of the following bit flag constants to specify which mouse button the shortcut menu tracks.
Value |
Meaning |
TPM_LEFTBUTTON |
If this flag is set, the shortcut menu tracks the left mouse button. |
TPM_RIGHTBUTTON |
If this flag is set, the shortcut menu tracks the right mouse button |
If you specify TPM_NONOTIFY in the uFlags parameter, the function does
not send messages to the window identified by hWnd. However, you must
still pass a window handle in hWnd. It can be any window handle from
your application.
If you specify TPM_RETURNCMD in the uFlags parameter, the return value is the menu-item identifier of the item that the user selected. If the user cancels the menu without making a selection, or if an error occurs, then the return value is zero.
If you do not specify TPM_RETURNCMD in the uFlags parameter, the return value is nonzero if the function succeeds and zero if it fails. To get extended error information, call GetLastError.
CreatePopupMenu, GetSubMenu, RECT, WM_COMMAND
file: /Techref/os/win/api/win32/func/src/f88_14.htm, 8KB, , updated: 2000/4/7 12:19, local time: 2024/9/1 10:04,
3.14.255.58:LOG IN
|
©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions? <A HREF="http://piclist.com/techref/os/win/api/win32/func/src/f88_14.htm"> TrackPopupMenu</A> |
Did you find what you needed? |
![]() o List host: MIT, Site host massmind.org, Top posters @none found - Page Editors: James Newton, David Cary, and YOU! * Roman Black of Black Robotics donates from sales of Linistep stepper controller kits. * Ashley Roll of Digital Nemesis donates from sales of RCL-1 RS232 to TTL converters. * Monthly Subscribers: Gregg Rew. on-going support is MOST appreciated! * Contributors: Richard Seriani, Sr. |
Welcome to piclist.com! |
.