IconView and ListView / 图标与列表菜单

IconView 和 ListView 都是完整的 IApplication，不是需要放进另一个 App 里的 Widget。

IconView

IconView 适合少量带 XBM 图标的项目。下面用一个具体派生类提供配置：

class ToolMenu final : public IconView {
public:
    ToolMenu(PixelUI& ui, void*) : IconView(ui) {
        IconItemList items;
        items.emplace_back("Clock", clockBits, nullptr);
        items.emplace_back("Counter", counterBits, nullptr);
        setItems(items);
        setTitle("< Tools >");
        enableProgressBar(true);
        enableStatusText(true);
        enableSelectedItemTitle(true);

        setSelectionCallback([this](int index, const IconItem&) {
            selected_ = index;
        });
    }

private:
    int selected_ = 0;
};

IconItemList 是 etl::vector<IconItem, MAX_ICONVIEW_ITEMS>。title、bitmap 和 userData 都是非拥有指针，不要指向短寿命局部数据。AppLauncher 就是 IconView 的一个现成用法。

ListView

ListView 适合设置项、布尔开关、整数/浮点值和多级子菜单。它是抽象类，派生类必须实现 onLoad() 和 onSave()：

class SettingsView final : public ListView {
public:
    SettingsView(PixelUI& ui, ListItem* items, int count)
        : ListView(ui, items, count) {}

    void onLoad() override {
        // 从存储中读取到 ListItemExtra 指向的状态。
    }

    void onSave() override {
        // 把已更改状态写回存储。
    }
};

bool soundEnabled = true;
int32_t brightness = 60;

ListItem items[] = {
    {.title = "Sound", .extra = {.switchValue = &soundEnabled}},
    {.title = "Brightness", .extra = {.intValue = &brightness}},
    {.title = "About", .pFunc = []() { open_about(); }},
};

ListItem 还可以用 nextList + nextListLength 指向子菜单。历史栈最大深度由 PIXELUI_MAX_LISTVIEW_DEPTH 限制。所有 ListItem、子列表、title 内容以及 extra 指针指向的数据都必须比 ListView 活得更久。

ListView 当前的列表数组 API 仍然较低层，使用前建议先参考主仓库 examples/ListViewDemo1.cpp。长度必须大于 0，不要用空数组构造它。