Back to Qt.io
Contact Us Blog Download Qt

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.accepted をtrue に設定します。

デフォルトは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]

選択された Web コンテンツが編集可能かどうかを示します。


linkText : string [read-only]

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


linkUrl : url [read-only]

選択された Web ページのコンテンツがリンクである場合のリンクの URL。有効なURLであることは保証されません。


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

現在のメディア要素のステータスと利用可能な操作。選択したWebページコンテンツがメディア要素でない場合は、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]

メディア要素のタイプ、または選択された Web ページのコンテンツがメディア要素でない場合はMediaTypeNone を指定します。

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

mediaUrl : url [read-only]

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


misspelledWord : string [read-only]

コンテキストがスペルチェッカーによってスペルミスとみなされた単語の場合は、スペルミスの単語を返します。


position : point [read-only]

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


selectedText : string [read-only]

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


spellCheckerSuggestions : stringlist [read-only]

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


© 2025 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.