10.6 图片列表和图标集

有时候,使用一组图片是非常方便的.这时候,你可以直接在你的代码中使用wxImageList,也可以和wxWidgets提供的一些控件一起使用 wxImageList,wxNotebook,wxtreeCtrl和wxListCtrl都需要wxImageList来管理它们所需要使用的图标. 你也可使用wxImageList中的某个单独的图片在设备上下文上绘画.

创建一个wxImageList需要的参数包括单个图片的宽度和高度,一个bool值来指定是否需要指定图片遮罩,以及这个图片列表的初始大小(主要是为了内部优化代码),然后一个一个的增加wxBitmap对象或者wxIcon对象.wxImageList不能直接使用wxImage 对象,你需要先将其转换为wxBitmap对象.wxImageList::Add函数返回一个整数的索引用来代表这个刚增加的图片,在Add函数成功返回以后,你就可以释放原始图片了,wxImageList已经在内部创建了一个这个图片的拷贝.

下面是创建wxImageList以及在其中增加图片的一些例子:

// 创建一个wxImageList
wxImageList *imageList = new wxImageList(16, 16, true, 1);
// 增加一个透明的PNG文件
wxBitmap bitmap1(wxT("image.png"), wxBITMAP_TYPE_PNG);
imageList->Add(bitmap1);
// 增加一个透明的来自别的bitmap的图片
wxBitmap bitmap2(wxT("image.bmp"), wxBITMAP_TYPE_BMP);
wxBitmap maskBitmap(wxT("mask.bmp"), wxBITMAP_TYPE_BMP);
imageList->Add(bitmap2, maskBitmap);
// 增加一个指定透明颜色的透明图片
wxBitmap bitmap3(wxT("image.bmp"), wxBITMAP_TYPE_BMP);
imageList->Add(bitmap3, *wxRED);
// 增加一个图标
#include "folder.xpm"
wxIcon icon(folder_xpm);
imageList->Add(icon);

你可以直接把wxImageList中的图片绘制在设备上下文上,通过指定wxIMAGELIST_DRAW_TRANSPARENT类型来指示绘制透明图片,你还可以指定的类型包括wxIMAGELIST_DRAW_NORMAL, wxIMAGELIST_DRAW_SELECTED或者wxIMAGELIST_DRAW_FOCUSED,用来表征图片的状态,如下所示:

// 绘制列表中所有的图片
wxClientDC dc(window);
size_t i;
for (i = 0; i < imageList->GetImageCount(); i++)
{
    imageList->Draw(i, dc, i*16, 0, wxIMAGELIST_DRAW_NORMAL|
                                    wxIMAGELIST_DRAW_TRANSPARENT);
}

要把图片列表和notebook的TAB页面绑定在一起,你需要创建一个包含大小为16x16的图片的列表,然后调用 wxNotebook::SetImageList或者wxNotebook::AssignImageList将其和某个wxNotebook绑定,这两个函数的区别在于,前者在wxNotebook释放的时候不释放列表,而后者在自己被释放的时候,会同时释放图片列表.指定完图片列表以后,你就可以给某个页面指定图标索引以便在页面标签上显示图标了,下面的代码演示了这个过程:

//创建一个wxImageList
wxImageList *imageList = new wxImageList(16, 16, true, 1);
// 增加一些图标
wxBitmap bitmap1(wxT("folder.png"), wxBITMAP_TYPE_PNG);
wxBitmap bitmap2(wxT("file.png"), wxBITMAP_TYPE_PNG);
int folderIndex = imageList->Add(bitmap1);
int fileIndex = imageList->Add(bitmap2);
// 创建一个拥有两个页面的notebook
wxNotebook* notebook = new wxNotebook(parent, wxID_ANY);
wxPanel* page1 = new wxPanel(notebook, wxID_ANY);
wxPanel* page2 = new wxPanel(notebook, wxID_ANY);
// 绑定图片列表
notebook->AssignImageList(imageList);
// Add the pages, with icons
notebook->AddPage(page1, wxT("Folder options"), true, folderIndex);
notebook->AddPage(page2, wxT("File options"), false, fileIndex);

wxtreeCtrl和wxListCtrl的使用方法和上面介绍的非常相似,也包含类似的两种绑定方法.

如果你拥有很多图标,有时候很难通过索引来对应到具体的图标,你可能想编写一个类以便通过字符串来找到某个图片索引.下面演示了基于这个目的的一个简单的实现:

#include "wx/hashmap.h"
WX_DECLARE_STRING_HASH_MAP(int, IconNameToIndexHashMap);
// 通过名字引用图片的类
class IconNameToIndex
{
public:
    IconNameToIndex() {}
    // 在图片列表中增加一个已经命名的图片
    void Add(wxImageList* list, const wxBitmap& bitmap,
        const wxString& name) {
        m_hashMap[name] = list->Add(bitmap);
    }
    // 在图片列表中增加一个已命名的图标
    void Add(wxImageList* list, const wxIcon& icon,
        const wxString& name) {
        m_hashMap[name] = list->Add(icon);
    }
    // 通过名称找到索引
    int Find(const wxString& name) { return m_hashMap[name]; }
private:
    IconNameToIndexHashMap m_hashMap;
};

wxIconBundle类同样也是一个图片列表,不过这个类的目的是为了将多个不同分辨率的图标保存在一个类中而不是多个类中,以便系统在合适的时候根据不同的使用目的选择一个特定的图标.比如,在资源管理器中的图标通常比在主窗口标题栏上显示的图标要大的多.下面的例子演示了其用法:

// 创建一个只有单个16x16图标的图片集
#include "file16x16.xpm"
wxIconBundle iconBundle(wxIcon(file16x16_xpm));
// 在图片集中增加一个32x32的图片
iconBundle.Add(wxIcon(wxT("file32x32.png"), wxBITMAP_TYPE_PNG));
// 从一个包含多个图片的文件中创建一个图片集
wxIconBundle iconBundle2(wxT("multi-icons.tif"), wxBITMAP_TYPE_TIF);
// 从图片集中获取指定大小的图片,如果找不到则继续寻找
// wxSYS_ICON_X, wxSYS_ICON_Y大小的图片
wxIcon icon = iconBundle.GetIcon(wxSize(16,16));
// 将图片集指定给某个主窗口
wxFrame* frame = new wxFrame(parent, wxID_ANY);
frame->SetIcons(iconBundle);

在windows系统上,SetIcons函数期待一个包含16x16和32x32大小的图标的图标集.