rect QML Basic Type

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

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 Basic Types.

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