Sur cette page

rect QML Value Type

une valeur comportant les attributs x, y, width et height. En savoir plus...

Import Statement: import QtQml

Description détaillée

Le type « rect » fait référence à une valeur comportant les attributs « x », « y », « width » et « height ».

Les propriétés de type « rect » sont définies par défaut à « Qt.rect(0, 0, 0, 0) ». Il s’agit d’un rectangle vide situé à l’origine des coordonnées.

Par exemple, pour lire les valeurs « width » et « height » de la propriété de type rect « Item » ( childrenRect ) :

Rectangle {
    width: childrenRect.width
    height: childrenRect.height

    Rectangle { width: 100; height: 100 }
}

Pour créer une valeur rect, spécifiez-la sous la forme d’une chaîne « x, y, largeur x hauteur » :

CustomObject { myRectProperty: "50,50,100x100" }

Ou utilisez la fonction ` Qt.rect()` :

CustomObject { myRectProperty: Qt.rect(50, 50, 100, 100) }

Le type ` rect ` expose également des attributs en lecture seule : ` left`, ` right`, ` top ` et ` bottom `. Ceux-ci sont identiques à leurs équivalents dans ` C++ counterparts`.

Lors de l’intégration avec C++, notez que toute valeur de type ` QRect ` ou ` QRectF ` transmise à QML depuis C++ est automatiquement convertie en valeur de type ` rect `, et inversement. Lorsqu’une valeur de type ` rect ` est transmise à C++, elle est automatiquement convertie en valeur de type ` QRectF `.

Voir également Types de valeurs QML.

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