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.