Тип QML ContextMenuRequest
Запрос на отображение контекстного меню. Подробнее...
| Выражение импорта: | import QtWebEngine |
| С тех пор: | QtWebEngine 1.4 |
Свойства
- accepted : bool
- editFlags : flags
- isContentEditable : bool
- linkText : string
- linkUrl : url
- mediaFlags : flags
- mediaType : перечисление
- mediaUrl : url
- misspelledWord : string
- position : точка
- 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
Указывает, был ли обработан запрос контекстного меню обработчиком сигнала.
Если свойство false после выполнения всех обработчиков сигнала WebEngineView::contextMenuRequested, будет отображено стандартное контекстное меню. Чтобы этого избежать, установите request.accepted в true.
Значение по умолчанию false.
Примечание: Стандартное содержимое контекстного меню зависит от веб-элемента, для которого был сгенерирован запрос.
[только для чтения, с QtWebEngine 1.7] editFlags : flags
Доступные операции редактирования в текущем контексте или 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 будет валидным.
[только для чтения, с QtWebEngine 1.7] mediaFlags : flags
Текущее состояние медиаэлемента и доступные операции. 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
Если контекст содержит слово, признанное орфографической ошибкой проверкой правописания, возвращает список предложенных замен.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qml-qtwebengine-contextmenurequest.html