Qt Reference Documentation

QML Package Element

Package provides a collection of named items. More...

  • List of all members, including inherited members
  • Attached Properties

    Detailed Description

    The Package class is used in conjunction with VisualDataModel to enable delegates with a shared context to be provided to multiple views.

    Any item within a Package may be assigned a name via the Package.name attached property.

    The example below creates a Package containing two named items; list and grid. The third element in the package (the Rectangle) is parented to whichever delegate it should appear in. This allows an item to move between views.

     Package {
         Text { id: listDelegate; width: 200; height: 25; text: 'Empty'; Package.name: 'list' }
         Text { id: gridDelegate; width: 100; height: 50; text: 'Empty'; Package.name: 'grid' }
         Rectangle {
             id: wrapper
             width: 200; height: 25
             color: 'lightsteelblue'
             Text { text: display; anchors.centerIn: parent }
             MouseArea {
                 anchors.fill: parent
                 onClicked: {
                     if (wrapper.state == 'inList')
                         wrapper.state = 'inGrid';
                         wrapper.state = 'inList';
             state: 'inList'
             states: [
                 State {
                     name: 'inList'
                     ParentChange { target: wrapper; parent: listDelegate }
                 State {
                     name: 'inGrid'
                     ParentChange {
                         target: wrapper; parent: gridDelegate
                         x: 0; y: 0; width: gridDelegate.width; height: gridDelegate.height
             transitions: [
                 Transition {
                     ParentAnimation {
                         NumberAnimation { properties: 'x,y,width,height'; duration: 300 }

    These named items are used as the delegates by the two views who reference the special VisualDataModel::parts property to select a model which provides the chosen delegate.

         VisualDataModel {
             id: visualModel
             delegate: Delegate {}
             model: myModel
         ListView {
             width: 200; height:200
             model: visualModel.parts.list
         GridView {
             x: 200; width: 200; height:200
             cellHeight: 50
             model: visualModel.parts.grid

    See also Package example, Photo Viewer demo, and QtDeclarative.

    Attached Property Documentation

    Package.name : string

    This attached property holds the name of an item within a Package.


    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); })();