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.

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