ContextMenuRequest QML 类型

显示上下文菜单的请求。更多信息...

导入语句	import QtWebEngine
自	QtWebEngine 1.4

所有成员的列表，包括继承的成员

属性

accepted : bool
editFlags : flags (自 QtWebEngine 1.7)
isContentEditable : bool
linkText : string
linkUrl : url
mediaFlags : flags (自 QtWebEngine 1.7)
mediaType : enumeration
mediaUrl : url
misspelledWord : string
position : point
selectedText : string
spellCheckerSuggestions : stringlist

详细描述

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 [只读，自 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 [只读]

指示所选网页内容是否可编辑。

linkText : string [只读]

如果请求上下文菜单的是链接，则返回链接的文本。

linkUrl : url [只读]

如果所选网页内容是链接，则返回链接的URL。不保证它是一个有效的URL。

mediaFlags : flags [只读, 自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 [只读]

媒体元素的类型，如果所选网页内容不是媒体元素，则为MediaTypeNone。

常量	描述
`ContextMenuRequest.MediaTypeNone`	非媒体。
`ContextMenuRequest.MediaTypeImage`	图像。
`ContextMenuRequest.MediaTypeVideo`	视频。
`ContextMenuRequest.MediaTypeAudio`	音频元素。
`ContextMenuRequest.MediaTypeCanvas`	画布。
`ContextMenuRequest.MediaTypeFile`	文件。
`ContextMenuRequest.MediaTypePlugin`	插件。

mediaUrl : url [只读]

如果所选网页内容是媒体元素，则返回媒体元素的URL。

misspelledWord : string [只读]

如果上下文是拼写检查器认为拼写错误的单词，则返回拼写错误的单词。

position : point [只读]

用户操作的位置，即上下文菜单请求的位置。

selectedText : string [只读]

为上下文菜单创建所选文本。

spellCheckerSuggestions : stringlist [只读]

如果上下文是拼写检查器认为拼写错误的单词，则返回建议的替代列表。