內容

• 特性
• 附加特性
• 方法
• 詳細描述

ObjectModel QML 類型

定義要用作模型的一組項 更多...

import 語句：

import QtQml.Models 2.2

• 所有成員列錶，包括繼承成員

特性

• count : int

附加特性

• index : int

方法

• void append (object item )
• void clear ()
• 對象 get (int index )
• void insert (int index , object item )
• void move (int from , int to , int n )
• void remove (int index , int n )

詳細描述

An ObjectModel contains the visual items to be used in a view. When an ObjectModel is used in a view, the view does not require a delegate since the ObjectModel already contains the visual delegate (items).

An item can determine its index within the model via the index 附加特性。

The example below places three colored rectangles in a ListView .

import QtQuick 2.0
import QtQml.Models 2.1
Rectangle {
    ObjectModel {
        id: itemModel
        Rectangle { height: 30; width: 80; color: "red" }
        Rectangle { height: 30; width: 80; color: "green" }
        Rectangle { height: 30; width: 80; color: "blue" }
    }
    ListView {
        anchors.fill: parent
        model: itemModel
    }
}
					

另請參閱 Qt Quick 範例 - 視圖 .

特性文檔編製

count : int

The number of items in the model. This property is readonly.

附加特性文檔編製

ObjectModel.index : int

This attached property holds the index of this delegate's item within the model.

It is attached to each instance of the delegate.

方法文檔編製

void append ( object item )

Appends a new item to the end of the model.

objectModel.append(objectComponent.createObject())
								

This QML method was introduced in Qt 5.6.

另請參閱 insert() and remove() .

void clear ()

Clears all items from the model.

This QML method was introduced in Qt 5.6.

另請參閱 append() and remove() .

對象 get ( int index )

返迴項在 index in the model. This allows the item to be accessed or modified from JavaScript:

Component.onCompleted: {
    objectModel.append(objectComponent.createObject())
    console.log(objectModel.get(0).objectName);
    objectModel.get(0).objectName = "first";
}
										

The index must be an element in the list.

This QML method was introduced in Qt 5.6.

另請參閱 append() .

void insert ( int index , object item )

Inserts a new item to the model at position index .

objectModel.insert(2, objectComponent.createObject())
											

The index must be to an existing item in the list, or one past the end of the list (equivalent to append).

This QML method was introduced in Qt 5.6.

另請參閱 append() and remove() .

void move ( int from , int to , int n = 1)

移動 n 項 from one position to another.

The from and to ranges must exist; for example, to move the first 3 items to the end of the model:

objectModel.move(0, objectModel.count - 3, 3)
												

This QML method was introduced in Qt 5.6.

另請參閱 append() .

void remove ( int index , int n = 1)

Removes the items at index 來自模型。

This QML method was introduced in Qt 5.6.

另請參閱 clear() .