基本介紹
- 中文名:函式
- 外文名:TrackPopupMenuEx
- 快捷選單:可出現在螢幕上的任何位置
- 函式原型:BOOL TrackPopupMenuEx
其他信息
函式原型:BOOL TrackPopupMenuEx(HMENU hMenu,UINT fuFlags,int x,int y,HWND hWnd,LPTPMPARAMS lptpm);
參數:
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。