Qt Reference Documentation

# QWebElementCollection Class Reference

The QWebElementCollection class represents a collection of web elements. More...

     #include <QWebElementCollection>

This class is under development and is subject to change.

This class was introduced in Qt 4.6.

- List of all members, including inherited members

## Public Types

class | const_iterator
class | iterator

## Public Functions

| QWebElementCollection ()
| QWebElementCollection ( const QWebElement & contextElement, const QString & query )
| QWebElementCollection ( const QWebElementCollection & other )
| ~QWebElementCollection ()
void | append ( const QWebElementCollection & other )
QWebElement | at ( int i ) const
const_iterator | begin () const
iterator | begin ()
const_iterator | constBegin () const
const_iterator | constEnd () const
int | count () const
const_iterator | end () const
iterator | end ()
QWebElement | first () const
QWebElement | last () const
QList<QWebElement> | toList () const
QWebElementCollection | operator+ ( const QWebElementCollection & other ) const
QWebElementCollection & | operator+= ( const QWebElementCollection & other )
QWebElementCollection & | operator= ( const QWebElementCollection & other )
QWebElement | operator[] ( int position ) const

## Detailed Description

The QWebElementCollection class represents a collection of web elements.

Elements in a document can be selected using QWebElement::findAll() or using the QWebElement 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 the count() property. Individual elements can be retrieved by index using at().

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 ( const QWebElement & contextElement, const QString & query )

Constructs a collection of elements from the list of child elements of contextElement that match the specified CSS selector query.

### QWebElementCollection::QWebElementCollection ( const QWebElementCollection & other )

Constructs a copy of other.

### QWebElementCollection::~QWebElementCollection ()

Destroys the collection.

### void QWebElementCollection::append ( const QWebElementCollection & other )

Extends the collection by appending all items of other.

The resulting collection may include duplicate elements.

See also operator+=().

### QWebElement QWebElementCollection::at ( int i ) const

Returns the element at index position i in the collection.

### const_iterator QWebElementCollection::begin () const

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

See also end().

### iterator QWebElementCollection::begin ()

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

See also end().

### const_iterator QWebElementCollection::constBegin () const

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

See also end().

### const_iterator QWebElementCollection::constEnd () const

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

See also begin().

### 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 also begin().

### iterator QWebElementCollection::end ()

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

See also begin().

### QWebElement QWebElementCollection::first () const

Returns the first element in the collection.

See also last(), operator[](), at(), and count().

### QWebElement QWebElementCollection::last () const

Returns the last element in the collection.

See also first(), operator[](), at(), and count().

### QList<QWebElement> QWebElementCollection::toList () const

Returns a QList object with the elements contained in this collection.

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

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

See also operator+=().

### QWebElementCollection & QWebElementCollection::operator+= ( const QWebElementCollection & other )

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

See also operator+() and append().

### QWebElementCollection & QWebElementCollection::operator= ( const QWebElementCollection & other )

Assigns other to this collection and returns a reference to this collection.

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

Returns the element at the specified position in the collection.