Contents

• Public Types
• Public Functions
• Detailed Description

Detailed Description

TheQWebElementCollection class represents a collection of web elements.

Elements in a document can be selected usingQWebElement::findAll() or using theQWebElement constructor. The collection is composed by choosing all elements in the document that match a specified CSS selector expression.

The number of selected elements is provided through thecount() property. Individual elements can be retrieved by index usingat().

It is also possible to iterate through all elements in the collection using Qt's foreach macro:

QWebElementCollection collection= document.findAll("p");foreach (QWebElement paraElement, collection) {...}

Member Function Documentation

QWebElementCollection::QWebElementCollection()

Constructs an empty collection.

QWebElementCollection::QWebElementCollection(constQWebElement & contextElement, constQString & query)

Constructs a collection of elements from the list of child elements ofcontextElement that match the specified CSS selectorquery.

QWebElementCollection::QWebElementCollection(constQWebElementCollection & other)

Constructs a copy ofother.

QWebElementCollection::~QWebElementCollection()

Destroys the collection.

void QWebElementCollection::append(constQWebElementCollection & other)

Extends the collection by appending all items ofother.

The resulting collection may include duplicate elements.

See alsooperator+=().

QWebElement QWebElementCollection::at(int i) const

Returns the element at index positioni in the collection.

const_iterator QWebElementCollection::begin() const

Returns an STL-style iterator pointing to the first element in the collection.

See alsoend().

iterator QWebElementCollection::begin()

Returns an STL-style iterator pointing to the first element in the collection.

See alsoend().

const_iterator QWebElementCollection::constBegin() const

Returns an STL-style iterator pointing to the first element in the collection.

See alsoend().

const_iterator QWebElementCollection::constEnd() const

Returns an STL-style iterator pointing to the imaginary element after the last element in the list.

See alsobegin().

int QWebElementCollection::count() const

Returns the number of elements in the collection.

const_iterator QWebElementCollection::end() const

Returns an STL-style iterator pointing to the imaginary element after the last element in the list.

See alsobegin().

iterator QWebElementCollection::end()

Returns an STL-style iterator pointing to the imaginary element after the last element in the list.

See alsobegin().

QWebElement QWebElementCollection::first() const

Returns the first element in the collection.

See alsolast(),operator[](),at(), andcount().

QWebElement QWebElementCollection::last() const

Returns the last element in the collection.

See alsofirst(),operator[](),at(), andcount().

QList<QWebElement> QWebElementCollection::toList() const

Returns aQList object with the elements contained in this collection.

QWebElementCollection QWebElementCollection::operator+(constQWebElementCollection & other) const

Returns a collection that contains all the elements of this collection followed by all the elements in theother collection. Duplicates may occur in the result.

See alsooperator+=().

QWebElementCollection & QWebElementCollection::operator+=(constQWebElementCollection & other)

Appends the items of theother list to this list and returns a reference to this list.

See alsooperator+() andappend().

QWebElementCollection & QWebElementCollection::operator=(constQWebElementCollection & other)

Assignsother to this collection and returns a reference to this collection.

QWebElement QWebElementCollection::operator[](int position) const

Returns the element at the specifiedposition in the collection.