Qt 4.7: QWebHitTestResult Class Reference

Qt Reference Documentation

# QWebHitTestResult Class Reference

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

     #include <QWebHitTestResult>

This class was introduced in Qt 4.4.

- List of all members, including inherited members

## 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
QUrl | linkTitle () const
QUrl | linkUrl () 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 the hit test was executed in.

### 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.

### QUrl QWebHitTestResult::linkTitle () const

Returns the title of the link.

### QUrl QWebHitTestResult::linkUrl () const

Returns the url to which the link points to.

### 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.

### 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.