CContextMenuManager::TrackPopupMenu
更新 : 2007 年 11 月
指定したショートカット メニューを表示し、選択されたショートカット メニュー コマンドのインデックスを返します。
virtual UINT TrackPopupMenu(
HMENU hmenuPopup,
int x,
int y,
CWnd* pWndOwner,
BOOL bRightAlign = FALSE
);
パラメータ
[入力] hmenuPopup
このメソッドが表示するショートカット メニューのハンドル。[入力] x
ショートカット メニューのクライアント座標での水平オフセット。[入力] y
ショートカット メニューのクライアント座標での垂直オフセット。[入力] pWndOwner
ショートカット メニューの親ウィンドウへのポインタ。[入力] bRightAlign
メニュー項目の配置方法を示すブール値パラメータ。bRightAlign が TRUE の場合、メニューは右から左への読み取り順序で右揃えで表示されます。bRightAlign が FALSE の場合、メニューは左から右への読み取り順序で左揃えで表示されます。
戻り値
ユーザーが選択したコマンドのメニュー コマンド ID。ユーザーがメニュー コマンドを選択せずにショートカット メニューを閉じた場合は 0。
解説
このメソッドは、ショートカット メニューを表示するモーダル呼び出しとして機能します。ユーザーがショートカット メニューを閉じるまで、またはコマンドを選択するまで、アプリケーションはコード内の後続の行を実行しません。ショートカット メニューを表示するために使用できるもう 1 つの方法は、CContextMenuManager::ShowPopupMenu です。このメソッドはモーダル呼び出しではなく、選択されたコマンドの ID を返しません。
必要条件
ヘッダー : afxcontextmenumanager.h