Files
uTools-Manuals/src/docs/win32api/TrackPopupMenu.html
2020-06-06 20:39:00 +08:00

35 lines
3.2 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<html>
<body>
<FONT style="FONT: 12px 宋体" color=black>
<h3>函数功能</h3>该函数在指定位置显示快捷菜单,并跟踪菜单项的选择。快捷菜单可出现在屏幕上的任何位置。<br>
<h3>函数原型</h3>BOOL TrackPopupMenuHMENU hMenuUINT uFlagsint xint yint nReservedHWND hWndCONST RECT”prcRect<br>
参数<br>
hMenu被显示的快捷菜单的句柄。此句柄可为调用CreatePopupMenu创建的新快捷菜单的句柄也可以为调用GetSubMenu取得的与一个已存在菜单项相联系的子菜单的句柄。<br>
uFlags一种指定功能选项的位标志。用下列标志位之一来确定函数如何水平放置快捷菜单<br>
TPM_CENTERALLGN若设置此标志函数将按参数x指定的坐标水平居中放置快捷菜单。<br>
TPM_LEFTALLGN若设置此标志函数使快捷菜单的左边界与由参数X指定的坐标对齐。<br>
TPM_RIGHTALLGN若设置此标志函数使快捷菜单的右边界与由参数X指定的坐标对齐。<br>
用下列标志位之一来确定函数如何垂直放置快捷菜单:<br>
TPM_BOTTOMALLGN若设置此标志函数使快捷菜单的下边界与由参数y指定的坐标对齐。<br>
TPM_TOPALLGN若设置此标志函数使快捷菜单的上边界与由参数y指定的坐标对齐。<br>
TPM_VCENTERALLGN若设置此标志函数将按参数y指定的坐标垂直居中放置快捷菜单<br>
用下列标志位之一来确定在菜单没有父窗口的情况下用户的选择:<br>
TPM_NONOTIFY若设置此标志当用户单击菜单项时函数不发送通知消息。<br>
TPM_RETURNCMD若设置此标志函数将用户所选菜单项的标识符返回到返回值里。<br>
用下列标志位之一来确定在快捷菜单跟踪哪一个鼠标键:<br>
TPM_LEFTBUTTON:若设置此标志,用户只能用鼠标左键选择菜单项。<br>
TPM_RIGHTBUTTON若设置此标志用户能用鼠标左、右键选择菜单项。<br>
X在屏幕坐标下快捷菜单的水平位置。<br>
Y:在屏幕坐标下,快捷菜单的垂直位置。<br>
NReserved保留值必须为零。<br>
HWnd拥有快捷菜单的窗口的句柄。此窗口接收来自菜单的所有消息。函数返回前此窗口不接受来自菜单的WM_COMMAND消息。<br>
如果在参数uFlags里指定了TPM_NONOTIFY值此函数不向hWnd标识的窗口发消息。 但必须给hWnd里传一个窗口句柄可以是应用程序里的任一个窗口句柄。<br>
PrcRect未用。<br>
<h3>返回值</h3>如果在参数uFlags里指定了TPM_RETURNCMD值则返回值是用户选择的菜单项的标识符。如果用户未作选择就取消了菜单或发生了错误则退回值是零。如果没在参数uFlags里指定TPM_RETURNCMD值若函数调用成功返回非零值若函数调用失败返回零。若想获得更多的错误信息清调用GetLastError<br>
函数:<br>
备注Windows CE不支持参数uFlags取下列值TPM_NONOTIFYTPM_LEFTBUTTONTPM_RIGHTBUTTON。<br>
<h3>速查</h3>Windows NT3.1及以上版本Windows95及以上版本Windows CE1.0及以上版本头文件winuser.h输入库user32.lib。<br>
</body>
</html>