Back to Qt.io
Contact Us Blog Download Qt

ContextMenuRequest QML Type

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

Import Statement: import QtWebEngine
Since: QtWebEngine 1.4

プロパティ

詳細説明

ContextMenuRequestは、WebEngineView::contextMenuRequested シグナルの引数として渡される。これは、リクエストのコンテキストに関する詳細情報を提供する。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]

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


本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。