View Source wxHtmlWindow (wx v2.4.3)
wxHtmlWindow is probably the only class you will directly use unless you want to do
something special (like adding new tag handlers or MIME filters).
The purpose of this class is to display rich content pages (either local file or
downloaded via HTTP protocol) in a window based on a subset of the HTML standard. The
width of the window is constant, given in the constructor and virtual height is changed
dynamically depending on page size. Once the window is created you can set its content by
calling setPage/2 with raw HTML, loadPage/2 with a wxFileSystem (not implemented in wx) location or loadFile/2 with a filename.
Note: If you want complete HTML/CSS support as well as a Javascript engine, consider
using wxWebView instead.
wxHtmlWindow uses the wxImage class for displaying images, so you need to
initialize the handlers for any image formats you use before loading a page. See
?wxInitAllImageHandlers and wxImage::AddHandler (not implemented in wx).
Styles
This class supports the following styles:
wxHW_SCROLLBAR_NEVER: Never display scrollbars, not even when the page is larger than the window.
wxHW_SCROLLBAR_AUTO: Display scrollbars only if page's size exceeds window's size.
wxHW_NO_SELECTION: Don't allow the user to select text.
See: wxHtmlLinkEvent
This class is derived, and can use functions, from:
wxWidgets docs: wxHtmlWindow
Events
Event types emitted from this class:
Summary
Functions
Appends HTML fragment to currently displayed text and refreshes the window.
Destroys the object
Returns anchor within currently opened page (see getOpenedPage/1).
Returns full location of the opened page.
Returns title of the opened page or wxEmptyString if the current page does not contain <TITLE> tag.
Returns the related frame.
Moves back to the previous page.
Returns true if it is possible to go back in the history i.e.
Returns true if it is possible to go forward in the history i.e.
Clears history.
Moves to next page in history.
Loads an HTML page from a file and displays it.
Unlike setPage/2 this function first loads the HTML page from location and then
displays it.
Default ctor.
Equivalent to new(Parent, []).
Constructor.
Selects all text in the window.
Returns the current selection as plain text.
Selects the line of text that pos points at.
Selects the word at position pos.
This function sets the space between border of window and HTML contents.
This function sets font sizes and faces.
Sets the source of a page and displays it, for example
Sets the frame in which page title will be displayed.
After calling setRelatedFrame/3, this sets statusbar slot where messages will be
displayed.
Sets the associated statusbar where messages will be displayed.
Returns content of currently displayed page as plain text.
Types
-type wxHtmlWindow() :: wx:wx_object().
Functions
-spec appendToPage(This, Source) -> boolean() when This :: wxHtmlWindow(), Source :: unicode:chardata().
Appends HTML fragment to currently displayed text and refreshes the window.
Return: false if an error occurred, true otherwise.
-spec destroy(This :: wxHtmlWindow()) -> ok.
Destroys the object
-spec getOpenedAnchor(This) -> unicode:charlist() when This :: wxHtmlWindow().
Returns anchor within currently opened page (see getOpenedPage/1).
If no page is opened or if the displayed page wasn't produced by call to loadPage/2, empty string
is returned.
-spec getOpenedPage(This) -> unicode:charlist() when This :: wxHtmlWindow().
Returns full location of the opened page.
If no page is opened or if the displayed page wasn't produced by call to loadPage/2, empty string
is returned.
-spec getOpenedPageTitle(This) -> unicode:charlist() when This :: wxHtmlWindow().
Returns title of the opened page or wxEmptyString if the current page does not contain <TITLE> tag.
-spec getRelatedFrame(This) -> wxFrame:wxFrame() when This :: wxHtmlWindow().
Returns the related frame.
-spec historyBack(This) -> boolean() when This :: wxHtmlWindow().
Moves back to the previous page.
Only pages displayed using loadPage/2 are stored in history list.
-spec historyCanBack(This) -> boolean() when This :: wxHtmlWindow().
Returns true if it is possible to go back in the history i.e.
historyBack/1 won't fail.
-spec historyCanForward(This) -> boolean() when This :: wxHtmlWindow().
Returns true if it is possible to go forward in the history i.e.
historyForward/1 won't fail.
-spec historyClear(This) -> ok when This :: wxHtmlWindow().
Clears history.
-spec historyForward(This) -> boolean() when This :: wxHtmlWindow().
Moves to next page in history.
Only pages displayed using loadPage/2 are stored in history list.
-spec loadFile(This, Filename) -> boolean() when This :: wxHtmlWindow(), Filename :: unicode:chardata().
Loads an HTML page from a file and displays it.
Return: false if an error occurred, true otherwise
See: loadPage/2
-spec loadPage(This, Location) -> boolean() when This :: wxHtmlWindow(), Location :: unicode:chardata().
Unlike setPage/2 this function first loads the HTML page from location and then
displays it.
Return: false if an error occurred, true otherwise
See: loadFile/2
-spec new() -> wxHtmlWindow().
Default ctor.
-spec new(Parent) -> wxHtmlWindow() when Parent :: wxWindow:wxWindow().
Equivalent to new(Parent, []).
-spec new(Parent, [Option]) -> wxHtmlWindow() when Parent :: wxWindow:wxWindow(), Option :: {id, integer()} | {pos, {X :: integer(), Y :: integer()}} | {size, {W :: integer(), H :: integer()}} | {style, integer()}.
Constructor.
The parameters are the same as wxScrolled::wxScrolled() (not implemented in wx)
constructor.
-spec selectAll(This) -> ok when This :: wxHtmlWindow().
Selects all text in the window.
See:
-spec selectionToText(This) -> unicode:charlist() when This :: wxHtmlWindow().
Returns the current selection as plain text.
Returns an empty string if no text is currently selected.
-spec selectLine(This, Pos) -> ok when This :: wxHtmlWindow(), Pos :: {X :: integer(), Y :: integer()}.
Selects the line of text that pos points at.
Note that pos is relative to the top of displayed page, not to window's origin, use wxScrolledWindow:calcUnscrolledPosition/3 to
convert physical coordinate.
See:
-spec selectWord(This, Pos) -> ok when This :: wxHtmlWindow(), Pos :: {X :: integer(), Y :: integer()}.
Selects the word at position pos.
Note that pos is relative to the top of displayed page, not to window's origin, use wxScrolledWindow:calcUnscrolledPosition/3 to
convert physical coordinate.
See:
-spec setBorders(This, B) -> ok when This :: wxHtmlWindow(), B :: integer().
This function sets the space between border of window and HTML contents.
See image:
-spec setFonts(This, Normal_face, Fixed_face) -> ok when This :: wxHtmlWindow(), Normal_face :: unicode:chardata(), Fixed_face :: unicode:chardata().
Equivalent to setFonts(This, Normal_face, Fixed_face, []).
-spec setFonts(This, Normal_face, Fixed_face, [Option]) -> ok when This :: wxHtmlWindow(), Normal_face :: unicode:chardata(), Fixed_face :: unicode:chardata(), Option :: {sizes, [integer()]}.
This function sets font sizes and faces.
See wxHtmlDCRenderer::SetFonts (not implemented in wx) for detailed description.
-spec setPage(This, Source) -> boolean() when This :: wxHtmlWindow(), Source :: unicode:chardata().
Sets the source of a page and displays it, for example:
If you want to load a document from some location use loadPage/2 instead.
Return: false if an error occurred, true otherwise.
-spec setRelatedFrame(This, Frame, Format) -> ok when This :: wxHtmlWindow(), Frame :: wxFrame:wxFrame(), Format :: unicode:chardata().
Sets the frame in which page title will be displayed.
format is the format of the frame title, e.g. "HtmlHelp : %s". It must contain exactly
one s. This s is substituted with HTML page title.
-spec setRelatedStatusBar(This, Statusbar) -> ok when This :: wxHtmlWindow(), Statusbar :: wxStatusBar:wxStatusBar(); (This, Index) -> ok when This :: wxHtmlWindow(), Index :: integer().
After calling setRelatedFrame/3, this sets statusbar slot where messages will be
displayed.
(Default is -1 = no messages.)
-spec setRelatedStatusBar(This, Statusbar, [Option]) -> ok when This :: wxHtmlWindow(), Statusbar :: wxStatusBar:wxStatusBar(), Option :: {index, integer()}.
Sets the associated statusbar where messages will be displayed.
Call this instead of setRelatedFrame/3 if you want statusbar updates only, no changing of the frame title.
Since: 2.9.0
-spec toText(This) -> unicode:charlist() when This :: wxHtmlWindow().
Returns content of currently displayed page as plain text.