ContextMenuRequest QML Type
Demande d'affichage d'un menu contextuel. Plus d'informations...
| Import Statement: | import QtWebEngine |
| Since: | QtWebEngine 1.4 |
Propriétés
- 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
Description détaillée
Un ContextMenuRequest est transmis en tant qu'argument du signal WebEngineView::contextMenuRequested. Il fournit des informations supplémentaires sur le contexte de la demande. La propriété position indique l'origine de la demande.
La propriété accepted de la demande indique si la demande est traitée par le code utilisateur ou si le menu contextuel par défaut doit être affiché.
Le code suivant utilise un menu personnalisé pour traiter la demande :
WebEngineView { id: view // ... onContextMenuRequested: function(request) { request.accepted = true; myMenu.x = request.x; myMenu.y = request.y; myMenu.trigger.connect(view.triggerWebAction); myMenu.popup(); } // ... }
Propriété Documentation
accepted : bool
Indique si la demande de menu contextuel a été traitée par le gestionnaire de signal.
Si la propriété est false après l'exécution de tout gestionnaire de signal pour WebEngineView::contextMenuRequested, un menu contextuel par défaut sera affiché. Pour éviter cela, définissez request.accepted comme étant true.
La valeur par défaut est false.
Remarque : le contenu par défaut du menu contextuel dépend de l'élément web pour lequel la demande a été générée.
editFlags : flags [read-only, since QtWebEngine 1.7]
Les opérations d'édition disponibles dans le contexte actuel ou CanDoNone si aucune action n'est disponible.
| Constante | Description |
|---|---|
ContextMenuRequest.CanUndo | L'annulation est disponible. |
ContextMenuRequest.CanRedo | Rétablir est disponible. |
ContextMenuRequest.CanCut | Couper est disponible. |
ContextMenuRequest.CanCopy | Copier est disponible. |
ContextMenuRequest.CanPaste | Coller est disponible. |
ContextMenuRequest.CanDelete | La fonction Supprimer est disponible. |
ContextMenuRequest.CanSelectAll | Sélectionner tout est disponible. |
ContextMenuRequest.CanTranslate | Traduire est disponible. |
ContextMenuRequest.CanEditRichly | Le contexte est richement modifiable. |
Cette propriété a été introduite dans QtWebEngine 1.7.
isContentEditable : bool [read-only]
Indique si le contenu web sélectionné est modifiable.
linkText : string [read-only]
Le texte du lien, si le menu contextuel a été demandé pour un lien.
linkUrl : url [read-only]
L'URL du lien, si le contenu de la page web sélectionnée est un lien. Il n'est pas garanti qu'il s'agisse d'une URL valide.
mediaFlags : flags [read-only, since QtWebEngine 1.7]
Statut de l'élément multimédia actuel et opérations disponibles. MediaNone si le contenu de la page web sélectionnée n'est pas un élément multimédia.
| Constante | Description de l'erreur |
|---|---|
ContextMenuRequest.MediaInError | Une erreur s'est produite. |
ContextMenuRequest.MediaPaused | Le média est en pause. |
ContextMenuRequest.MediaMuted | Le média est en sourdine. |
ContextMenuRequest.MediaLoop | Le média peut être mis en boucle. |
ContextMenuRequest.MediaCanSave | Le média peut être sauvegardé. |
ContextMenuRequest.MediaHasAudio | Le média a du son. |
ContextMenuRequest.MediaCanToggleControls | Le média peut afficher des commandes. |
ContextMenuRequest.MediaControls | Les commandes du média sont affichées. |
ContextMenuRequest.MediaCanPrint | Le média est imprimable. |
ContextMenuRequest.MediaCanRotate | Le média est rotatif. |
Cette propriété a été introduite dans QtWebEngine 1.7.
mediaType : enumeration [read-only]
Le type de l'élément multimédia, ou MediaTypeNone si le contenu de la page web sélectionnée n'est pas un élément multimédia.
| Constante | Description |
|---|---|
ContextMenuRequest.MediaTypeNone | Pas un média. |
ContextMenuRequest.MediaTypeImage | Une image. |
ContextMenuRequest.MediaTypeVideo | Une vidéo. |
ContextMenuRequest.MediaTypeAudio | Un élément audio. |
ContextMenuRequest.MediaTypeCanvas | Une toile. |
ContextMenuRequest.MediaTypeFile | Un fichier. |
ContextMenuRequest.MediaTypePlugin | Un plugin. |
mediaUrl : url [read-only]
L'URL du média, si le contenu web sélectionné est un élément média.
misspelledWord : string [read-only]
Si le contexte est un mot considéré comme mal orthographié par le correcteur orthographique, il renvoie le mot mal orthographié.
position : point [read-only]
Position de l'action de l'utilisateur à l'origine de la demande de menu contextuel.
selectedText : string [read-only]
Le texte sélectionné pour lequel le menu contextuel a été créé.
spellCheckerSuggestions : stringlist [read-only]
Si le contexte est un mot considéré comme mal orthographié par le correcteur d'orthographe, il renvoie une liste de suggestions de remplacement.
© 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.