Home · All Classes · Main Classes · Grouped Classes · Modules · Functions

QWebPage Class Reference

The QWebPage class provides a widget that is used to view and edit web documents. More...

 #include <QWebPage>

Inherits QObject.

This class was introduced in Qt 4.4.

Public Types

Properties

Public Functions

Signals

Protected Functions

Additional Inherited Members


Detailed Description

The QWebPage class provides a widget that is used to view and edit web documents.

QWebPage holds a main frame responsible for web content, settings, the history of navigated links as well as actions. This class can be used, together with QWebFrame, if you want to provide functionality like QWebView in a setup without widgets.


Member Type Documentation

enum QWebPage::NavigationRequestResponse

enum QWebPage::NavigationType

enum QWebPage::WebAction

ConstantValueDescription
QWebPage::NoWebAction-1No action is triggered.
QWebPage::OpenLink0Open the current link.
QWebPage::OpenLinkInNewWindow1Open the current link in a new window.
QWebPage::OpenFrameInNewWindow2Replicate the current frame in a new window.
QWebPage::DownloadLinkToDisk3Download the current link to the disk.
QWebPage::CopyLinkToClipboard4Copy the current link to the clipboard.
QWebPage::OpenImageInNewWindow5Open the highlighted image in a new window.
QWebPage::DownloadImageToDisk6Download the highlighted image to the disk.
QWebPage::CopyImageToClipboard7Copy the highlighted image to the clipboard.
QWebPage::GoBack8Navigate back in the history of navigated links.
QWebPage::GoForward9Navigate forward in the history of navigated links.
QWebPage::Stop10Stop loading the current page.
QWebPage::Reload11Reload the current page.
QWebPage::Cut12Cut the content currently selected into the clipboard.
QWebPage::Copy13Copy the content currently selected into the clipboard.
QWebPage::Paste14Paste content from the clipboard.
QWebPage::Undo15Undo the last editing action.
QWebPage::Redo16Redo the last editing action.
QWebPage::MoveToNextChar17Move the cursor to the next character.
QWebPage::MoveToPreviousChar18Move the cursor to the previous character.
QWebPage::MoveToNextWord19Move the cursor to the next word.
QWebPage::MoveToPreviousWord20Move the cursor to the previous word.
QWebPage::MoveToNextLine21Move the cursor to the next line.
QWebPage::MoveToPreviousLine22Move the cursor to the previous line.
QWebPage::MoveToStartOfLine23Move the cursor to the start of the line.
QWebPage::MoveToEndOfLine24Move the cursor to the end of the line.
QWebPage::MoveToStartOfBlock25Move the cursor to the start of the block.
QWebPage::MoveToEndOfBlock26Move the cursor to the end of the block.
QWebPage::MoveToStartOfDocument27Move the cursor to the start of the document.
QWebPage::MoveToEndOfDocument28Move the cursor to the end of the document.
QWebPage::SelectNextChar29Select to the next character.
QWebPage::SelectPreviousChar30Select to the previous character.
QWebPage::SelectNextWord31Select to the next word.
QWebPage::SelectPreviousWord32Select to the previous word.
QWebPage::SelectNextLine33Select to the next line.
QWebPage::SelectPreviousLine34Select to the previous line.
QWebPage::SelectStartOfLine35Select to the start of the line.
QWebPage::SelectEndOfLine36Select to the end of the line.
QWebPage::SelectStartOfBlock37Select to the start of the block.
QWebPage::SelectEndOfBlock38Select to the end of the block.
QWebPage::SelectStartOfDocument39Select to the start of the document.
QWebPage::SelectEndOfDocument40Select to the end of the document.
QWebPage::DeleteStartOfWord41Delete to the start of the word.
QWebPage::DeleteEndOfWord42Delete to the end of the word.
QWebPage::SetTextDirectionDefault43Set the text direction to the default direction.
QWebPage::SetTextDirectionLeftToRight44Set the text direction to left-to-right.
QWebPage::SetTextDirectionRightToLeft45Set the text direction to right-to-left.
QWebPage::ToggleBold46Toggle the formatting between bold and normal weight.
QWebPage::ToggleItalic47Toggle the formatting between italic and normal style.
QWebPage::ToggleUnderline48Toggle underlining.
QWebPage::InspectElement49Show the Web Inspector with the currently highlighted HTML element.


Property Documentation

modified : const bool

Specifies if the page contains unsubmitted form data.

Access functions:

selectedText : const QString

Returns the text currently selected.

Access functions:

viewportSize : QSize

Specifies the size of the viewport. The size affects for example the visibility of scrollbars if the document is larger than the viewport.

Access functions:


Member Function Documentation

QWebPage::QWebPage ( QObject * parent = 0 )

Constructs an empty QWebView with parent parent.

QWebPage::~QWebPage ()

Destructor.

QAction * QWebPage::action ( WebAction action ) const

Returns a QAction for the specified WebAction action.

The action is owned by the QWebPage but you can customize the look by changing its properties.

QWebPage also takes care of implementing the action, so that upon triggering the corresponding action is performed on the page.

quint64 QWebPage::bytesReceived () const

Returns the number of bytes that were received from the network to render the current page.

QString QWebPage::chooseFile ( QWebFrame * parentFrame, const QString & oldFile )   [virtual protected]

This function is called when the web content requests a file name, for example as a result of the user clicking on a "file upload" button in a HTML form.

QWebPage * QWebPage::createModalDialog ()   [virtual protected]

This function is called whenever WebKit wants to create a new window that should act as a modal dialog.

QObject * QWebPage::createPlugin ( const QString & classid, const QUrl & url, const QStringList & paramNames, const QStringList & paramValues )   [virtual protected]

This function is called whenever WebKit encounters a HTML object element with type "application/x-qt-plugin". The classid, url, paramNames and paramValues correspond to the HTML object element attributes and child elements to configure the embeddable object.

QWebPage * QWebPage::createWindow ()   [virtual protected]

This function is called whenever WebKit wants to create a new window, for example as a result of a JavaScript request to open a document in a new window.

QWebFrame * QWebPage::currentFrame () const

Returns the frame currently active.

bool QWebPage::focusNextPrevChild ( bool next )   [virtual]

Similar to QWidget::focusNextPrevChild it focuses the next focusable web element if next is true. Otherwise the previous element is focused.

void QWebPage::frameCreated ( QWebFrame * frame )   [signal]

This signal is emitted whenever the page creates a new frame.

void QWebPage::geometryChangeRequest ( const QRect & geom )   [signal]

This signal is emitted whenever the document wants to change the position and size of the page to geom. This can happen for example through JavaScript.

QWebHistory * QWebPage::history () const

Returns a pointer to the view's history of navigated web pages.

void QWebPage::hoveringOverLink ( const QString & link, const QString & title, const QString & textContent = QString() )   [signal]

This signal is emitted when the mouse is hovering over a link. The first parameter is the link url, the second is the link title if any, and third textContent is the text content. Method is emitter with both empty parameters when the mouse isn't hovering over any link element.

void QWebPage::javaScriptAlert ( QWebFrame * frame, const QString & msg )   [virtual protected]

This function is called whenever a JavaScript program calls the alert() function.

bool QWebPage::javaScriptConfirm ( QWebFrame * frame, const QString & msg )   [virtual protected]

This function is called whenever a JavaScript program calls the confirm() function.

void QWebPage::javaScriptConsoleMessage ( const QString & message, unsigned int lineNumber, const QString & sourceID )   [virtual protected]

This function is called whenever a JavaScript program tries to print to what is the console in web browsers.

bool QWebPage::javaScriptPrompt ( QWebFrame * frame, const QString & msg, const QString & defaultValue, QString * result )   [virtual protected]

This function is called whenever a JavaScript program tries to prompt the user of input.

void QWebPage::loadProgressChanged ( int progress )   [signal]

This signal is emitted when the global progress status changes. The current value is provided by progress in percent. It accumulates changes from all the child frames.

QWebFrame * QWebPage::mainFrame () const

Returns the main frame of the page.

The main frame provides access to the hierarchy of sub-frames and is also needed if you want to explicitly render a web page into a given painter.

NavigationRequestResponse QWebPage::navigationRequested ( QWebFrame * frame, const QWebNetworkRequest & request, NavigationType type )   [virtual protected]

QWebNetworkInterface * QWebPage::networkInterface () const

See also setNetworkInterface().

QNetworkProxy QWebPage::networkProxy () const

See also setNetworkProxy().

void QWebPage::selectionChanged ()   [signal]

This signal is emitted whenever the selection changes.

void QWebPage::setNetworkInterface ( QWebNetworkInterface * interface )

See also networkInterface().

void QWebPage::setNetworkProxy ( const QNetworkProxy & proxy )

See also networkProxy().

void QWebPage::setView ( QWidget * view )

Sets the view that is associated with the web page.

See also view().

QWebSettings * QWebPage::settings ()

Returns a pointe to the page's settings object.

void QWebPage::statusBarTextChanged ( const QString & text )   [signal]

This signal is emitted when the statusbar text is changed by the page.

quint64 QWebPage::totalBytes () const

Returns the total number of bytes that were received from the network to render the current page, including extra content such as embedded images.

void QWebPage::triggerAction ( WebAction action, bool checked = false )   [virtual]

This function can be called to trigger the specified action. It is also called by QtWebKit if the user triggers the action, for example through a context menu item.

If action is a checkable action then checked specified whether the action is toggled or not.

QUndoStack * QWebPage::undoStack () const

Returns a pointer to the undo stack used for editable content.

QString QWebPage::userAgentFor ( const QUrl & url ) const   [virtual protected]

This function is called when a user agent for HTTP requests is needed. You can re-implement this function to dynamically return different user agent's for different urls, based on the url parameter.

QWidget * QWebPage::view () const

Returns the view widget that is associated with the web page.

See also setView().


Copyright © 2007 Trolltech Trademarks
Qt 4.4.0-tp1