TrackPopupMenuEx,函式名。该函式在指定位置显示快捷选单,并跟蹤选单项的选择。快捷选单可出现在萤幕上的任何位置。
基本介绍
- 中文名:函式
- 外文名:TrackPopupMenuEx
- 快捷选单:可出现在萤幕上的任何位置
- 函式原型:BOOL TrackPopupMenuEx
其他信息
函式原型:BOOL TrackPopupMenuEx(HMENU hMenu,UINT fuFlags,int x,int y,HWND hWnd,LPTPMPARAMS lptpm);
参数:
hMenu:被显示的快捷选单的句柄。此句柄可为调用CreatePoPuPMenu创建的新快捷选单的句柄,也可以为调用GetSubMenu取得的与一个已存在选单项相联繫的子选单的句柄。
fuFlags:定位或其他选项。此参数可为零或取在函式CreatePopupMenu里所列的值,也可取下列之一值:
TPM_HORIZONTAL:在不覆盖排斥矩形就不能在指定位置显示选单时,系统将先考虑水平对齐的要求。
TPM_VERTICAL:在不覆盖排斥矩形就不能在指定位置显示选单时,系统将先考虑垂直对齐的要求。排斥矩形是指萤幕上选单不能覆盖的部分,由Iptpm指定。
X:在萤幕坐标下,快捷选单的水平位置。
Y:在萤幕坐标下,快捷选单的垂直位置。
hWnd:拥有快捷选单的视窗的句柄。此视窗接收来自选单的所有讯息。函式返回前,此视窗不接受来自选单的WM_COMMAND讯息。
如果在参数fuFlags里指定了TPM_NONOTIFY值,此函式不向hwnd标识的视窗发讯息。 但必须给hwnd里传一个视窗句柄,可以是应用程式里的任一个视窗句柄。
lptpm:指向结构TPMPARAMS的指针,该结构指定萤幕上选单不能覆盖的区域。此参数可为NULL。
返回值:如果在参数fuFlags里指定了TPM_RETURNCMD值,则返回值是用户选择的选单项的标识符。如果用户未作选择就取消了选单或发生了错误,则返回值是零。如果没在参数fuFlags里指定TPM_RETURNCMD值,函式调用成功,返回非零值,若函式调用失败,返回零。若想获得更多的错误信息,请调用GetLastError
函式。
备注:Womdpws CE不支持参数fuFlags取下列值:
TPM_NONOTIFY;TPM_LEFTTBUTTON;TPM_RIGHTBUTTTON;TPM_HORIZONTAL;TPM_VERTICAL;
参数lptpm必须设为NULL。
速查:Windows NT:4.0及以上版本;Windows:95及以上版本;Windows CE:1.0及以上版本;头档案:winuser.h;输入库:user32.lib。