ContextMenuRequest QML Type

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

Import Statement:	`import QtWebEngine`
Since:	QtWebEngine 1.4

所有成员（包括继承成员）的列表

属性

accepted : bool
editFlags : flags (since QtWebEngine 1.7)
isContentEditable : bool
linkText : string
linkUrl : url
mediaFlags : flags (since 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 。

注：上下文菜单的默认内容取决于实际生成请求的网络元素。

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]

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

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