wxWidgets常用组件和布局——下

wxDataViewTreeCtrl

wxDataViewTreeCtrl 是 wxWidgets 中的一个高级控件，用于显示树形结构的数据，并支持多列视图（类似于 wxTreeCtrl 但功能更强大）。它是 wxDataViewCtrl 的子类，结合了树形控件和列表控件的特性。

核心特性

1. 树形结构

   • 支持父子节点的层级关系（可展开/折叠）。
   • 每个节点可以包含子节点或数据项。

2. 多列支持

   • 不同于传统的 wxTreeCtrl，它可以为每个节点显示多列数据（例如：名称、大小、修改日期等）。

3. 数据模型分离

   • 使用 wxDataViewModel（或其子类 wxDataViewTreeStore）管理数据，实现数据与视图的解耦。

4. 自定义渲染

   • 通过 wxDataViewRenderer 自定义单元格的显示方式（如文本、图标、进度条等）。

5. 编辑支持

   • 允许用户直接编辑节点内容（需配置可编辑的渲染器）。

典型用途

• 文件浏览器（显示目录结构及文件属性）。
• 数据库导航（表、字段的层级展示）。
• 配置项的多列分类管理。

基础用法示例

// 创建控件
wxDataViewTreeCtrl* treeCtrl = new wxDataViewTreeCtrl(this, wxID_ANY);

// 添加根节点
wxDataViewItem root = treeCtrl->AppendContainer(wxDataViewItem(), "Root");

// 添加子节点
wxDataViewItem child1 = treeCtrl->AppendItem(root, "Child 1");
wxDataViewItem child2 = treeCtrl->AppendContainer(root, "Child Folder");

// 添加多列数据（需自定义模型或使用 Store）
treeCtrl->GetStore()->SetItemText(child1, "Additional Info", 1); // 第2列

与 wxTreeCtrl 的区别

特性	wxDataViewTreeCtrl	wxTreeCtrl
多列支持	✔️ 是	❌ 否
数据模型	分离（Model-View 架构）	直接操作控件
性能	更适合大数据量（虚拟模式）	小数据量更简单
编辑灵活性	支持自定义渲染器和编辑器	仅简单文本编辑

注意事项

• 需要显式关联数据模型（默认使用 wxDataViewTreeStore）。
• 复杂功能（如多列排序）需通过继承 wxDataViewModel 实现。
• 在 macOS 上，原生实现可能与其他平台的行为有细微差异。

如果需要动态更新数据或处理大量节点，建议深入研究 wxDataViewModel 的虚拟方法（如 GetValue/SetValue）。

---

wxEditableListBox

概述

wxEditableListBox 是 wxWidgets 提供的一个复合控件，它结合了可编辑的条目列表和一组用于管理这些条目的按钮（如添加、删除、上移、下移等）。常用于需要用户动态管理一组字符串或项目的场景（如配置项列表、标签管理等）。

核心特性

1. 条目管理

   • 内置 wxListCtrl 或类似组件显示条目。
   • 提供按钮组（通常包括：Add、Remove、Up、Down）。

2. 交互模式

   • 用户可通过双击或按钮编辑条目。
   • 支持拖拽排序（依赖平台实现）。

3. 数据绑定

   • 通过 GetStrings() 和 SetStrings() 方法直接操作字符串列表。

重要方法

方法	作用
GetStrings()	返回当前所有条目的 wxArrayString
SetStrings()	用 wxArrayString 设置条目内容
GetListCtrl()	获取内部列表控件（进一步自定义操作）

事件

• EVT_LIST_END_LABEL_EDIT：条目编辑完成时触发。
• 按钮事件通常由控件内部处理，无需手动绑定。

示例代码

wxEditableListBox* listBox = new wxEditableListBox(
    parent, wxID_ANY, "Items", 
    wxDefaultPosition, wxDefaultSize
);

// 设置初始条目
wxArrayString items;
items.Add("First");
items.Add("Second");
listBox->SetStrings(items);

// 获取修改后的条目
wxArrayString updatedItems = listBox->GetStrings();

适用场景

• 动态配置参数列表（如服务器地址、文件路径等）。
• 允许用户自定义排序的选项集合。

注意事项

• 平台差异：按钮布局和外观可能因操作系统而异。
• 性能：大量条目（如 >1000）时建议改用虚拟化控件（如 wxDataViewCtrl）。

---

wxFileCtrl

概述

wxFileCtrl 是 wxWidgets 提供的文件选择控件，用于在图形界面中浏览、选择和操作文件系统中的文件和目录。它通常作为文件对话框的替代方案，适用于需要将文件选择功能直接嵌入到窗口中的场景。

核心特性

1. 嵌入式文件浏览

   • 与独立对话框（如 wxFileDialog）不同，wxFileCtrl 可直接嵌入到任何窗口或面板中，提供持久的文件浏览界面。

2. 视图模式支持

   • 支持多种显示模式（如列表、图标、详细信息视图），可通过 SetViewMode() 调整。
   • 示例模式：
     • wxFC_DETAILS_VIEW（默认，显示文件详情）
     • wxFC_LIST_VIEW（简单列表）
     • wxFC_ICON_VIEW（图标形式）

3. 筛选与目录控制

   • 通过 SetFilter() 设置文件类型筛选（如 "Text files (*.txt)|*.txt"）。
   • 使用 SetDirectory() 和 GetDirectory() 控制当前浏览目录。

4. 多选支持

   • 启用 wxFC_MULTIPLE 样式后允许用户选择多个文件。

重要方法

• GetFilenames()
  返回用户选中的文件名列表（wxArrayString 类型）。
• SetPath() / GetPath()
  直接设置或获取当前选中的完整文件路径。
• SetWildcard()
  动态更新文件筛选模式（如 "*.png"）。

事件处理

常用事件类型：

• wxEVT_FILECTRL_FILEACTIVATED
  当用户双击文件时触发。
• wxEVT_FILECTRL_SELECTIONCHANGED
  选中文件变化时触发。

绑定示例：

fileCtrl->Bind(wxEVT_FILECTRL_FILEACTIVATED, [](wxFileCtrlEvent& event) {
   
   
    wxLogMessage("已激活文件: %s", event.GetFile());
});

典型用法

wxFileCtrl* fileCtrl = new wxFileCtrl(
    this,                               // 父窗口
    wxID_ANY,                           // 控件ID
    wxEmptyString,                      // 初始目录（空表示当前目录）
    wxDefaultPosition,                  // 位置
    wxSize(500, 300),                   // 大小
    wxFC_DEFAULT_STYLE | wxFC_MULTIPLE  // 样式
);
fileCtrl->SetFilter("Images (*.jpg, *.png)|*.jpg;*.png");

注意事项

• 平台差异
  在 macOS 上可能使用原生文件控件，行为可能与 Windows/Linux 略有不同。
• 性能
  加载包含大量文件的目录时，建议在后台线程中操作以避免界面卡顿。

替代方案

若仅需简单文件选择，可考虑 wxFileDialog；若需更复杂功能（如缩略图预览），可能需要自定义实现或结合 wxGenericDirCtrl。

---

wxGauge

概述

wxGauge 是 wxWidgets 框架中用于显示进度条的控件类。它通常用于表示长时间操作的进度（如下载、文件处理等），通过可视化方式向用户反馈当前进度。

核心特性

1. 进度范围

   • 通过 SetRange(int range) 设置最大值（默认 100）。
   • 例如 gauge->SetRange(500) 表示进度条最大值为 500。

2. 当前值

   • SetValue(int pos) 更新当前进度（需在范围内）。
   • GetValue() 获取当前进度值。

3. 方向与样式

   • 支持水平（wxGA_HORIZONTAL，默认）或垂直（wxGA_VERTICAL）方向。
   • 部分平台支持不确定模式（wxGA_PROGRESS），用于未知时长的操作。

4. 外观控制

   • 可通过 wxWindow::SetBackgroundColour() 修改背景色。
   • 某些平台（如 GTK+）可能忽略自定义样式。

典型用法

// 创建进度条
wxGauge* gauge = new wxGauge(this, wxID_ANY, 100, wxPoint(10, 10), wxSize(200, 30));

// 更新进度
gauge->SetValue(50);  // 设置为50%

跨平台说明

• Windows/macOS：显示为平滑填充条。
• GTK+：样式可能受系统主题影响。
• 不确定模式：macOS 显示为动态条纹，Windows 需手动实现动画。

注意事项

• 频繁更新（如循环中）建议使用 wxYield() 或 wxApp::ProcessPendingEvents() 保持UI响应。
• 垂直进度条在部分旧版系统中可能渲染异常。

相关类

• wxProgressDialog：带取消按钮的进度对话框。
• wxStatusBar：可嵌入简易进度条的状态栏。

---

wxGenericDirCtrl

wxGenericDirCtrl 是 wxWidgets 提供的一个通用目录控制组件，用于显示和浏览文件系统的目录结构。它是 wxDirCtrl 的通用实现版本，通常作为文件选择对话框的基础控件。

主要特性

1. 目录树显示

   • 以树形结构显示文件系统的目录层次
   • 支持展开/折叠目录节点
   • 可显示文件系统根目录（如 Windows 的驱动器或 Unix 的挂载点）

2. 文件过滤

   • 支持通过通配符（如 *.txt）过滤显示的文件类型
   • 可通过 wxDirFilterListCtrl 配合实现更复杂的过滤逻辑

3. 自定义样式

   • 支持 wxDIRCTRL_DIR_ONLY 样式（仅显示目录）
   • 支持 wxDIRCTRL_MULTIPLE 样式（允许多选）

4. 事件处理

   • 触发 wxEVT_DIRCTRL_SELECTIONCHANGED 事件（选中项变化时）
   • 触发 wxEVT_DIRCTRL_FILEACTIVATED 事件（双击文件时）

典型用法

// 创建控件
wxGenericDirCtrl* dirCtrl = new wxGenericDirCtrl(
    this,                               // 父窗口
    wxID_ANY,                           // 控件ID
    wxDirDialogDefaultFolderStr,        // 初始路径
    wxDefaultPosition,                  // 位置
    wxDefaultSize,                      // 大小
    wxDIRCTRL_3D_INTERNAL | wxSUNKEN_BORDER // 样式
);

// 设置过滤器
dirCtrl->SetFilter("Text files (*.txt)|*.txt|All files (*.*)|*.*");

// 绑定事件
dirCtrl->Bind(wxEVT_DIRCTRL_SELECTIONCHANGED, [](wxTreeEvent& event) {
   
   
    wxLogMessage("Selected: %s", event.GetPath());
});

与 wxDirCtrl 的关系

• wxGenericDirCtrl 是跨平台的通用实现
• wxDirCtrl 在某些平台（如 Windows）可能使用原生控件
• 当需要最大兼容性时优先使用 wxGenericDirCtrl

注意事项

1. 首次显示大型目录时可能需要性能优化
2. 虚拟文件系统（如 ZIP 挂载）需要额外处理
3. 在 macOS 上可能需要特殊样式适配

扩展功能

可通过继承实现：

• 自定义图标（重写 GetIcon()）
• 异步加载（后台线程扫描目录）
• 虚拟文件系统集成

---

wxGrid

概述

wxGrid 是 wxWidgets 中用于显示和编辑表格数据的核心控件，提供类似电子表格的功能。支持：

• 行列操作（增删改）
• 单元格格式控制（文本/数字/自定义渲染）
• 数据排序和选择
• 键盘/鼠标交互

核心特性

1. 数据模型

• wxGridTableBase：抽象基类，需派生实现 GetValue()/SetValue() 等核心方法
• wxGridStringTable：内置的字符串数据模型，适合简单场景
• 自定义模型示例：

  class CustomTable : public wxGridTableBase {
       
       
      virtual wxString GetValue(int row, int col) override {
       
       
          return wxString::Format("R%dC%d", row+1, col+1);
      }
      // 必须实现 GetNumberRows/Cols 等方法
  };
  

2. 单元格控制

• 属性设置：

  grid->SetCellValue(0, 0, "Hello");
  grid->SetCellTextColour(0, 0, *wxRED);
  grid->SetCellBackgroundColour(0, 0, *wxLIGHT_GREY);
  

• 渲染器（wxGridCellRenderer）：
  • 内置：字符串/数字/布尔/浮点数等
  • 自定义渲染需重写 Draw() 方法

3. 事件处理

关键事件类型：

• wxEVT_GRID_CELL_LEFT_CLICK
• wxEVT_GRID_CELL_CHANGED
• wxEVT_GRID_LABEL_RIGHT_CLICK（行列标签点击）

绑定示例：

grid->Bind(wxEVT_GRID_CELL_CHANGED, [](wxGridEvent& e) {
   
   
    wxLogMessage("Cell (%d,%d) changed", e.GetRow(), e.GetCol());
});

高级功能

• 冻结行列：FreezeTo() + SetFrozenBorderColour()
• 拖拽调整：EnableDragRowSize()/EnableDragColSize()
• 选择模式：

  grid->SetSelectionMode(wxGrid::wxGridSelectRows);  // 整行选择
  

• 键盘导航：方向键/Tab键控制焦点移动

性能优化

• 大数据集时：
  1. 使用 BeginBatch()/EndBatch() 包裹批量操作
  2. 实现虚拟表格（继承 wxGridTableBase 并重写 CanHaveAttributes() 返回 false）
  3. 禁用自动调整：AutoSizeColumns(false)

典型问题

• 闪烁问题：启用双缓冲 SetDoubleBuffered(true)
• 中文乱码：确保使用 wxConvUTF8 或正确编码转换
• 自定义编辑器：继承 wxGridCellEditor 实现 Create()/BeginEdit() 等方法

代码片段

创建基础表格：

wxGrid* grid = new wxGrid(parent, wxID_ANY);
grid->CreateGrid(50, 10);  // 50行10列
grid->SetColLabelValue(0, "ID");
grid->SetCellRenderer(0, 0, new wxGridCellBoolRenderer);

---

wxHeaderCtrl

概述

wxHeaderCtrl 是 wxWidgets 中用于显示和管理表格/列表列标题的控件基类。它通常作为 wxDataViewCtrl 或 wxListCtrl 的标题栏使用，提供列排序、调整大小、拖动等功能。

核心特性

1. 列管理

   • 支持动态添加/删除列 (AddColumn(), DeleteColumn()