Тип QML ContextMenuRequest
Запрос на отображение контекстного меню. Подробнее...
| Заявление об импорте: | import QtWebEngine 1.9 |
| С момента: | QtWebEngine 1.4 |
Свойства
- accepted : bool
- editFlags : flags
- isContentEditable : bool
- linkText : строка
- linkUrl : url
- mediaFlags : flags
- mediaType : перечисление
- mediaUrl : url
- misspelledWord : строка
- selectedText : строка
- spellCheckerSuggestions : список строк
- x : целое
- y : целое
Подробное описание
ContextMenuRequest передается в качестве аргумента сигнала WebEngineView::contextMenuRequested. Он предоставляет дополнительную информацию о контексте запроса. Положение источника запроса можно найти с помощью свойств x и y.
Свойство 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.
Примечание: Стандартное содержимое контекстного меню зависит от веб-элемента, для которого был сгенерирован запрос.
[только для чтения] 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 : строка
Текст ссылки, если контекстное меню было запрошено для ссылки.
[только для чтения] linkUrl : url
URL-адрес ссылки, если выбранное содержимое веб-страницы является ссылкой. Не гарантируется, что это будет действительный URL-адрес.
[только для чтения] 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 : перечисление
Тип элемента медиа или MediaTypeNone если выбранное содержимое веб-страницы не является элементом медиа.
| Константа | Описание |
|---|---|
ContextMenuRequest.MediaTypeNone |
Не медиа. |
ContextMenuRequest.MediaTypeImage |
Изображение. |
ContextMenuRequest.MediaTypeVideo |
Видео. |
ContextMenuRequest.MediaTypeAudio |
Аудиоэлемент. |
ContextMenuRequest.MediaTypeCanvas |
Канвас. |
ContextMenuRequest.MediaTypeFile |
Файл. |
ContextMenuRequest.MediaTypePlugin |
Плагин. |
[только для чтения] mediaUrl : url
URL-адрес медиа, если выбранное содержимое — элемент медиа.
[только для чтения] misspelledWord : строка
Если слово считается орфографической ошибкой, возвращает ошибочное слово.
[только для чтения] selectedText : строка
Выбранный текст, для которого было создано контекстное меню.
[только для чтения] spellCheckerSuggestions : stringlist
Если слово считается орфографической ошибкой, возвращает список предложенных замен.
[только для чтения] x : целое
Координата x пользовательского действия, из которого исходит запрос контекстного меню.
[только для чтения] y : целое
Координата y пользовательского действия, из которого исходит запрос контекстного меню.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.13/qml-qtwebengine-contextmenurequest.html