实战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文件。
请关注，评论，收藏，点赞，和转发。