QWebHitTestResult Class

The QWebHitTestResult class provides information about the web page content after a hit test. More...

Header: #include <QWebHitTestResult>
qmake: QT += webkitwidgets
Since: Qt 4.4

Public Functions

QWebHitTestResult()
QWebHitTestResult(const QWebHitTestResult &other)
~QWebHitTestResult()
QString alternateText() const
QRect boundingRect() const
QWebElement element() const
QWebElement enclosingBlockElement() const
QWebFrame *frame() const
QUrl imageUrl() const
bool isContentEditable() const
bool isContentSelected() const
bool isNull() const
QWebElement linkElement() const
QWebFrame *linkTargetFrame() const
QString linkText() const
QString linkTitleString() const
QUrl linkUrl() const
QUrl mediaUrl() const
QPixmap pixmap() const
QPoint pos() const
QString title() const
QWebHitTestResult &operator=(const QWebHitTestResult &other)

Detailed Description

The QWebHitTestResult class provides information about the web page content after a hit test.

QWebHitTestResult is returned by QWebFrame::hitTestContent() to provide information about the content of the web page at the specified position.

Member Function Documentation

QWebHitTestResult::QWebHitTestResult()

Constructs a null hit test result.

QWebHitTestResult::QWebHitTestResult(const QWebHitTestResult &other)

Constructs a hit test result from other.

QWebHitTestResult::~QWebHitTestResult()

Destructor.

QString QWebHitTestResult::alternateText() const

Returns the alternate text of the element. This corresponds to the HTML alt attribute.

QRect QWebHitTestResult::boundingRect() const

Returns the bounding rect of the element.

This function was introduced in Qt 4.5.

QWebElement QWebHitTestResult::element() const

Returns the underlying DOM element as QWebElement.

This function was introduced in Qt 4.6.

QWebElement QWebHitTestResult::enclosingBlockElement() const

Returns the block element that encloses the element hit.

A block element is an element that is rendered using the CSS "block" style. This includes for example text paragraphs.

This function was introduced in Qt 4.6.

QWebFrame *QWebHitTestResult::frame() const

Returns the frame of the element hit.

QUrl QWebHitTestResult::imageUrl() const

Returns the url of the image.

bool QWebHitTestResult::isContentEditable() const

Returns true if the content is editable by the user; otherwise returns false.

bool QWebHitTestResult::isContentSelected() const

Returns true if the content tested is part of the selection; otherwise returns false.

bool QWebHitTestResult::isNull() const

Returns true if the hit test result is null; otherwise returns false.

QWebElement QWebHitTestResult::linkElement() const

Returns the element that represents the link.

This function was introduced in Qt 4.6.

See also linkTargetFrame().

QWebFrame *QWebHitTestResult::linkTargetFrame() const

Returns the frame that will load the link if it is activated.

See also linkElement().

QString QWebHitTestResult::linkText() const

Returns the text of the link.

QString QWebHitTestResult::linkTitleString() const

Returns the title of the link.

This function was introduced in Qt 5.5.

QUrl QWebHitTestResult::linkUrl() const

Returns the url to which the link points to.

QUrl QWebHitTestResult::mediaUrl() const

Returns the url of the video or audio element.

This function was introduced in Qt 5.2.

QPixmap QWebHitTestResult::pixmap() const

Returns a QPixmap containing the image. A null pixmap is returned if the element being tested is not an image.

QPoint QWebHitTestResult::pos() const

Returns the position where the hit test occured in the coordinates of frame containing the element hit.

See also frame().

QString QWebHitTestResult::title() const

Returns the title of the nearest enclosing HTML element.

QWebHitTestResult &QWebHitTestResult::operator=(const QWebHitTestResult &other)

Assigns the other hit test result to this.