QWebElementCollection Class
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 QtWebKit 4.6.
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.