WebView (gb.qt4.webkit)

This control implements the WebKit browser. See the 'WebBrowser' example project: it will show you how to use this control.

This class inherits Control in gb.qt4. This class is creatable .

Properties

Auth This property returns a virtual object used for managing HTTP authentication.

Cookies Return or set an array of the cookies stored in the cookie jar.

Current Returns the current frame.

Document Returns the document element of the main frame of the view.

Editable Return or set if the WebView is editable.

Frame Returns the root frame of the web page.

HTML Returns or sets the HTML displayed by the web page.

History Return a virtual object used for managing the browser history.

Icon Returns the icon of the web page, or NULL if there is no icon.

NewView When a WebView asks for a new window by raising the NewWindow event, then you must set this property is set with the newly created WebView.

Progress Returns a number between 0 and 1 that indicates the progression of the web page loading.

SelectedText Returns the selected text of the web view.

Settings Returns a virtual object used for defining the settings of the view.

Status Returns or sets the status string.

Text Returns the text displayed by the view, without any HTML markup.

TextZoom Returns or sets the text zoom factor, 1.0 being 100%.

Title Returns the title of the HTML page.

Url Returns or sets the URL displayed by the web page.

UserAgent Return or set the user-agent string that will be sent to the web server.

Zoom Returns or sets the web page zoom, 1.0 being 100%.

Inherited properties

Action Returns or sets the action string associated with the control.

Background Returns or sets the background color used by the control.

Cursor Use this property for assigning a custom cursor to a control.

Design Indicates that the control is in design mode.

Direction

Since 3.17

Return or set the control text direction.

Drop Returns or sets if a control accepts drops.

Enabled Indicates that the control is enabled.

Expand Returns or sets if a control will expand if included in a container that arranges its contents.

Font Returns or sets the font used to draw text in the control.

Foreground Returns or sets the foreground color used by the control.

H A synonymous for the Height property.

Handle Returns the internal X11 window handle of the control.

HasFocus Returns whether the control has the focus.

Height Returns or sets the height of the control.

Hovered Returns whether the mouse cursor is inside the control.

Id A synonymous for the Handle property.

Ignore Returns or sets if a control must be ignored when its parent arranges its children.

Left Returns or sets the position of the left border of the control relative to its parent.

Mouse Returns or sets the appearence of the cursor when it points inside the control.

Name Returns or sets the name of the control.

Next Returns the next control having the same parent.

NoAnimation

Since 3.20

Return or set if the possible animations of a control are disabled.

NoTabFocus Return or set if a control cannot be focused with the TAB key.

Parent Returns the control container.

PopupMenu Return or set the name of the menu that will be popped-up when the user presses the right mouse button or the keyboard MENU key.

Previous Returns the previous control having the same parent.

Proxy Return or set the "proxy" of a control.

ProxyFor Return which control that control is a proxy for.

RightToLeft Return if the control is right to left oriented.

ScreenX Returns the position of the left border of the control in screen coordinates.

ScreenY Returns the position of the top border of the control in screen coordinates.

Tag Returns or sets the control tag.

Tooltip Returns or sets the tooltip shown when the mouse stays on the control for a short time.

Top Returns or sets the position of the top border of the control relative to its parent.

TopLevel

Since 3.21

Return the top-level window this control belongs to.

Tracking Returns or sets if the control will receive MouseMove events.

Visible Indicates if the control is visible or not.

W A synonymous for the Width property.

Width Returns or sets the width of the control.

Window Returns the window that contains the control.

X Returns or sets the position of the left border of the control relative to its parent.

Y Returns or sets the position of the top border of the control relative to its parent.

Methods

Back Go back in the history.

Eval Evaluate any JavaScript expression in the context of the current frame, and return its value.

FindText Search for some text inside the HTML page.

Forward Go forward in the history.

HitTest Return what is found at a specific point on the HTML page.

Reload Reloads the current page.

Stop Aborts the loading of the current page.

Inherited methods

Delete Destroys the control.

Drag Starts a drag & drop process.

Grab Grab the keyboard and the mouse so that all keyboard and mouse events are received by the control.

Hide Hides the control.

Lower Sends the control to the background of its parent.

Move Moves and/or resizes the control.

MoveScaled Moves and/or resizes the control.

Raise Sends the control to the foreground of its parent.

Refresh Trigger a redraw of the control.

Reparent Changes the container of a control.

Resize Resizes the control.

ResizeScaled Resizes the control.

SetFocus Gives the focus to the control.

Show Shows the control.

Events

Auth Raised when an HTTP authentication is required.

Click Raised when the URL of a frame has changed.

Download Raised when a file download is requested.

Error Raised when the file download has failed.

Icon Raised when the icon of the displayed HTML page has been retrieved.

Link Raised when a link is hovered.

Load Raised when the HTML page has been entirely loaded.

NewFrame Raised when a new frame has been created.

NewWindow Raised when the HTML page wants to open a new window (or a new tab).

Progress Raised when the page load progress has changed.

Select Raised when the user has selected something inside the HTML page.

Status Raised when the HTML page wants to display something in the status bar.

Title Raised when the HTML page title has been retrieved.

Inherited events

DblClick Raised when the user quickly clicks twice on the control.

Drag This event is raised when the mouse enters the control during a drag & drop process.

DragLeave This event is raised when the mouse leaves the control during a drag & drop operation.

DragMove This event is raised while the mouse moves inside the control during a drag & drop process.

Drop This event is raised when a drag is dropped in the control.

Enter Raised when the mouse enters the control.

GotFocus Raised when the control has got the focus.

KeyPress Raised when a key is pressed while the control has the focus.

KeyRelease Raised when a key is released while the control has the focus.

Leave Raised when the mouse leaves the control.

LostFocus Raised when the control has lost the focus.

Menu Raised when the user clicks on the control with the right mouse button, or if it hits the MENU key.

MouseDown Raised when a mouse button is pressed while the cursor is inside the control.

MouseDrag This event is raised when a drag operation should be started.

MouseMove Raised when the mouse moves inside the control while a mouse button is pressed.

MouseUp Raised when a mouse button is depressed while the cursor is inside the control.

MouseWheel This event is raised when the user moves or presses the mouse wheel while the mouse is inside the control.

Using WebView as an HTML editor

If you set the Editable property to TRUE, then WebView becomes an html editor. To modify the HTML page contents programatically, you must use the Eval method to run the JavaScript document.execCommand DOM API. Here is a list of commands currently implemented by WebKit:

AlignCenter
AlignJustified
AlignLeft
AlignRight
BackColor
BackwardDelete
Bold
Copy
CreateLink
Cut
Delete
DeleteBackward
DeleteBackwardByDecomposingPreviousCharacter
DeleteForward
DeleteToBeginningOfLine
DeleteToBeginningOfParagraph
DeleteToEndOfLine
DeleteToEndOfParagraph
DeleteToMark
DeleteWordBackward
DeleteWordForward
FindString
FontName
FontSize
FontSizeDelta
ForeColor
FormatBlock
ForwardDelete
HiliteColor
IgnoreSpelling
Indent
InsertBacktab
InsertHTML
InsertHorizontalRule
InsertImage
InsertLineBreak
InsertNewline
InsertNewlineInQuotedContent
InsertOrderedList
InsertParagraph
InsertTab
InsertText
InsertUnorderedList
Italic
JustifyCenter
JustifyFull
JustifyLeft
JustifyNone
JustifyRight
MakeTextWritingDirectionLeftToRight
MakeTextWritingDirectionNatural
MakeTextWritingDirectionRightToLeft
MoveBackward
MoveBackwardAndModifySelection
MoveDown
MoveDownAndModifySelection
MoveForward
MoveForwardAndModifySelection
MoveLeft
MoveLeftAndModifySelection
MovePageDown
MovePageDownAndModifySelection
MovePageUp
MovePageUpAndModifySelection
MoveParagraphBackwardAndModifySelection
MoveParagraphForwardAndModifySelection
MoveRight
MoveRightAndModifySelection
MoveToBeginningOfDocument
MoveToBeginningOfDocumentAndModifySelection
MoveToBeginningOfLine
MoveToBeginningOfLineAndModifySelection
MoveToBeginningOfParagraph
MoveToBeginningOfParagraphAndModifySelection
MoveToBeginningOfSentence
MoveToBeginningOfSentenceAndModifySelection
MoveToEndOfDocument
MoveToEndOfDocumentAndModifySelection
MoveToEndOfLine
MoveToEndOfLineAndModifySelection
MoveToEndOfParagraph
MoveToEndOfParagraphAndModifySelection
MoveToEndOfSentence
MoveToEndOfSentenceAndModifySelection
MoveToLeftEndOfLine
MoveToLeftEndOfLineAndModifySelection
MoveToRightEndOfLine
MoveToRightEndOfLineAndModifySelection
MoveUp
MoveUpAndModifySelection
MoveWordBackward
MoveWordBackwardAndModifySelection
MoveWordForward
MoveWordForwardAndModifySelection
MoveWordLeft
MoveWordLeftAndModifySelection
MoveWordRight
MoveWordRightAndModifySelection
Outdent
Paste
PasteAndMatchStyle
Print
Redo
RemoveFormat
SelectAll
SelectLine
SelectParagraph
SelectSentence
SelectToMark
SelectWord
SetMark
Strikethrough
StyleWithCSS
Subscript
Superscript
SwapWithMark
ToggleBold
ToggleItalic
ToggleUnderline
Transpose
Underline
Undo
Unlink
Unscript
Unselect
Yank
YankAndSelect