QWebEngineContextMenuRequest Class
QWebEngineContextMenuRequest 类提供了用于填充或扩展上下文菜单操作的请求。更多
| Header： | #include <QWebEngineContextMenuRequest> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake： | QT += webenginecore |
| 自 | Qt 6.2 |
| 继承： | QObject |
公共类型
(since 6.2) enum | EditFlag { CanUndo, CanRedo, CanCut, CanCopy, CanPaste, …, CanEditRichly } |
| flags | EditFlags |
(since 6.2) enum | MediaFlag { MediaInError, MediaPaused, MediaMuted, MediaLoop, MediaCanSave, …, MediaCanRotate } |
| flags | MediaFlags |
(since 6.2) enum | MediaType { MediaTypeNone, MediaTypeImage, MediaTypeVideo, MediaTypeAudio, MediaTypeCanvas, …, MediaTypePlugin } |
属性
- accepted : bool
公共功能
| virtual | ~QWebEngineContextMenuRequest() |
| QWebEngineContextMenuRequest::EditFlags | editFlags() const |
| bool | isAccepted() const |
| bool | isContentEditable() const |
| QString | linkText() const |
| QUrl | linkUrl() const |
| QWebEngineContextMenuRequest::MediaFlags | mediaFlags() const |
| QWebEngineContextMenuRequest::MediaType | mediaType() const |
| QUrl | mediaUrl() const |
| QString | misspelledWord() const |
| QPoint | position() const |
| QString | selectedText() const |
| void | setAccepted(bool accepted) |
| QStringList | spellCheckerSuggestions() const |
详细说明
QWebEngineContextMenuRequest 由QWebEngineView::lastContextMenuRequest() 在上下文菜单事件后返回，包含上下文菜单事件发生位置的信息。这也是执行任何上下文特定QWebEnginePage::WebAction 的上下文。
成员类型文档
[since 6.2] 枚举 QWebEngineContextMenuRequest::EditFlag
flags QWebEngineContextMenuRequest::EditFlags
当前上下文菜单请求中可用的编辑操作。
| 常量 | 值 | 描述 |
|---|---|---|
QWebEngineContextMenuRequest::CanUndo | 0x1 | 可撤销。 |
QWebEngineContextMenuRequest::CanRedo | 0x2 | 可重做。 |
QWebEngineContextMenuRequest::CanCut | 0x4 | 可剪切。 |
QWebEngineContextMenuRequest::CanCopy | 0x8 | 可复制。 |
QWebEngineContextMenuRequest::CanPaste | 0x10 | 可粘贴。 |
QWebEngineContextMenuRequest::CanDelete | 0x20 | 可删除。 |
QWebEngineContextMenuRequest::CanSelectAll | 0x40 | 可全选。 |
QWebEngineContextMenuRequest::CanTranslate | 0x80 | 可进行翻译。 |
QWebEngineContextMenuRequest::CanEditRichly | 0x100 | 丰富的上下文可编辑。 |
该枚举在 Qt 6.2 中引入。
EditFlags 类型是QFlags<EditFlag> 的类型定义。它存储 EditFlag 值的 OR 组合。
[since 6.2] 枚举 QWebEngineContextMenuRequest::MediaFlag
flags QWebEngineContextMenuRequest::MediaFlags
当前媒体元素的状态及其可用操作。如果所选网页内容不是媒体元素，则为MediaNone 。
| 常量 | 值 | 说明 |
|---|---|---|
QWebEngineContextMenuRequest::MediaInError | 0x1 | 发生错误。 |
QWebEngineContextMenuRequest::MediaPaused | 0x2 | 媒体暂停。 |
QWebEngineContextMenuRequest::MediaMuted | 0x4 | 媒体被静音。 |
QWebEngineContextMenuRequest::MediaLoop | 0x8 | 媒体可以循环播放。 |
QWebEngineContextMenuRequest::MediaCanSave | 0x10 | 媒体可以保存。 |
QWebEngineContextMenuRequest::MediaHasAudio | 0x20 | 媒体有音频。 |
QWebEngineContextMenuRequest::MediaCanToggleControls | 0x40 | 媒体可显示控件。 |
QWebEngineContextMenuRequest::MediaControls | 0x80 | 媒体控件已显示。 |
QWebEngineContextMenuRequest::MediaCanPrint | 0x100 | 媒体可打印。 |
QWebEngineContextMenuRequest::MediaCanRotate | 0x200 | 媒体可旋转。 |
该枚举在 Qt 6.2 中引入。
MediaFlags 类型是QFlags<MediaFlag> 的类型定义。它存储 MediaFlag 值的 OR 组合。
[since 6.2] enum QWebEngineContextMenuRequest::MediaType
该枚举描述了上下文菜单请求的媒体类型（如果有）。
| 常量 | 值 | 描述 |
|---|---|---|
QWebEngineContextMenuRequest::MediaTypeNone | 0 | 上下文不是媒体类型。 |
QWebEngineContextMenuRequest::MediaTypeImage | 1 | 上下文是图像元素。 |
QWebEngineContextMenuRequest::MediaTypeVideo | 2 | 上下文为视频元素。 |
QWebEngineContextMenuRequest::MediaTypeAudio | 3 | 上下文为音频元素。 |
QWebEngineContextMenuRequest::MediaTypeCanvas | 4 | 上下文为画布元素。 |
QWebEngineContextMenuRequest::MediaTypeFile | 5 | 上下文为文件。 |
QWebEngineContextMenuRequest::MediaTypePlugin | 6 | 上下文为插件元素。 |
该枚举在 Qt 6.2 中引入。
成员函数文档
[virtual noexcept] QWebEngineContextMenuRequest::~QWebEngineContextMenuRequest()
销毁上下文菜单请求。
QWebEngineContextMenuRequest::EditFlags QWebEngineContextMenuRequest::editFlags() const
返回当前上下文中可用的编辑操作，如果没有可用操作，则返回CanDoNone 。
注： editFlags 属性的获取函数。
bool QWebEngineContextMenuRequest::isContentEditable() const
如果用户可编辑上下文菜单请求，则返回true ；否则返回false 。
注： 属性 isContentEditable 的获取函数。
QString QWebEngineContextMenuRequest::linkText() const
如果上下文菜单请求的是链接，则返回链接文本。
注：linkText 属性的获取函数。
QUrl QWebEngineContextMenuRequest::linkUrl() const
如果菜单上下文请求是链接，则返回链接的 URL。但不保证是有效的 URL。
注：linkUrl 属性的获取函数。
QWebEngineContextMenuRequest::MediaFlags QWebEngineContextMenuRequest::mediaFlags() const
返回当前媒体元素的状态及其可用操作。如果所选网页内容不是媒体元素，则返回MediaNone 。
注： 属性 mediaFlags 的获取函数。
QWebEngineContextMenuRequest::MediaType QWebEngineContextMenuRequest::mediaType() const
返回媒体元素的类型；如果上下文菜单请求不是媒体元素，则返回MediaTypeNone 。
注： 属性 mediaType 的获取函数。
QUrl QWebEngineContextMenuRequest::mediaUrl() const
如果上下文菜单请求是一个媒体元素，则返回该媒体的 URL。
注： 属性 mediaUrl 的获取函数。
QString QWebEngineContextMenuRequest::misspelledWord() const
如果菜单上下文请求是拼写检查程序认为拼写错误的单词，则返回拼写错误的单词。
有关该词的可能替换，请参阅spellCheckerSuggestions() 。
注： 属性 misspelledWord 的获取函数。
QPoint QWebEngineContextMenuRequest::position() const
返回上下文菜单请求的位置，通常是触发上下文菜单事件的鼠标位置。
注： 属性位置的获取函数。
QString QWebEngineContextMenuRequest::selectedText() const
返回上下文菜单请求的选定文本。
注： 属性 selectedText 的获取函数。
QStringList QWebEngineContextMenuRequest::spellCheckerSuggestions() const
如果菜单上下文请求是拼写检查程序认为拼写错误的单词，则返回misspelledWord() 的建议替换列表。
注： 属性 spellCheckerSuggestions 的获取函数。
© 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.
