QContextMenuEvent Class

詳細な説明

コンテキスト メニュー イベントは、ユーザーがコンテキスト メニューを開くべき操作を実行したときに送信されます。

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

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

ウィジェットは、QWidget::contextMenuEvent() をオーバーライドしてこのイベントを処理できます。多くのウィジェットはすでにこれを行っており、デフォルトで便利なコンテキストメニューを備えています。一部のウィジェットには、createStandardContextMenu() などの関数があり、デフォルトのアクションセットをQMenu に設定します。これはサブクラスでさらにカスタマイズしてから表示することができます。

Qt Quick では、ContextMenu というアタッチドプロパティを介してこのイベントを処理できます。一部のQtQuick.Controls コントロールは、デフォルトでコンテキストメニューを提供しています。

ほとんどの合成イベント（QTouchEvent やQTabletEvent が受け入れられなかった場合にのみ送信されるQMouseEvent など）とは異なり、QContextMenuEvent は、元のマウスイベントやキーイベントがすでに処理済みであるかどうかにかかわらず送信されます。accepted 。 これは、WindowsのUIパターン（右マウスボタン（クリックまたはドラッグ）を使用して何らかの項目（アイコン、描画要素、またはItem View内のセルなど）を選択し、右マウスボタンを離すとすぐにコンテキストメニューが表示される）に対応するためのものです。（メニュー上のアクションは、選択対象に適用されることを意図しています。） したがって、Windows では QContextMenuEvent はマウスボタンを離したときに送信されますが、他のプラットフォームでは押下時に送信されます。Qt はデフォルトでplatform convention に従います。

また、Pane など、マウスイベントを受け付ける一部のQt Quick コントロールも、マウス押下またはクリック後に QContextMenuEvent を受信します。

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

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