在使用 wxPython 开发跨平台桌面应用程序时,创建一个图标选择界面通常用于让用户从图标资源库中选择图标,我们可以把图标分为自定义的图标资源和系统的图标资源两大类,最终我们把它们整合一起使用,在框架的界面中使用,包括工具栏、右键菜单、按钮、图片等所需的地方显示,实现图文并茂的友好界面展示。本篇随笔介绍这两种图标资源的管理和使用过程。
1、图标分类介绍
这里图标我们分为两类,一类是wxPython内置的图标资源,以wx.Art_开始。wx.ART_
是 wxPython 提供的艺术资源(Art Resource)常量,用于在界面中快速访问通用的图标或位图资源。这些资源可以通过 wx.ArtProvider
获取,主要用于创建标准化的界面,例如工具栏、菜单和对话框中的图标。这类可以使用 wx.ArtProvider.GetBitmap
或 wx.ArtProvider.GetIcon
获取对应的位图或图标。
bitmap = wx.ArtProvider.GetBitmap(wx.ART_INFORMATION, wx.ART_OTHER, (32, 32))
icon = wx.ArtProvider.GetIcon(wx.ART_WARNING, wx.ART_OTHER, (16, 16))
参数说明:
id
:指定图标的类型,例如wx.ART_INFORMATION
、wx.ART_WARNING
等。client
:指定图标的用途,一般用wx.ART_OTHER
。size
:指定图标的尺寸,例如(16, 16)
或(32, 32)
。
常用 wx.ART_ 图标列表 以下是一些常见的 wx.ART_ 常量及其用途:
通过使用 wx.ART_,可以显著提高界面的一致性和开发效率! 另外一类是我们自己自定义的图标资源,为了方便整合使用,我们往往把它作为嵌入资源的方式,放在一个文件里面,如下所示。
需要的时候,直接导入这个core_image进行使用即可。
import core.core_images as images
img: wx.Image = (
images.catalog[name].Image if name in images.catalog else result
)
img = img.Scale(icon_size, icon_size, wx.IMAGE_QUALITY_HIGH)
result = wx.Bitmap(img)
为了方便添加,我们可以使用wxpython的内置工具类img2py来生成代码到指定.py文件中。
from wx.tools import img2py
然后可以通过命令行来生成代码到python类文件中。
"-a -F -n TestStar2 bmp_source/teststar.png images.py"
需要详细了解各个参数的意思,可以查看 img2py.py 例子代码的说明即可。
我为了方便,参考修改编写了一个独立的工具类来方便生成所需的代码。
我可以再文件目录中选择所需的文件,然后右键复制文件地址,把它们路径复制出来。
2、图标的选择界面及使用
前面介绍了两种不同的图标资源库,我们应该再框架系统中能够顺利使用它们,以便为我们的工具栏、菜单、按钮等地方添加有趣而有意义的图标,比单纯的文本会好看很多。
如列表界面中的工具栏、按钮都采用了和内容一致的图标,比较美观一些。
有时候,我们右键菜单也可以根据图表库选择一致意义的图标。
表格显示的右键菜单
或者树形列表的右键菜单
因此我们在系统中统一展示和选择图标操作,如下所示,包括自定义图标,也包括内置图标。
自定义图标可以根据需要进行添加到内置资源的类即可,图标来源很多,网上也有很多,可以参考一下下面的这个网址获取一些:www.iconarchive.com/
在里面搜索关键字下载自己所需图标即可。
为了统一通过名称获取图标信息,我们可以编写一个通用的处理图标的函数来处理,如下函数。
def get_bitmap(name: str, icon_size: int = 32) -> wx.Bitmap:
"""获取位图,可以根据images里面的内容,或者是内置的wx.ART_XXX"""
result = wx.ArtProvider.GetBitmap(
wx.ART_FOLDER, wx.ART_OTHER, (icon_size, icon_size)
)
try:
if name is None or name == "":
return result
if name.startswith("wx.ART_"):
result = wx.ArtProvider.GetBitmap(
eval(name), wx.ART_OTHER, (icon_size, icon_size)
)
else:
img: wx.Image = (
images.catalog[name].Image if name in images.catalog else result
)
img = img.Scale(icon_size, icon_size, wx.IMAGE_QUALITY_HIGH)
result = wx.Bitmap(img)
except Exception as e:
print(f"get_bitmap 调用错误: {e},没有找到{name}的图片")
return result
这样我们在创建按钮、菜单的时候,使用这个生成图标位图的辅助函数即可通用了。
button = wx.Button(parent, id, btn_name)
button.Enable(enable)
if icon_name:
button.SetBitmap(get_bitmap(icon_name, icon_size))
button.SetBitmapPosition(wx.LEFT) # 可以设置 LEFT, RIGHT, TOP, BOTTOM