rect QML Value Type | Qt QML 6.8.0
Description: a value with x, y, width and height attributes.

- Qt 6.8
- Qt QML
- QML Types
- rect
- Qt 6.8.0 Reference Documentation

# rect QML Value Type

a value with x, y, width and height attributes. More...

## Detailed Description

The `rect` type refers to a value with `x`, `y`, `width` and `height` attributes.

Properties of type `rect` are `Qt.rect(0, 0, 0, 0)` by default. This is an empty rectangle at the coordinate origin.

For example, to read the `width` and `height` values of the Item childrenRect rect-type property:

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

         Rectangle { width: 100; height: 100 }
     }

To create a `rect` value, specify it as a "x, y, width x height" string:

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

Or use the Qt.rect() function:

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

The `rect` type also exposes read-only `left`, `right`, `top` and `bottom` attributes. These are the same as their C++ counterparts.

When integrating with C++, note that any QRect or QRectF value passed into QML from C++ is automatically converted into a `rect` value, and vice-versa. When a `rect` value is passed to C++, it is automatically converted into a QRectF value.

See also QML Value Types.