Gambas Documentation
Application Repository
Code Snippets
Compilation & Installation
Components
gb
gb.args
gb.cairo
gb.chart
gb.clipper
gb.complex
gb.compress
gb.crypt
gb.data
gb.db
gb.db.form
gb.db.mysql
gb.db.odbc
gb.db.postgresql
gb.db.sqlite2
gb.db.sqlite3
gb.dbus
gb.dbus.trayicon
gb.debug
gb.desktop
gb.desktop.gnome.keyring
gb.desktop.x11
gb.eval
gb.eval.highlight
gb.form
gb.form.dialog
gb.form.editor
gb.form.htmlview
gb.form.mdi
gb.form.print
gb.form.stock
gb.form.terminal
gb.gmp
gb.gsl
gb.gtk
gb.gtk.opengl
gb.gtk3
gb.gtk3.opengl
gb.gtk3.webview
gb.gui
gb.gui.opengl
gb.gui.qt
gb.gui.qt.ext
gb.gui.qt.opengl
gb.gui.qt.webkit
gb.gui.trayicon
gb.gui.webview
gb.hash
gb.highlight
gb.image
gb.image.effect
gb.image.imlib
gb.image.io
gb.inotify
gb.jit
gb.libxml
gb.logging
gb.map
gb.markdown
gb.media
gb.media.form
gb.memcached
gb.mime
gb.mysql
gb.ncurses
gb.net
gb.net.curl
gb.net.pop3
gb.net.smtp
gb.openal
gb.opengl
gb.opengl.glsl
gb.opengl.glu
gb.opengl.sge
gb.openssl
gb.option
gb.pcre
gb.pdf
gb.poppler
gb.qt4
gb.qt4.ext
gb.qt4.opengl
gb.qt4.webkit
.WebElement.Style
.WebFrame.Children
.WebSettings.Cache
.WebSettings.Fonts
.WebSettings.IconDatabase
.WebSettings.Proxy
.WebView.Auth
.WebView.History
.WebView.Settings
Cookie
WebDownload
WebDownloads
WebElement
WebFrame
WebHitTest
WebSettings
WebView
_new
Auth
Auth
Back
Click
Cookies
Current
Document
Download
Editable
Error
Eval
FindText
Forward
Frame
History
HitTest
HTML
Icon
Icon
Link
Load
NewFrame
NewView
NewWindow
Progress
Progress
Reload
Select
SelectedText
Settings
Status
Status
Stop
Text
TextZoom
Title
Title
Url
UserAgent
Zoom
gb.qt4.webview
gb.qt5
gb.qt5.ext
gb.qt5.opengl
gb.qt5.webkit
gb.qt5.webview
gb.qt6
gb.qt6.ext
gb.qt6.opengl
gb.qt6.webview
gb.report
gb.report2
gb.scanner
gb.sdl
gb.sdl.sound
gb.sdl2
gb.sdl2.audio
gb.settings
gb.signal
gb.term
gb.test
gb.util
gb.util.web
gb.v4l
gb.vb
gb.web
gb.web.feed
gb.web.form
gb.web.gui
gb.xml
gb.xml.html
gb.xml.rpc
gb.xml.xslt
Controls pictures
Deprecated components
Developer Documentation
Development Environment Documentation
Documents
Error Messages
Gambas Playground
How To's
Language Index
Language Overviews
Last Changes
Lexicon
README
Search the wiki
To Do
Topics
Tutorials
Wiki License
Wiki Manual

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

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