Qt Reference Documentation

QML AnchorChanges Element

The AnchorChanges element allows you to change the anchors of an item in a state. More...

  • List of all members, including inherited members
  • Properties

    Detailed Description

    The AnchorChanges element is used to modify the anchors of an item in a State.

    AnchorChanges cannot be used to modify the margins on an item. For this, use PropertyChanges intead.

    In the following example we change the top and bottom anchors of an item using AnchorChanges, and the top and bottom anchor margins using PropertyChanges:

     import Qt 4.7
     Rectangle {
         id: window
         width: 120; height: 120
         color: "black"
         Rectangle { id: myRect; width: 50; height: 50; color: "red" }
         states: State {
             name: "reanchored"
             AnchorChanges {
                 target: myRect
                 anchors.top: window.top
                 anchors.bottom: window.bottom
             PropertyChanges {
                 target: myRect
                 anchors.topMargin: 10
                 anchors.bottomMargin: 10
         MouseArea { anchors.fill: parent; onClicked: window.state = "reanchored" }

    AnchorChanges can be animated using AnchorAnimation.

     //animate our anchor changes
     Transition {
         AnchorAnimation {}

    Margin animations can be animated using NumberAnimation.

    For more information on anchors see Anchor Layouts.

    Property Documentation

    anchors.left : AnchorLine

    anchors.right : AnchorLine

    anchors.horizontalCenter : AnchorLine

    anchors.top : AnchorLine

    anchors.bottom : AnchorLine

    anchors.verticalCenter : AnchorLine

    anchors.baseline : AnchorLine

    These properties change the respective anchors of the item.

    To reset an anchor you can assign undefined:

     AnchorChanges {
         target: myItem
         anchors.left: undefined          //remove myItem's left anchor
         anchors.right: otherItem.right

    target : Item

    This property holds the Item for which the anchor changes will be applied.


    Thank you for giving your feedback.

    Make sure it is related to this specific page. For more general bugs and requests, please use the Qt Bug Tracker.

    [0]; s.parentNode.insertBefore(ga, s); })();