wxPython - 高级控件之HtmlWindow

实战wxPython系列-044

本文介绍如何在Python的GUI工具中嵌入HTML页面。

wxPython的wx.html和wx.html2模块支持解析和显示HTML文件内容。wx.html.HtmlWindow对象是一个通用的HTML浏览器，但不是一个全功能的浏览器，所以支持的功能有限。wx.html.HtmlWindow只支持HTML标准的一个子集，不支持Javascript或者CSS。如果要支持全特性的HTML渲染组件，请使用wx.html2.WebView。

一、wx.html.HtmlWindow简介

wx.html.HtmlWindow控件的目的是显示基于HTML标准字迹的富内容页面（本地文件或者通过HTTP下载的网页文件），一定创建了该窗口控件，可以通过调用SetPage和LoadPage来设置它的内容。

wx.html.HtmlWindow支持的窗口样式：

wx.html.HW_SCROLLBAR_NEVER：不显示滚动条。
wx.html.HW_SCROLLBAR_AUTO：在需要的时候显示滚动条。
wx.html.HW_NO_SELECTION：用户不可以选择其中的文本(默认可以)。

wx.html.HtmlWindow发出的事件：

EVT_HTML_CELL_CLICKED：单击wx.html.HtmlCell时产生。
EVT_HTML_CELL_HOVER：鼠标经过一个wx.html.HtmlCell时产生。
EVT_HTML_LINK_CLICKED：单击了包含超链接的wx.html.HtmlCell时产生。

wx.html.HtmlWindow常用方法：

AppendToPage(self, source)：将HTML片段附加到当前显示的文本并刷新窗口。
GetOpenedAnchor(self)：返回当前打开页面中的锚点。如果没有打开任何页，或者所显示的页不是通过调用LoadPage生成的，则返回空字符串。
GetOpenedPage(self)：返回所打开页面的完整位置。如果没有打开任何页，或者所显示的页不是通过调用LoadPage生成的，则返回空字符串。
GetOpenedPageTitle(self)：返回所打开页面的标题，如果当前页面不包含< title>标记，则返回“”。
HistoryBack(self)：移动回上一页。只有使用LoadPage显示的页面才存储在历史列表中。
HistoryCanBack(self)：如果有可能在历史页面向后操作，即返回True。
HistoryCanForward(self)：如果有可能在历史中向前操作，即返回True。
HistoryClear(self)：清除历史页面。
HistoryForward(self)：移动到下一页。只有使用LoadPage显示的页面才存储在历史列表中。
LoadFile(self, filename)：从文件加载HTML页面并显示它。
LoadPage(self, location)：与SetPage不同，这个函数首先从给定的location加载HTML页面，然后显示它。
OnCellClicked(self, cell, x, y, event)：在wx.html.HtmlWindow内单击鼠标按钮时调用此方法。默认行为是发出wx.html.HtmlCellEvent，如果事件没有被处理或跳过，如果单元格包含超文本链接，则调用OnLinkClicked。
OnCellMouseHover(self, cell, x, y)：当鼠标移动到HTML单元格上时调用此方法。默认行为是发出wx.html.HtmlCellEvent。
OnLinkClicked(self, link)：当用户单击超文本链接时调用。默认行为是触发wx.html.HtmlLinkEvent，如果没有处理或跳过该事件，则调用LoadPage，不做任何其他事情。
OnOpeningURL(self, type, url)：在URL被打开时调用(当用户单击链接或加载图像时)。只有OnOpeningURL返回HTML_OPEN时，URL才会被打开。此方法由wx.html.HtmlParser.OpenURL调用。

图1：wx.html.HtmlWindow类继承关系

二、wx.html.HtmlWindow演示

Htmlwin.py文件

#html窗口(wx.html.HtmlWindow)

import wx
import wx.html

class SampleHtmlWindow(wx.Frame):

    def __init__(self, *args, **kw):
        super(SampleHtmlWindow, self).__init__(*args, **kw)

        self.InitUi()

    def InitUi(self):
        self.SetTitle("实战wxPython: HtmlWindow演示")
        self.SetSize(400, 300)

        panel = wx.Panel(self)
        vbox = wx.BoxSizer(wx.VERTICAL)
        hbox = wx.BoxSizer(wx.HORIZONTAL)

        htmlwin = wx.html.HtmlWindow(panel, wx.ID_ANY, style = wx.NO_BORDER)
        htmlwin.SetStandardFonts()
        htmlwin.LoadPage("page.html")
        """
        htmlwin.SetPage('''
            
                
                    这是标题
                    实战wxPython
                    通过RGB值设置背景颜色
                    

                     
                        这是一个段落
                    
                    这是斜体文本
                
            
        ''')
        """

        vbox.Add((-1, 10), 0)
        vbox.Add(htmlwin, 1, wx.EXPAND | wx.ALL, 9)

        bitmap = wx.StaticBitmap(panel, wx.ID_ANY, wx.Bitmap("newt.png"))
        hbox.Add(bitmap, 0, wx.LEFT | wx.BOTTOM | wx.TOP, 10)

        btnOk = wx.Button(panel, wx.ID_ANY, "确定")
        self.Bind(wx.EVT_BUTTON, self.OnClose, id=btnOk.GetId())

        hbox.Add((100, -1), 1, wx.LEFT)
        hbox.Add(btnOk, flag = wx.TOP | wx.BOTTOM | wx.RIGHT, border = 10)

        vbox.Add(hbox, 0, wx.EXPAND)

        panel.SetSizer(vbox)

        self.Centre()

    def OnClose(self, e):
        self.Close()

def main():
    app = wx.App()
    sample = SampleHtmlWindow(None)
    sample.Show()
    app.MainLoop()

if __name__ == "__main__":
    main()

page.html文件



    


    
        
              Maximum
              9000
        
        
              Mean
              6076
        
        
              Minimum
              3800
        
        
              Median
              6000
        
        
              Standard Deviation
              6076

上面的示例演示了如何使用wx.html.HtmlWindow来加载一个html文件并显示它。

htmlwin = wx.html.HtmlWindow(panel, wx.ID_ANY, style = wx.NO_BORDER)
htmlwin.SetStandardFonts()
htmlwin.LoadPage("page.html")

创建wx.html.HtmlWindow对象，然后使用LoadPage方法加载文件。

图2：wx.html.HtmWindow演示

三、本文知识点

了解wx.html.HtmlWindow控件。
使用wx.html.HtmlWindow加载并显示HTML文件。

前一篇：wxPython - 高级控件之表格Grid

请关注，评论，收藏，点赞，和转发。

Maximum	9000
Mean	6076
Minimum	3800
Median	6000
Standard Deviation	6076