このページでは

ContextMenuRequest QML Type

コンテキストメニューの表示要求。もっと見る

Import Statement: import QtWebEngine
Since: QtWebEngine 1.4

プロパティ

詳細説明

ContextMenuRequestは、WebEngineView::contextMenuRequested シグナルの引数として渡される。ContextMenuRequestは、リクエストのコンテキストに関する詳細情報を提供する。position プロパティは、リクエストのオリジンを提供する。

リクエストのaccepted プロパティは、リクエストをユーザー・コードで処理するか、デフォルトのコンテキスト・メニューを表示するかを示します。

以下のコードでは、カスタム・メニューを使用してリクエストを処理しています:

WebEngineView {
    id: view
    // ...
    onContextMenuRequested: function(request) {
        request.accepted = true;
        myMenu.x = request.x;
        myMenu.y = request.y;
        myMenu.trigger.connect(view.triggerWebAction);
        myMenu.popup();
    }
    // ...
}

プロパティの説明

accepted : bool

コンテキストメニュー要求がシグナルハンドラによって処理されたかどうかを示す。

WebEngineView::contextMenuRequested のシグナルハンドラが実行された後にこのプロパティがfalse に設定されると、デフォルトのコンテキストメニューが表示されます。これを防ぐには、request.acceptedtrue に設定します。

デフォルトはfalse です。

注意: コンテキストメニューのデフォルトの内容は、要求が実際に生成された Web 要素によって異なります。

editFlags : flags [read-only, since QtWebEngine 1.7]

現在のコンテキストで利用可能な編集操作、または利用可能な操作がない場合はCanDoNone

定数説明
ContextMenuRequest.CanUndo元に戻すが可能。
ContextMenuRequest.CanRedoやり直しが可能
ContextMenuRequest.CanCut切り取りが可能
ContextMenuRequest.CanCopyコピー
ContextMenuRequest.CanPaste貼り付けができます。
ContextMenuRequest.CanDelete削除ができます。
ContextMenuRequest.CanSelectAllすべて選択
ContextMenuRequest.CanTranslate翻訳が可能です。
ContextMenuRequest.CanEditRichlyコンテキストはリッチに編集可能です。

このプロパティは QtWebEngine 1.7 で導入されました。

isContentEditable : bool [read-only]

選択したウェブコンテンツが編集可能かどうかを示します。

linkText : string [read-only]

コンテキストメニューがリンクに対して要求された場合は、リンクのテキスト。

linkUrl : url [read-only]

選択したウェブページのコンテンツがリンクの場合、リンクのURL。有効なURLであることを保証するものではありません。

mediaFlags : flags [read-only, since QtWebEngine 1.7]

現在のメディア要素のステータスと利用可能な操作。選択したウェブページコンテンツがメディア要素でない場合は、MediaNone

定数説明
ContextMenuRequest.MediaInErrorエラーが発生しました。
ContextMenuRequest.MediaPausedメディアは一時停止しています。
ContextMenuRequest.MediaMutedメディアはミュートされています。
ContextMenuRequest.MediaLoopメディアはループできます。
ContextMenuRequest.MediaCanSaveメディアを保存できる。
ContextMenuRequest.MediaHasAudioメディアに音声がある。
ContextMenuRequest.MediaCanToggleControlsメディアはコントロールを表示できる。
ContextMenuRequest.MediaControlsメディアにコントロールが表示されている。
ContextMenuRequest.MediaCanPrintメディアが印刷可能である。
ContextMenuRequest.MediaCanRotateメディアが回転可能である。

このプロパティは QtWebEngine 1.7 で導入されました。

mediaType : enumeration [read-only]

メディア要素のタイプ。選択したウェブページコンテンツがメディア要素でない場合はMediaTypeNone

定数説明
ContextMenuRequest.MediaTypeNoneメディアではありません。
ContextMenuRequest.MediaTypeImage画像。
ContextMenuRequest.MediaTypeVideoビデオ
ContextMenuRequest.MediaTypeAudioオーディオ・エレメント
ContextMenuRequest.MediaTypeCanvasキャンバス。
ContextMenuRequest.MediaTypeFileファイル。
ContextMenuRequest.MediaTypePluginプラグイン

mediaUrl : url [read-only]

選択したウェブコンテンツがメディア要素の場合は、メディアのURL。

misspelledWord : string [read-only]

文脈がスペルチェッカーによってスペルミスとみなされた単語の場合、スペルミスの単語を返す。

position : point [read-only]

コンテキストメニューリクエストが発生したユーザーアクションの位置。

selectedText : string [read-only]

コンテキストメニューが作成された選択テキスト。

spellCheckerSuggestions : stringlist [read-only]

文脈がスペルチェッカーによってスペルミスとみなされた単語の場合、置換候補のリストを返します。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.