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 } |
属性
|
|
公共功能
| 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 中引入。
属性文档
accepted : bool
该属性表示请求是否被接受。
访问功能：
| bool | isAccepted() const |
| void | setAccepted(bool accepted) |
[read-only] editFlags : const EditFlags
此属性保存当前上下文中可用的编辑操作。
如果没有可用操作，则返回CanDoNone 。
访问功能：
| QWebEngineContextMenuRequest::EditFlags | editFlags() const |
[read-only] isContentEditable : const bool
该属性表示用户是否可以编辑上下文菜单请求。
访问功能：
| bool | isContentEditable() const |
[read-only] linkText : const QString
如果上下文菜单请求是针对链接的，则该属性将保存链接文本。
访问功能：
| QString | linkText() const |
[read-only] linkUrl : const QUrl
如果菜单上下文请求是链接，该属性将保存链接的 URL。
但不保证是有效的 URL。
访问功能：
| QUrl | linkUrl() const |
[read-only] mediaFlags : const MediaFlags
该属性显示当前媒体元素的状态及其可用操作。
如果所选网页内容不是媒体元素，则返回MediaNone 。
访问功能：
| QWebEngineContextMenuRequest::MediaFlags | mediaFlags() const |
[read-only] mediaType : const MediaType
此属性保存媒体元素的类型，如果上下文菜单请求不是媒体元素，则保存MediaTypeNone 。
访问功能：
| QWebEngineContextMenuRequest::MediaType | mediaType() const |
[read-only] mediaUrl : const QUrl
如果上下文菜单请求是媒体元素，则该属性包含媒体元素的 URL。
访问功能：
| QUrl | mediaUrl() const |
[read-only] misspelledWord : const QString
如果菜单上下文请求是拼写检查程序认为拼写错误的单词，该属性将保留拼写错误的单词。
有关该词的可能替代词，请参阅spellCheckerSuggestions()。
访问功能：
| QString | misspelledWord() const |
[read-only] position : const QPoint
该属性保存上下文菜单请求的位置，通常是触发上下文菜单事件的鼠标位置。
访问功能：
| QPoint | position() const |
[read-only] selectedText : const QString
该属性保存上下文菜单请求的选定文本。
访问功能：
| QString | selectedText() const |
[read-only] spellCheckerSuggestions : const QStringList
如果菜单上下文请求是拼写检查程序认为拼写错误的单词，该属性将保存misspelledWord() 的建议替换列表。
访问函数：
| QStringList | spellCheckerSuggestions() const |
© 2026 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.
