QDeclarativeDomList Class Reference

The QDeclarativeDomList class represents a list of values assigned to a QML property. More...

#include <qdeclarativedom_p.h>

Public Functions
QList< int >	commaPositions () const
	Returns a list of positions of the commas in the QML file. More...
int	length () const
	Returns the length in the input data from where the list started upto the end of it, or 0 if the property is invalid. More...
QDeclarativeDomList &	operator= (const QDeclarativeDomList &)
	Assign other to this QDeclarativeDomList. More...
int	position () const
	Returns the position in the input data where the list started, or -1 if the property is invalid. More...
	QDeclarativeDomList ()
	Construct an empty QDeclarativeDomList. More...
	QDeclarativeDomList (const QDeclarativeDomList &)
	Create a copy of other QDeclarativeDomList. More...
QList< QDeclarativeDomValue >	values () const
	Returns the list of QDeclarativeDomValue's. More...
	~QDeclarativeDomList ()
	Destroy the QDeclarativeDomList. More...

Properties
QSharedDataPointer< QDeclarativeDomValuePrivate >	d

Friends
class	QDeclarativeDomValue

Detailed Description

The QDeclarativeDomList class represents a list of values assigned to a QML property.

Warning

This function is not part of the public interface.

Lists of values can be assigned to properties.  For example, the following
example assigns multiple objects to Item's "children" property

Item {
    children: [
        Text { },
        Rectangle { }
    ]
}

Lists can also be implicitly created by assigning multiple QDeclarativeDomValueValueSource{value sources} or constants to a property.

Item {
    x: 10
    x: NumberAnimation {
        running: false
        from: 0
        to: 100
    }
}

Definition at line 317 of file qdeclarativedom_p.h.

Constructors and Destructors

QDeclarativeDomList() [1/2]

QDeclarativeDomList::QDeclarativeDomList

(

)

Construct an empty QDeclarativeDomList.

Definition at line 1609 of file qdeclarativedom.cpp.

{
}

QDeclarativeDomList() [2/2]

QDeclarativeDomList::QDeclarativeDomList

(

const QDeclarativeDomList &

other

)

Create a copy of other QDeclarativeDomList.

Definition at line 1616 of file qdeclarativedom.cpp.

: d(other.d)
{
}

~QDeclarativeDomList()

QDeclarativeDomList::~QDeclarativeDomList

(

)

Destroy the QDeclarativeDomList.

Definition at line 1624 of file qdeclarativedom.cpp.

{
}

Functions

commaPositions()

QList< int > QDeclarativeDomList::commaPositions

(

)

const

Returns a list of positions of the commas in the QML file.

Definition at line 1690 of file qdeclarativedom.cpp.

{
    if (d && d->property)
        return d->property->listCommaPositions;
    else
        return QList<int>();
}

length()

int QDeclarativeDomList::length

(

)

const

Returns the length in the input data from where the list started upto the end of it, or 0 if the property is invalid.

Definition at line 1679 of file qdeclarativedom.cpp.

{
    if (d && d->property)
        return d->property->listValueRange.length;
    else
        return -1;
}

operator=()

QDeclarativeDomList & QDeclarativeDomList::operator=

(

const QDeclarativeDomList &

other

)

Assign other to this QDeclarativeDomList.

Definition at line 1631 of file qdeclarativedom.cpp.

{
    d = other.d;
    return *this;
}

position()

int QDeclarativeDomList::position

(

)

const

Returns the position in the input data where the list started, or -1 if the property is invalid.

Definition at line 1667 of file qdeclarativedom.cpp.

{
    if (d && d->property) {
        return d->property->listValueRange.offset;
    } else
        return -1;
}

values()

QList< QDeclarativeDomValue > QDeclarativeDomList::values

(

)

const

Returns the list of QDeclarativeDomValue's.

Definition at line 1640 of file qdeclarativedom.cpp.

{
    QList<QDeclarativeDomValue> rv;
    if (!d->property)
        return rv;

    for (int ii = 0; ii < d->property->values.count(); ++ii) {
        QDeclarativeDomValue v;
        v.d->value = d->property->values.at(ii);
        v.d->value->addref();
        rv << v;
    }

    for (int ii = 0; ii < d->property->onValues.count(); ++ii) {
        QDeclarativeDomValue v;
        v.d->value = d->property->onValues.at(ii);
        v.d->value->addref();
        rv << v;
    }

    return rv;
}

Friends and Related Functions

QDeclarativeDomValue

friend class QDeclarativeDomValue

friend

Definition at line 333 of file qdeclarativedom_p.h.

Properties

d

QSharedDataPointer<QDeclarativeDomValuePrivate> QDeclarativeDomList::d

private

Definition at line 334 of file qdeclarativedom_p.h.

Referenced by commaPositions(), length(), operator=(), position(), QDeclarativeDomValue::toList(), and values().

---

The documentation for this class was generated from the following files:

• /src/declarative/qml/qdeclarativedom_p.h
• /src/declarative/qml/qdeclarativedom.cpp