Sur cette page

PdfSelection QML Type

Représentation d'une sélection de texte dans un document PDF. Plus d'informations...

Import Statement: import QtQuick.Pdf
Inherits:

Item

Propriétés

Méthodes

Description détaillée

PdfSelection fournit la chaîne de texte et sa géométrie dans une boîte de délimitation d'un point à un autre.

Pour modifier la sélection à l'aide de la souris, liez from et to aux propriétés appropriées d'un gestionnaire d'entrée afin qu'elles soient définies aux positions où le geste de glisser commence et se termine, respectivement ; et liez la propriété hold afin qu'elle soit définie à true pendant le geste de glisser et à false lorsque le geste se termine.

PdfSelection gère également directement les requêtes de méthode d'entrée afin que les poignées de sélection de texte puissent être utilisées sur des plates-formes telles que iOS. Pour ce faire, elle doit avoir le focus clavier.

Documentation sur les propriétés

document : PdfDocument

Cette propriété contient le document PDF dans lequel le texte doit être sélectionné.

from : point

L'emplacement de départ, en pixels à partir du coin supérieur gauche de la page, à partir duquel le texte sélectionné doit être trouvé. Cette valeur peut être liée à l'adresse centroid.pressPosition d'un site DragHandler pour commencer à sélectionner le texte à partir de l'endroit où l'utilisateur appuie sur le bouton de la souris et commence à faire glisser la souris, par exemple.

geometry : list<list<point>>

Un ensemble de chemins dans un formulaire qui peut être lié à la propriété paths d'une instance PathMultiline pour rendre un lot de rectangles autour des zones de texte qui sont incluses dans la sélection :

PdfDocument {
    id: doc
}
PdfSelection {
    id: selection
    document: doc
    from: textSelectionDrag.centroid.pressPosition
    to: textSelectionDrag.centroid.position
    hold: !textSelectionDrag.active
}
Shape {
    ShapePath {
        PathMultiline {
            paths: selection.geometry
        }
    }
}
DragHandler {
    id: textSelectionDrag
    acceptedDevices: PointerDevice.Mouse | PointerDevice.Stylus
    target: null
}

Voir également PathMultiline.

hold : bool

Contrôle si la sélection existante doit être conservée indépendamment des modifications apportées à from et to. Cette propriété peut être définie sur true lorsque la souris ou le point de contact est relâché, afin que la sélection ne soit pas perdue en raison de la modification des liaisons de points.

page : int

Le numéro de la page sur laquelle la recherche doit être effectuée.

Voir aussi QtQuick::Image::currentFrame.

renderScale : real

Le rapport entre les points et les pixels dans lequel la page est rendue.

Il est utilisé pour mettre à l'échelle from et to afin de trouver des plages de caractères sélectionnés dans le document, car les positions dans le document sont toujours données en points.

text : string

Le texte trouvé dans la zone rectangulaire entre from et to, ou tout le texte sur page si selectAll() a été appelé.

to : point

L'emplacement final, en pixels à partir du coin supérieur gauche de la page, à partir duquel le texte sélectionné doit être trouvé. Il peut être lié à l'adresse centroid.position d'un site DragHandler pour terminer la sélection du texte à l'endroit où l'utilisateur fait glisser la souris, par exemple.

Documentation de la méthode

void clear()

Efface la sélection en cours.

void copyToClipboard()

Copie le texte en clair de la propriété text dans le presse-papiers du système.

void selectAll()

Sélectionne tout le texte sur le site page.

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