Navigation

Phoenix Logo

phoenix_title wx.html.HtmlHelpWindow

This class is used by wx.html.HtmlHelpController to display help within a frame or dialog, but you can use it yourself to create an embedded HTML help window.

For example:

def EmbedHTML(self):
    # self.embeddedHelpWindow is a wx.html.HtmlHelpWindow
    # self.embeddedHtmlHelp is a wx.html.HtmlHelpController

    # Create embedded HTML Help window
    self.embeddedHelpWindow = wx.html.HtmlHelpWindow
    self.embeddedHtmlHelp.UseConfig(config, rootPath) # Set your own config object here
    self.embeddedHtmlHelp.SetHelpWindow(self.embeddedHelpWindow)
    self.embeddedHelpWindow.Create(self, wx.ID_ANY, wx.DefaultPosition, self.GetClientSize(),
                                   wx.TAB_TRAVERSAL | wx.BORDER_NONE, wx.html.HF_DEFAULT_STYLE)
    self.embeddedHtmlHelp.AddBook("doc.zip")

You should pass the style wx.html.HF_EMBEDDED to the style parameter of wx.html.HtmlHelpController to allow the embedded window to be destroyed independently of the help controller.


class_hierarchy Class Hierarchy

Inheritance diagram for class HtmlHelpWindow:


method_summary Methods Summary

__init__  
AddToolbarButtons You may override this virtual method to add more buttons to the help window’s toolbar.
Create Creates the help window.
CreateContents Creates contents panel.
CreateIndex Creates index panel.
CreateSearch Creates search panel.
Display Displays page x.
DisplayContents Displays contents panel.
DisplayIndex Displays index panel.
GetController  
GetData Returns the wx.html.HtmlHelpData object, which is usually a pointer to the controller’s data.
KeywordSearch Search for given keyword.
ReadCustomization Reads the user’s settings for this window.
RefreshLists Refresh all panels.
SetController  
UseConfig Associates a Config object with the help window.
WriteCustomization Saves the user’s settings for this window.

property_summary Properties Summary

Controller See GetController and SetController
Data See GetData

api Class API


class wx.html.HtmlHelpWindow(Window)

Possible constructors:

HtmlHelpWindow(data=None)

HtmlHelpWindow(parent, WindowID, pos=DefaultPosition, size=DefaultSize,
               style=TAB_TRAVERSAL|BORDER_NONE, helpStyle=HF_DEFAULT_STYLE, data=None)

This class is used by HtmlHelpController to display help within a frame or dialog, but you can use it yourself to create an embedded HTML help window.


Methods


__init__(self, *args, **kw)

overload Overloaded Implementations:


__init__ (self, data=None)

Parameters:data (wx.html.HtmlHelpData) –


__init__ (self, parent, WindowID, pos=DefaultPosition, size=DefaultSize, style=TAB_TRAVERSAL|BORDER_NONE, helpStyle=HF_DEFAULT_STYLE, data=None)

Constructor.

For the values of helpStyle, please see the documentation for wx.html.HtmlHelpController.

Parameters:



AddToolbarButtons(self, toolBar, style)

You may override this virtual method to add more buttons to the help window’s toolbar.

toolBar is a pointer to the toolbar and style is the style flag as passed to the Create method.

wx.ToolBar.Realize is called immediately after returning from this function. See samples/html/helpview for an example.

Parameters:

Create(self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=TAB_TRAVERSAL|BORDER_NONE, helpStyle=HF_DEFAULT_STYLE)

Creates the help window.

See the constructor for a description of the parameters.

Parameters:
Return type:

bool

CreateContents(self)

Creates contents panel.

(May take some time.)


CreateIndex(self)

Creates index panel.

(May take some time.)


CreateSearch(self)

Creates search panel.


Display(self, *args, **kw)

overload Overloaded Implementations:


Display (self, x)

Displays page x.

If not found it will give the user the choice of searching books. Looking for the page runs in these steps:

  • try to locate file named x (if x is for example “doc/howto.htm”)
  • try to open starting page of book x
  • try to find x in contents (if x is for example “How To ...”)
  • try to find x in index (if x is for example “How To ...”)
Parameters:x (string) –
Return type:bool


Display (self, id)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Parameters:id (int) –
Return type:bool



DisplayContents(self)

Displays contents panel.

Return type:bool

DisplayIndex(self)

Displays index panel.

Return type:bool

GetController(self)
Return type: wx.html.HtmlHelpController

GetData(self)

Returns the wx.html.HtmlHelpData object, which is usually a pointer to the controller’s data.

Return type: wx.html.HtmlHelpData

KeywordSearch(self, keyword, mode=HELP_SEARCH_ALL)

Search for given keyword.

Optionally it searches through the index (mode = HELP_SEARCH_INDEX ), default the content (mode = HELP_SEARCH_ALL ).

Parameters:
Return type:

bool

ReadCustomization(self, cfg, path="")

Reads the user’s settings for this window.

Parameters:

See also

wx.html.HtmlHelpController.ReadCustomization


RefreshLists(self)

Refresh all panels.

This is necessary if a new book was added.


SetController(self, controller)
Parameters:controller (wx.html.HtmlHelpController) –

UseConfig(self, config, rootpath="")

Associates a Config object with the help window.

It is recommended that you use wx.html.HtmlHelpController.UseConfig instead.

Parameters:

WriteCustomization(self, cfg, path="")

Saves the user’s settings for this window.

Parameters:

See also

wx.html.HtmlHelpController.WriteCustomization


Properties


Controller

See GetController and SetController


Data

See GetData