• Home
• Qt 6.8
• Qt Qml
• QML Types
• rect

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.