WebView (gb.qt4.webkit)

This control implements the WebKit browser.

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

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

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	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.
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.
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 top-level 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.

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.

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