Question

有时候，使用一组图片是非常方便的.这时候，你可以直接在你的代码中使用 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 大小的图标的图标集。