ContextMenuRequest QML Type

Eine Aufforderung zur Anzeige eines Kontextmenüs. Mehr...

Import Statement:	`import QtWebEngine`
Since:	QtWebEngine 1.4

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

accepted : bool
editFlags : flags (since QtWebEngine 1.7)
isContentEditable : bool
linkText : string
linkUrl : url
mediaFlags : flags (since QtWebEngine 1.7)
mediaType : enumeration
mediaUrl : url
misspelledWord : string
position : point
selectedText : string
spellCheckerSuggestions : stringlist

Detaillierte Beschreibung

Ein ContextMenuRequest wird als Argument des Signals WebEngineView::contextMenuRequested übergeben. Es liefert weitere Informationen über den Kontext der Anfrage. Die Eigenschaft position gibt den Ursprung der Anfrage an.

Die Eigenschaft accepted der Anforderung gibt an, ob die Anforderung durch den Benutzercode behandelt wird oder das Standardkontextmenü angezeigt werden soll.

Der folgende Code verwendet ein benutzerdefiniertes Menü, um die Anfrage zu behandeln:

WebEngineView {
    id: view
    // ...
    onContextMenuRequested: function(request) {
        request.accepted = true;
        myMenu.x = request.x;
        myMenu.y = request.y;
        myMenu.trigger.connect(view.triggerWebAction);
        myMenu.popup();
    }
    // ...
}

Eigenschaft Dokumentation

accepted : bool

Zeigt an, ob die Anforderung des Kontextmenüs durch den Signalhandler behandelt wurde.

Wenn die Eigenschaft false lautet, nachdem alle Signalhandler für WebEngineView::contextMenuRequested ausgeführt wurden, wird ein Standardkontextmenü angezeigt. Um dies zu verhindern, setzen Sie request.accepted auf true.

Der Standardwert ist false.

Hinweis: Der Standardinhalt des Kontextmenüs hängt von dem Web-Element ab, für das die Anfrage tatsächlich erzeugt wurde.

editFlags : flags [read-only, since QtWebEngine 1.7]

Die verfügbaren Bearbeitungsoperationen im aktuellen Kontext oder CanDoNone, wenn keine Aktionen verfügbar sind.

Konstante	Beschreibung
`ContextMenuRequest.CanUndo`	Rückgängig ist verfügbar.
`ContextMenuRequest.CanRedo`	Wiederholen ist verfügbar.
`ContextMenuRequest.CanCut`	Ausschneiden ist verfügbar.
`ContextMenuRequest.CanCopy`	Kopieren ist verfügbar.
`ContextMenuRequest.CanPaste`	Einfügen ist verfügbar.
`ContextMenuRequest.CanDelete`	Löschen ist verfügbar.
`ContextMenuRequest.CanSelectAll`	Alles auswählen ist verfügbar.
`ContextMenuRequest.CanTranslate`	Übersetzen ist verfügbar.
`ContextMenuRequest.CanEditRichly`	Kontext ist reichhaltig editierbar.

Diese Eigenschaft wurde in QtWebEngine 1.7 eingeführt.

isContentEditable : bool [read-only]

Zeigt an, ob der ausgewählte Webinhalt editierbar ist.

linkText : string [read-only]

Der Text des Links, wenn das Kontextmenü für einen Link angefordert wurde.

linkUrl : url [read-only]

Die URL des Links, wenn der ausgewählte Webseiteninhalt ein Link ist. Es ist nicht garantiert, dass es sich um eine gültige URL handelt.

mediaFlags : flags [read-only, since QtWebEngine 1.7]

Der aktuelle Status des Medienelements und seine verfügbaren Operationen. MediaNone, wenn der ausgewählte Webseiteninhalt kein Medienelement ist.

Konstante	Beschreibung
`ContextMenuRequest.MediaInError`	Ein Fehler ist aufgetreten.
`ContextMenuRequest.MediaPaused`	Medien sind angehalten.
`ContextMenuRequest.MediaMuted`	Medien sind stummgeschaltet.
`ContextMenuRequest.MediaLoop`	Medien können geloopt werden.
`ContextMenuRequest.MediaCanSave`	Medien können gespeichert werden.
`ContextMenuRequest.MediaHasAudio`	Medien haben Ton.
`ContextMenuRequest.MediaCanToggleControls`	Medien können Steuerelemente anzeigen.
`ContextMenuRequest.MediaControls`	Mediensteuerungen werden angezeigt.
`ContextMenuRequest.MediaCanPrint`	Medien sind druckbar.
`ContextMenuRequest.MediaCanRotate`	Medien sind drehbar.

Diese Eigenschaft wurde in QtWebEngine 1.7 eingeführt.

mediaType : enumeration [read-only]

Der Typ des Medienelements oder MediaTypeNone, wenn der ausgewählte Webseiteninhalt kein Medienelement ist.

Konstante	Beschreibung
`ContextMenuRequest.MediaTypeNone`	Kein Medium.
`ContextMenuRequest.MediaTypeImage`	Ein Bild.
`ContextMenuRequest.MediaTypeVideo`	Ein Video.
`ContextMenuRequest.MediaTypeAudio`	Ein Audio-Element.
`ContextMenuRequest.MediaTypeCanvas`	Eine Leinwand.
`ContextMenuRequest.MediaTypeFile`	Eine Datei.
`ContextMenuRequest.MediaTypePlugin`	Ein Plugin.

mediaUrl : url [read-only]

Die URL von Medien, wenn der ausgewählte Webinhalt ein Medienelement ist.

misspelledWord : string [read-only]

Wenn der Kontext ein Wort ist, das von der Rechtschreibprüfung als falsch geschrieben angesehen wird, wird das falsch geschriebene Wort zurückgegeben.

position : point [read-only]

Die Position der Benutzeraktion, von der die Anforderung des Kontextmenüs ausgeht.

selectedText : string [read-only]

Der ausgewählte Text, für den das Kontextmenü erstellt wurde.

spellCheckerSuggestions : stringlist [read-only]

Wenn es sich bei dem Kontext um ein Wort handelt, das von der Rechtschreibprüfung als falsch geschrieben angesehen wird, wird eine Liste mit Vorschlägen für Ersetzungen zurückgegeben.

© 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.