QWebEngineContextMenuData Class

The QWebEngineContextMenuData class provides context data for populating or extending a context menu with actions. More...

Header: #include <QWebEngineContextMenuData>
qmake: QT += webenginewidgets
Since: Qt 5.7

This class was introduced in Qt 5.7.

Public Types

enum EditFlag { CanUndo, CanRedo, CanCut, CanCopy, CanPaste, …, CanEditRichly }
flags EditFlags
enum MediaFlag { MediaInError, MediaPaused, MediaMuted, MediaLoop, MediaCanSave, …, MediaCanRotate }
flags MediaFlags
enum MediaType { MediaTypeNone, MediaTypeImage, MediaTypeVideo, MediaTypeAudio, MediaTypeCanvas, …, MediaTypePlugin }

Public Functions

QWebEngineContextMenuData(const QWebEngineContextMenuData &other)
QWebEngineContextMenuData()
QWebEngineContextMenuData & operator=(const QWebEngineContextMenuData &other)
~QWebEngineContextMenuData()
QWebEngineContextMenuData::EditFlags editFlags() const
bool isContentEditable() const
bool isValid() const
QString linkText() const
QUrl linkUrl() const
QWebEngineContextMenuData::MediaFlags mediaFlags() const
QWebEngineContextMenuData::MediaType mediaType() const
QUrl mediaUrl() const
QString misspelledWord() const
QPoint position() const
QString selectedText() const
QStringList spellCheckerSuggestions() const

Detailed Description

QWebEngineContextMenuData is returned by QWebEnginePage::contextMenuData() after a context menu event, and contains information about where the context menu event took place. This is also in the context in which any context specific QWebEnginePage::WebAction will be performed.

Member Type Documentation

enum QWebEngineContextMenuData::EditFlagflags QWebEngineContextMenuData::EditFlags

The available edit operations in the current context.

Constant Value Description
QWebEngineContextMenuData::CanUndo 0x1 Undo is available.
QWebEngineContextMenuData::CanRedo 0x2 Redo is available.
QWebEngineContextMenuData::CanCut 0x4 Cut is available.
QWebEngineContextMenuData::CanCopy 0x8 Copy is available.
QWebEngineContextMenuData::CanPaste 0x10 Paste is available.
QWebEngineContextMenuData::CanDelete 0x20 Delete is available.
QWebEngineContextMenuData::CanSelectAll 0x40 Select All is available.
QWebEngineContextMenuData::CanTranslate 0x80 Translate is available.
QWebEngineContextMenuData::CanEditRichly 0x100 Context is richly editable.

This enum was introduced or modified in Qt 5.11.

The EditFlags type is a typedef for QFlags<EditFlag>. It stores an OR combination of EditFlag values.

enum QWebEngineContextMenuData::MediaFlagflags QWebEngineContextMenuData::MediaFlags

The current media element's status and its available operations. MediaNone if the selected web page content is not a media element.

Constant Value Description
QWebEngineContextMenuData::MediaInError 0x1 An error occurred.
QWebEngineContextMenuData::MediaPaused 0x2 Media is paused.
QWebEngineContextMenuData::MediaMuted 0x4 Media is muted.
QWebEngineContextMenuData::MediaLoop 0x8 Media can be looped.
QWebEngineContextMenuData::MediaCanSave 0x10 Media can be saved.
QWebEngineContextMenuData::MediaHasAudio 0x20 Media has audio.
QWebEngineContextMenuData::MediaCanToggleControls 0x40 Media can show controls.
QWebEngineContextMenuData::MediaControls 0x80 Media controls are shown.
QWebEngineContextMenuData::MediaCanPrint 0x100 Media is printable.
QWebEngineContextMenuData::MediaCanRotate 0x200 Media is rotatable.

This enum was introduced or modified in Qt 5.11.

The MediaFlags type is a typedef for QFlags<MediaFlag>. It stores an OR combination of MediaFlag values.

enum QWebEngineContextMenuData::MediaType

This enum describes the media type of the context if any.

Constant Value Description
QWebEngineContextMenuData::MediaTypeNone 0 The context is not a media type.
QWebEngineContextMenuData::MediaTypeImage 1 The context is an image element.
QWebEngineContextMenuData::MediaTypeVideo 2 The context is a video element.
QWebEngineContextMenuData::MediaTypeAudio 3 The context is an audio element.
QWebEngineContextMenuData::MediaTypeCanvas 4 The context is a canvas element.
QWebEngineContextMenuData::MediaTypeFile 5 The context is a file.
QWebEngineContextMenuData::MediaTypePlugin 6 The context is a plugin element.

Member Function Documentation

QWebEngineContextMenuData::QWebEngineContextMenuData(const QWebEngineContextMenuData &other)

Constructs context menu data from other.

QWebEngineContextMenuData::QWebEngineContextMenuData()

Constructs null context menu data.

QWebEngineContextMenuData &QWebEngineContextMenuData::operator=(const QWebEngineContextMenuData &other)

Assigns the other context menu data to this.

QWebEngineContextMenuData::~QWebEngineContextMenuData()

Destroys the context menu data.

QWebEngineContextMenuData::EditFlags QWebEngineContextMenuData::editFlags() const

Returns the available edit operations in the current context or CanDoNone if no actions are available.

bool QWebEngineContextMenuData::isContentEditable() const

Returns true if the content is editable by the user; otherwise returns false.

bool QWebEngineContextMenuData::isValid() const

Returns true if the context data is valid; otherwise returns false.

QString QWebEngineContextMenuData::linkText() const

Returns the text of a link if the context is a link.

QUrl QWebEngineContextMenuData::linkUrl() const

Returns the URL of a link if the context is a link. It is not guaranteed to be a valid URL.

QWebEngineContextMenuData::MediaFlags QWebEngineContextMenuData::mediaFlags() const

Returns the current media element's status and its available operations. MediaNone if the selected web page content is not a media element.

QWebEngineContextMenuData::MediaType QWebEngineContextMenuData::mediaType() const

Returns the type of the media element or MediaTypeNone if the context is not a media element.

QUrl QWebEngineContextMenuData::mediaUrl() const

If the context is a media element, returns the URL of that media.

QString QWebEngineContextMenuData::misspelledWord() const

If the context is a word considered misspelled by the spell-checker, returns the misspelled word.

For possible replacements of the word, see spellCheckerSuggestions().

This function was introduced in Qt 5.8.

QPoint QWebEngineContextMenuData::position() const

Returns the position of the context, usually the mouse position where the context menu event was triggered.

QString QWebEngineContextMenuData::selectedText() const

Returns the selected text of the context.

QStringList QWebEngineContextMenuData::spellCheckerSuggestions() const

If the context is a word considered misspelled by the spell-checker, returns a list of suggested replacements for misspelledWord().

This function was introduced in Qt 5.8.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.14/qwebenginecontextmenudata.html