QContextMenuEvent Class

詳細説明

コンテキストメニューイベントは、ユーザがコンテキストメニューを開くべきアクションを実行したときに送られます：

• マウスの右ボタンのクリック
• キーボードのメニューキーを押す（キーボードにメニューキーがある場合、標準的な104キーPCキーボードのメニューキーなど）
• その他のキーボードショートカットを押す（macOS 15以降のデフォルトでは "Ctrl+Return "など）。

期待されるコンテキストメニューは、アプリケーション内のコンテンツ（"コンテキスト"）に関連するactions 。Qt では、コンテキストは少なくとも QContextMenuEvent を受け取る特定のwidget またはQt Quick Item を指します。選択項目がある場合は、それがコンテキストとして扱われます。コンテキストは、QContextMenuEvent::pos()を使用して、ウィジェット、アイテム、または選択範囲内のコンテンツを特定するために、さらに絞り込むことができます。

ウィジェットは、このイベントを処理するためにQWidget::contextMenuEvent() をオーバーライドできます。多くのウィジェットは既にそうなっており、デフォルトで便利なコンテキストメニューを持っています。一部のウィジェットには、createStandardContextMenu() のような関数があり、デフォルトのアクション・セットをQMenu に入力します。

Qt Quick では、ContextMenu attached プロパティでイベントを処理できます。QtQuick.Controls コントロールの中には、デフォルトでコンテキストメニューを提供しているものがあります。

ほとんどの合成イベント（QTouchEvent やQTabletEvent が受け付けられなかった後にのみ送信されるQMouseEvent など）とは異なり、QContextMenuEvent は、元のマウスイベントやキーイベントが既に処理されてaccepted されたかどうかに関係なく送信されます。これは、マウスの右ボタン（クリックまたはドラッグ）を使用して何らかのアイテム（アイコン、描画要素、またはアイテムビューのセル）を選択し、マウスの右ボタンを離すとすぐにコンテキストメニューが表示されるというWindowsのUIパターンに対応するためです。(そのため、Windows では QContextMenuEvent はマウスを離したときに送られ、他のプラットフォームでは押したときに送られます。Qt はデフォルトでplatform convention に従います。

また、Pane のようなQt Quick Controls の中にはマウスイベントを受け付けるものがあり、マウスの押下やクリックの後に QContextMenuEvent を受け取るようになっています。

押したときにコンテキストメニューを開き、離したときにメニュー項目をドラッグして選択する、押し-ドラッグ-離しという UI パターンをサポートしたい場合は、QMouseEvents を直接処理する必要があります（QWidget サブクラスでvirtual functions をオーバーライドするか、Qt Quick でメニューを開くためにTapHandler を使用します）。reason() がMouse の場合、QContextMenuEvent は冗長になります。ignoreしかし、ウィジェット、カスタムコントロール、またはアプリケーションが、comes from プラットフォーム固有のキーボードショートカットを使用する QContextMenuEvent に応答できるようにする必要があります。

QContextMenuEvent がignored されると、Qt はposition の下にある他のウィジェットやアイテム（通常はカーソル位置から変換されます）にイベントを送ろうとします。