RectangleShape QML Type

Un rectangle rempli, avec une bordure facultative. En savoir plus...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• bevel : bool
• borderMode : enumeration
• bottomLeftBevel : bool
• bottomLeftRadius : real
• bottomRightBevel : bool
• bottomRightRadius : real
• capStyle : enumeration
• dashOffset : real
• dashPattern : list<real>
• drawBottom : bool (since 6.11)
• drawLeft : bool (since 6.11)
• drawRight : bool (since 6.11)
• drawTop : bool (since 6.11)
• fillColor : color
• fillGradient : ShapeGradient
• fillRule : enumeration
• joinStyle : enumeration
• radius : real
• strokeColor : color
• strokeStyle : enumeration
• strokeWidth : real
• topLeftBevel : bool
• topLeftRadius : real
• topRightBevel : bool
• topRightRadius : real

Description détaillée

RectangleShape sert à remplir des zones avec une couleur unie ou des dégradés et à créer une bordure rectangulaire.

Chaque élément Rectangle est tracé soit avec une couleur de remplissage unie, spécifiée à l’aide de la propriété ` fillColor `, soit avec un dégradé, défini à l’aide de l’un des sous-types ` ShapeGradient ` et configuré à l’aide de la propriété `gradient`. Si une couleur et un dégradé sont tous deux spécifiés, c’est le dégradé qui est utilisé.

Une bordure facultative peut être ajoutée à un rectangle avec sa propre couleur et son propre épaisseur en définissant les propriétés ` strokeColor ` et ` strokeWidth `. Définir la couleur sur ` transparent ` crée une bordure sans couleur de remplissage.

Il est possible de dessiner des rectangles arrondis à l’aide de la propriété « radius ». Le rayon peut également être spécifié séparément pour chaque coin. De plus, la propriété « bevel » peut être appliquée à n’importe quel coin pour le couper net.

La valeur par défaut de la propriété ` QtQuick.Shapes::Shape::preferredRendererType ` de `RectangleShape` est ` Shape.CurveRenderer`.

Exemple d'utilisation

    RectangleShape {
        id: rectangleShape
        anchors.centerIn: parent
        radius: 0
        topLeftRadius: 30
        bottomRightRadius: 30
        bevel: true
        joinStyle: ShapePath.MiterJoin
        fillColor: "#3ad23c"
        strokeColor: "transparent"
        visible: false
    }

Documentation de la propriété

bevel : bool

Cette propriété détermine si les coins du rectangle sont biseautés.

Si vous la définissez sur « false », les coins seront soit vifs, soit arrondis, selon les valeurs attribuées aux différentes propriétés « radius ».

Cette propriété peut être remplacée par les propriétés « bevel » individuelles.

    RectangleShape {
        id: rectangleShape
        anchors.centerIn: parent
        radius: 0
        topLeftRadius: 30
        bottomRightRadius: 30
        bevel: true
        joinStyle: ShapePath.MiterJoin
        fillColor: "#3ad23c"
        strokeColor: "transparent"
        visible: false
    }

Voir également « topLeftBevel », « topRightBevel », « bottomLeftBevel » et « bottomRightBevel ».

borderMode : enumeration

La propriété borderMode détermine l'emplacement où la bordure est tracée le long du bord du rectangle.

Il s'agit de la valeur par défaut.

Voir également strokeWidth.

Si elles sont définies, ces propriétés déterminent le biseautage de chaque coin. En leur attribuant la valeur « false », on obtient soit des coins pointus, soit des coins arrondis, selon les valeurs attribuées aux différentes propriétés « radius ». En leur attribuant la valeur « true », on obtient des coins biseautés. Si elles ne sont pas définies, c’est la valeur de « bevel » qui est utilisée à la place.

Ces propriétés sont désactivées par défaut. Attribuez-leur la valeur « undefined » pour les ramener à leur état d’origine.

Dans l’exemple suivant, la propriété bottomRightBevel est définie sur true :

    RectangleShape {
        id: rectangleShape
        anchors.centerIn: parent
        topLeftRadius: 0
        bottomRightBevel: true
        joinStyle: ShapePath.MiterJoin
    }

Voir également bevel.

Si elles sont définies, ces propriétés déterminent les rayons de chaque coin. Une valeur nulle indique que le coin est vif, tandis qu’une valeur positive indique qu’il est arrondi. Si elles ne sont pas définies, c’est la valeur de ` radius ` qui est utilisée à la place.

Ces propriétés sont désactivées par défaut. Attribuez-leur la valeur « undefined » pour les ramener à leur état initial.

Dans l'exemple suivant, ` radius ` est défini sur ` 10` et ` topLeftRadius ` sur ` 0` :

    RectangleShape {
        id: rectangleShape
        anchors.centerIn: parent
        topLeftRadius: 0
        bottomRightBevel: true
        joinStyle: ShapePath.MiterJoin
    }

Voir également radius.

capStyle : enumeration

Cette propriété définit la manière dont les extrémités des lignes sont dessinées. La valeur par défaut est « ShapePath.SquareCap ».

dashOffset : real

Cette propriété définit le point de départ du motif de tirets, mesuré dans les unités utilisées pour spécifier ce motif.

La valeur par défaut est 0.

Voir également QPen::setDashOffset().

dashPattern : list<real>

Cette propriété définit le motif de tirets lorsque la propriété « strokeStyle » est définie sur « ShapePath.DashLine ». Le motif doit être spécifié sous la forme d’un nombre pair d’entrées positives, où les entrées 1, 3, 5… correspondent aux tirets et les entrées 2, 4, 6… aux espaces. Le motif est spécifié en unités correspondant à la largeur du stylo.

La valeur par défaut est (4, 2), ce qui correspond à un trait de 4 * strokeWidth pixels suivi d’un espace de 2 * strokeWidth pixels.

Voir également QPen::setDashPattern().

drawBottom : bool [since 6.11]

Cette propriété détermine si la bordure inférieure est affichée.

La valeur par défaut est « true ».

Cette propriété a été introduite dans Qt 6.11.

drawLeft : bool [since 6.11]

Cette propriété détermine si la bordure gauche est affichée.

La valeur par défaut est « true ».

Cette propriété a été introduite dans Qt 6.11.

drawRight : bool [since 6.11]

Cette propriété détermine si la bordure droite est affichée.

La valeur par défaut est « true ».

Cette propriété a été introduite dans Qt 6.11.

drawTop : bool [since 6.11]

Cette propriété détermine si la bordure supérieure est affichée.

La valeur par défaut est « true ».

Cette propriété a été introduite dans Qt 6.11.

fillColor : color

Cette propriété définit la couleur de remplissage.

Lorsqu'elle est définie sur « transparent », aucun remplissage n'est appliqué.

La valeur par défaut est « "white" ».

fillGradient : ShapeGradient

Le « fillGradient » de la couleur de remplissage du rectangle.

Par défaut, aucun fillGradient n'est activé et la valeur est nulle. Dans ce cas, le remplissage utilise une couleur unie basée sur la valeur de fillColor.

Lorsqu’il est défini, ` fillColor ` est ignoré et le remplissage s’effectue à l’aide de l’un des sous-types de ` ShapeGradient `.

fillRule : enumeration

Cette propriété définit la règle de remplissage. La valeur par défaut est « ShapePath.OddEvenFill ». Pour plus d'informations sur les règles de remplissage, consultez QPainterPath::setFillRule().

joinStyle : enumeration

Cette propriété définit la manière dont sont tracées les jonctions entre deux lignes reliées. La valeur par défaut est « ShapePath.BevelJoin ».

radius : real

Cette propriété définit le rayon des coins utilisé pour définir un rectangle arrondi.

Si la valeur de radius est positive, le tracé du rectangle sera défini comme un rectangle arrondi ; dans le cas contraire, il sera défini comme un rectangle normal.

Cette propriété peut être remplacée par les propriétés individuelles de rayon des coins.

La valeur par défaut est 10.

Voir également topLeftRadius, topRightRadius, bottomLeftRadius et bottomRightRadius.

strokeColor : color

Cette propriété définit la couleur du contour.

Lorsqu'elle est définie sur « transparent », aucun trait n'est tracé.

La valeur par défaut est « "black" ».

strokeStyle : enumeration

Cette propriété définit le style du trait. La valeur par défaut est ShapePath.SolidLine.

strokeWidth : real

Cette propriété définit la largeur du trait.

Lorsqu'elle est définie sur une valeur négative, aucun trait n'est tracé.

La valeur par défaut est 1.