emWin控件实战：TEXT与TREEVIEW在嵌入式GUI中的高效应用

1. 项目概述：从手册到实战，深度解析emWin的TEXT与TREEVIEW控件

在嵌入式GUI开发中，我们常常会面对官方手册——它们详尽、准确，但有时也显得冰冷和碎片化。手册告诉你TEXT_SetTextColor()的语法，但不会告诉你什么时候该用透明背景，什么时候该用纯色背景来优化渲染性能；手册列出了TREEVIEW_InsertItem()的所有参数，但不会分享如何高效地管理动态变化的树形数据，避免内存碎片。今天，我想结合自己多年在资源受限的MCU上折腾emWin的经验，和你深入聊聊TEXT和TREEVIEW这两个看似基础，实则“坑”点不少的核心控件。我们不止步于API函数的罗列，而是要拆解其设计哲学，分享那些在真实项目中才能踩出来的“坑”和总结出的高效用法。无论你是在为智能家居面板设计菜单，还是在工业HMI上构建文件浏览器，理解这两个控件的里里外外，都能让你的开发事半功倍。

2. TEXT控件：不止于“显示文字”

TEXT控件是emWin中最基础的构件之一，它的主要职责就是显示一段静态或动态的文本。但“基础”绝不意味着“简单”。一个设计良好的文本显示，涉及到字体渲染、内存管理、刷新效率等多个层面。

2.1 核心创建与销毁：理解句柄与生命周期

在emWin中，几乎所有控件对象都通过“句柄”来管理。你可以把句柄理解为一个遥控器，你通过它来操控电视（控件），而不需要直接去拆解电视内部的电路。

直接创建TEXT_CreateEx()是最灵活的方式，它允许你指定控件的精确位置、大小、父窗口、窗口标志、扩展标志和ID。这里有几个关键点：

• WinFlags：最常用的是WM_CF_SHOW，创建后立即显示。如果你的界面是分步初始化的，可以先不加这个标志，等所有控件布局完成后再用WM_ShowWindow()统一显示，能避免屏幕闪烁。
• ExFlags：这是TEXT控件的精髓所在，主要用于文本对齐。例如，TEXT_CF_HCENTER | TEXT_CF_VCENTER可以实现文本在控件矩形区域内的水平和垂直居中。对齐是在控件区域内进行的，所以确保控件大小足够容纳文本（考虑换行）非常重要。

间接创建TEXT_CreateIndirect()通常与GUIBuilder工具或手动定义的资源表一起使用。它将创建参数（坐标、大小、标志等）打包在一个GUI_WIDGET_CREATE_INFO结构体数组中。这种方式将UI描述与业务逻辑分离，特别适合界面布局相对固定的项目。修改界面时，只需调整资源表，无需重新编译大量C代码。

实操心得：选择创建方式对于小型项目或快速原型，直接创建更直观。对于中大型项目，尤其是需要支持多语言、皮肤切换的，强烈推荐使用间接创建。你可以为不同语言或主题准备不同的资源表，运行时动态切换，代码结构会清晰很多。

2.2 文本属性设置：细节决定专业度

设置文本属性是TEXT控件的日常。手册列出了Set和Get两套函数，这里我强调几个容易忽略但影响巨大的细节。

字体设置TEXT_SetFont()：emWin支持等宽字体和比例字体。在显示数字、代码等需要对齐的场景，使用等宽字体（如GUI_Font8x16）是更好的选择。切换字体是一个相对耗时的操作，因为它可能触发控件的重绘和布局重新计算。切忌在每帧刷新中频繁切换字体。

颜色设置TEXT_SetBkColor(), TEXT_SetTextColor()：

• 背景色：设置为GUI_INVALID_COLOR可以使背景透明。这在你需要将文本叠加在图片或其他控件上时非常有用。但请注意，透明窗口的渲染效率通常低于非透明窗口，因为需要混合图层。如果性能是关键，且背景是纯色，直接设置为该颜色是更优解。
• 文本色：确保与背景色有足够的对比度。在光照强烈的户外设备上，可能需要使用高对比度配色（如白底黑字），而在暗光环境下，低亮度的配色（如深灰底浅灰字）更舒适。

文本旋转TEXT_SetRotation()：这个功能在某些垂直显示或特殊角度的屏幕上非常有用。但旋转操作本身涉及像素重采样，会消耗一定的CPU资源。对于需要频繁更新或大量存在的文本，应谨慎使用旋转功能，或者考虑直接使用预先旋转好的字体。

文本换行模式TEXT_SetWrapMode()：当文本长度超过控件宽度时，换行模式决定了如何显示。GUI_WRAPMODE_WORD会尝试在单词边界处换行，显示效果更美观；GUI_WRAPMODE_CHAR则在字符边界换行，算法更简单。如果你的文本包含长英文单词，使用WORD模式可能导致一行只显示一个单词，剩余空间浪费。这时可以结合TEXT_GetNumLines()动态调整控件高度，实现自适应布局。

// 一个设置文本并自适应高度的示例片段 TEXT_Handle hText; char buffer[64]; sprintf(buffer, "Current Temperature: %.1f°C", temperature); TEXT_SetText(hText, buffer); // 获取当前文本所需行数 int numLines = TEXT_GetNumLines(hText); // 获取当前字体高度 const GUI_FONT* pFont = TEXT_GetFont(hText); int fontHeight = GUI_GetFontDistY(pFont); // 计算新的控件高度（留一些边距） int newHeight = numLines * fontHeight + 4; WM_ResizeWindow(hText, WM_GetWindowSizeX(hText), newHeight);

2.3 动态内容更新：性能与稳定性的权衡

TEXT控件常用来显示实时变化的数据，如传感器读数、系统状态等。

直接设置文本TEXT_SetText()：这是最常用的方法。但需要注意，频繁调用此函数（例如在高速定时器中断中）会导致界面频繁重绘，可能引发闪烁或系统响应迟缓。一个优化策略是节流更新：在内存中维护一个当前显示值的副本，只有在新值与旧值不同时，才调用TEXT_SetText()。

格式化数字显示TEXT_SetDec()：这个函数非常实用，它直接接受一个整型值，并帮你格式化成字符串显示。参数Len（总位数）、Shift（小数点位置）、Signed（是否显示符号）、Space（是否用空格填充前导零）给了你精细的控制能力。例如，显示一个范围0-999的整数，固定3位，可以设为TEXT_SetDec(hText, value, 3, 0, 0, 1)，这样“7”会显示为“ 7”（前面两个空格），保持了数字的右对齐，视觉上更整齐。

避坑指南：字符串缓冲区溢出无论是TEXT_SetText()还是TEXT_GetText()，都要确保你提供的字符串缓冲区足够大，能容纳文本及其终止符。TEXT_GetText()的BufferSize参数应至少为strlen(text) + 1。一个健壮的做法是，先用TEXT_GetText()传入NULL和0来获取所需长度，再动态分配或使用足够大的静态缓冲区。

3. TREEVIEW控件：构建层次化信息视图

TREEVIEW控件是展示树形结构数据的利器，比如文件系统目录、设备参数菜单、组织架构图等。它的核心概念是项，每个项要么是节点（可展开/折叠，包含子项），要么是叶子（终端项，无子项）。

3.1 控件创建与全局配置

创建TREEVIEW与创建TEXT类似，但其ExFlags主要用于控制初始的选择模式：

• TREEVIEW_CF_ROWSEL：整行高亮选中。视觉反馈更明显。
• TREEVIEW_CF_TEXTSEL：仅文本部分高亮选中。更节省空间，风格更简约。
• 默认（无标志）：通常等同于文本选中，但具体行为可能依赖皮肤。

在创建控件后，通常需要进行一系列全局配置，这些设置会影响控件内所有项的外观：

设置图像TREEVIEW_SetImage()：这是定制TREEVIEW外观的关键。你需要提供一个包含6个位图句柄的数组，分别对应：

1. 节点折叠时的项图像
2. 节点展开时的项图像
3. 叶子项的图像
4. 折叠按钮的“+”号图像
5. 展开按钮的“-”号图像
6. （保留，通常为0）

如果你不设置，emWin会使用内置的简单“+/-”符号和默认图标。为了界面美观，建议根据项目风格设计一套小图标（例如16x16像素）。使用GUI_CreateBitmapFromStream()或GUI_BITMAP结构来加载和管理这些位图资源。

连接线TREEVIEW_SetHasLines()：默认启用，用线条连接项，清晰展示层级关系。在层级很深或项很多时，线条可能会让界面显得杂乱。对于扁平化设计风格，可以关闭线条。

缩进TREEVIEW_SetIndent()和TREEVIEW_SetTextIndent()：SetIndent控制每一级子项相对于父项的整体缩进（包括按钮和图标）。SetTextIndent控制文本相对于其项图标的缩进。合理调整这两个值，可以优化不同字体和图标大小下的视觉层次感。

3.2 项的生命周期管理：构建与遍历树形结构

TREEVIEW的核心操作是围绕“项”进行的。每个项都有一个唯一的句柄TREEVIEW_ITEM_Handle。

创建与插入项TREEVIEW_InsertItem()：这是最常用的构建树的方法。你需要指定：

• IsNode:TREEVIEW_ITEM_IS_NODE或TREEVIEW_ITEM_IS_LEAF。
• hItemPrev和Position: 这两个参数共同决定了新项的插入位置。例如：
  • TREEVIEW_INSERT_FIRST_CHILD, hParentItem: 作为hParentItem的第一个子项插入。
  • TREEVIEW_INSERT_AFTER, hSiblingItem: 在兄弟项hSiblingItem之后插入。
  • 要插入根项，hItemPrev设为0，Position设为TREEVIEW_INSERT_FIRST。

高效的树构建模式：对于静态树（如菜单），通常采用自顶向下、深度优先的方式构建。先创建根节点，然后循环创建其子节点。对于动态树（如文件浏览器），可能需要用到TREEVIEW_AttachItem()，它允许你将一个已创建好的子树（可能是在后台线程中构建的）附加到主树的某个节点下，这样可以避免在UI线程中进行耗时的文件遍历操作，提升界面响应速度。

遍历与查找TREEVIEW_GetItem()：这是导航树的瑞士军刀。通过组合hItem和Flags，你可以获取任何你想要的项：

• TREEVIEW_GET_FIRST: 获取树的第一个顶级项（传入hItem=0）。
• TREEVIEW_GET_NEXT_SIBLING: 获取下一个兄弟项。
• TREEVIEW_GET_FIRST_CHILD: 获取第一个子项。
• TREEVIEW_GET_PARENT: 获取父项。

一个典型的遍历所有可见项的代码如下（深度优先）：

void TraverseTree(TREEVIEW_Handle hObj, TREEVIEW_ITEM_Handle hItem) { if (hItem == 0) { // 从第一个根项开始 hItem = TREEVIEW_GetItem(hObj, 0, TREEVIEW_GET_FIRST); } while (hItem) { // 处理当前项 hItem ProcessItem(hObj, hItem); // 先尝试进入第一个子项（深度优先） TREEVIEW_ITEM_Handle hChild = TREEVIEW_GetItem(hObj, hItem, TREEVIEW_GET_FIRST_CHILD); if (hChild) { TraverseTree(hObj, hChild); // 递归遍历子树 } // 然后处理下一个兄弟项 hItem = TREEVIEW_GetItem(hObj, hItem, TREEVIEW_GET_NEXT_SIBLING); } }

展开与折叠TREEVIEW_ITEM_Expand()/TREEVIEW_ITEM_Collapse()：除了响应用户点击，你可以在代码中控制节点的状态。例如，在恢复用户上次的界面状态时，可以遍历树并根据保存的数据展开特定节点。ExpandAll和CollapseAll是递归操作，对于大型树要小心使用，可能会引起明显的界面卡顿。

3.3 交互、选择与滚动

选择项TREEVIEW_SetSel()/TREEVIEW_GetSel()：设置或获取当前选中的项。当选择改变时，控件会向父窗口发送WM_NOTIFICATION_SEL_CHANGED消息。你应该在父窗口的回调函数中处理这个消息，以更新其他关联的界面内容（例如，在右侧详情面板显示选中文件的信息）。

键盘导航：TREEVIEW内置了对方向键的支持（见手册表格），这对于无触摸屏的设备（如旋钮+按键操作）至关重要。你需要确保TREEVIEW控件通过WM_SetFocus()获得了焦点，键盘事件才能生效。你可以通过TREEVIEW_IncSel()和TREEVIEW_DecSel()在代码中模拟键盘导航。

滚动至选中项TREEVIEW_ScrollToSel()：当通过代码（而非用户点击）改变选中项时，该项可能不在当前可视区域内。调用此函数可以自动滚动控件，确保选中项可见。这是一个提升用户体验的小细节。

自动滚动条TREEVIEW_SetAutoScrollH()/TREEVIEW_SetAutoScrollV()：默认情况下，当内容超出显示范围时，滚动条会自动出现。但在某些固定布局的界面中，你可能希望始终显示或始终隐藏滚动条。注意，启用自动滚动条会占用额外的控件区域空间。

3.4 高级技巧：用户数据与自定义绘制

绑定用户数据TREEVIEW_ITEM_SetUserData()：这是TREEVIEW控件最强大的功能之一。每个项都可以关联一个32位的用户数据（U32类型）。你可以把任何与该项相关的信息存进去，比如：

• 对于文件浏览器，存储文件的完整路径指针（转换为U32）。
• 对于参数菜单，存储该参数在配置结构体中的偏移量或枚举值。
• 对于一个函数调用项，存储一个函数指针。

当用户选中某项时，你通过TREEVIEW_GetSel()获取句柄，再通过TREEVIEW_ITEM_GetUserData()取出数据，就能直接进行后续业务逻辑处理，无需再进行耗时的字符串比较或全局查找。

自定义绘制TREEVIEW_SetOwnerDraw()：如果你对默认的项外观（文本+图标）不满意，可以启用所有者绘制模式。你需要处理WM_PAINT消息，并自己绘制项的全部内容。这给了你无限的定制自由，比如绘制渐变背景、添加复选框、显示额外信息等，但同时也意味着你需要负责所有的绘制逻辑和性能优化，复杂度较高。

4. 实战应用：构建一个文件浏览器视图

理论说再多，不如看一个实际例子。假设我们要用TREEVIEW构建一个简单的SD卡文件浏览器视图。

4.1 数据结构与初始化

首先，我们定义需要的数据结构，并将TREEVIEW控件与用户数据关联起来。

typedef struct { char name[64]; // 文件名或目录名 uint8_t is_dir; // 1表示目录，0表示文件 uint32_t size; // 文件大小 // ... 其他属性如日期等 } FileInfo_t; // 假设我们有一个全局的TREEVIEW句柄 static TREEVIEW_Handle hFileTree; // 在窗口初始化函数中创建TREEVIEW void _cbCreateFileBrowser(WM_HWIN hWin) { hFileTree = TREEVIEW_CreateEx(10, 10, 300, 220, hWin, WM_CF_SHOW, TREEVIEW_CF_ROWSEL, // 整行选中 GUI_ID_TREEVIEW0); // 设置字体和颜色 TREEVIEW_SetFont(hFileTree, &GUI_Font13_ASCII); TREEVIEW_SetTextColor(hFileTree, GUI_WHITE, 0); // 未选中文本色 TREEVIEW_SetTextColor(hFileTree, GUI_BLACK, 1); // 选中文本色 TREEVIEW_SetBkColor(hFileTree, GUI_DARKGRAY, 0); // 未选中背景 TREEVIEW_SetBkColor(hFileTree, GUI_LIGHTBLUE, 1); // 选中背景 // 加载自定义图标（这里简化，实际应从资源加载） GUI_BITMAP bmp_folder, bmp_file, bmp_plus, bmp_minus; // ... 初始化位图 ... const GUI_BITMAP* apBmps[6] = {&bmp_folder, &bmp_folder, &bmp_file, &bmp_plus, &bmp_minus, 0}; TREEVIEW_SetImage(hFileTree, &apBmps[0]); // 开始构建根目录 BuildTreeFromPath(hFileTree, 0, "0:/"); // 假设"0:/"是SD卡根目录 }

4.2 动态构建树形结构

BuildTreeFromPath函数负责扫描目录并创建对应的树节点。

static void BuildTreeFromPath(TREEVIEW_Handle hTree, TREEVIEW_ITEM_Handle hParent, const char* path) { DIR dir; FILINFO fno; FRESULT res; res = f_opendir(&dir, path); if (res != FR_OK) return; TREEVIEW_ITEM_Handle hFirstItem = 0; // 记录第一个插入的项，用于兄弟项插入 for (;;) { res = f_readdir(&dir, &fno); if (res != FR_OK || fno.fname[0] == 0) break; // 错误或遍历结束 if (fno.fname[0] == '.') continue; // 跳过"."和".." // 创建新的项句柄 int is_node = (fno.fattrib & AM_DIR) ? TREEVIEW_ITEM_IS_NODE : TREEVIEW_ITEM_IS_LEAF; TREEVIEW_ITEM_Handle hNewItem; if (hFirstItem == 0) { // 插入第一个子项 hNewItem = TREEVIEW_InsertItem(hTree, is_node, hParent, TREEVIEW_INSERT_FIRST_CHILD, fno.fname); hFirstItem = hNewItem; } else { // 插入到前一个兄弟项之后 hNewItem = TREEVIEW_InsertItem(hTree, is_node, hFirstItem, TREEVIEW_INSERT_AFTER, fno.fname); hFirstItem = hNewItem; // 更新为最新的项，以便继续插入 } if (hNewItem) { // 为该项分配并设置用户数据 FileInfo_t* pInfo = GUI_ALLOC_Alloc(sizeof(FileInfo_t)); // 使用emWin内存管理 if (pInfo) { strncpy(pInfo->name, fno.fname, sizeof(pInfo->name)-1); pInfo->is_dir = (fno.fattrib & AM_DIR) ? 1 : 0; pInfo->size = fno.fsize; TREEVIEW_ITEM_SetUserData(hNewItem, (U32)pInfo); } // 如果是目录，先插入一个占位子项（可选，实现懒加载） if (is_node == TREEVIEW_ITEM_IS_NODE) { TREEVIEW_InsertItem(hTree, TREEVIEW_ITEM_IS_LEAF, hNewItem, TREEVIEW_INSERT_FIRST_CHILD, "(Loading...)"); // 占位文本 // 实际子目录内容在用户展开时再加载（通过通知代码处理） } } } f_closedir(&dir); }

4.3 处理用户交互与懒加载

为了提升性能，我们采用懒加载策略：只在用户展开目录节点时才加载其子内容。

// 在父窗口的回调函数中 static void _cbCallback(WM_MESSAGE* pMsg) { switch (pMsg->MsgId) { case WM_NOTIFY_PARENT: { int Id = WM_GetId(pMsg->hWinSrc); int NCode = pMsg->Data.v; if (Id == GUI_ID_TREEVIEW0) { switch (NCode) { case WM_NOTIFICATION_SEL_CHANGED: { // 选中项改变，更新状态栏等 TREEVIEW_ITEM_Handle hSel = TREEVIEW_GetSel(hFileTree); if (hSel) { FileInfo_t* pInfo = (FileInfo_t*)TREEVIEW_ITEM_GetUserData(hSel); if (pInfo) { // 在状态栏显示选中文件信息 // ... } } break; } case WM_NOTIFICATION_RELEASED: { // 判断是否是双击展开/折叠（通常结合点击判断） // 这里简化处理，实际可能需要计时器判断双击 break; } case WM_NOTIFICATION_VALUE_CHANGED: { // 这个通知可能用于节点展开/折叠状态变化（取决于emWin版本和配置） // 更通用的做法是处理ITEM的展开/折叠消息或自定义通知 break; } } } break; } // 处理自定义的“展开请求”消息 case MY_MSG_EXPAND_NODE: { TREEVIEW_ITEM_Handle hNode = (TREEVIEW_ITEM_Handle)pMsg->Data.p; ExpandTreeNode(hNode); break; } } } // 展开节点的具体实现 static void ExpandTreeNode(TREEVIEW_ITEM_Handle hNode) { // 1. 获取节点信息 FileInfo_t* pInfo = (FileInfo_t*)TREEVIEW_ITEM_GetUserData(hNode); if (!pInfo || !pInfo->is_dir) return; // 2. 检查是否已经加载过（例如，检查第一个子项是否是占位符） TREEVIEW_ITEM_Handle hFirstChild = TREEVIEW_GetItem(hFileTree, hNode, TREEVIEW_GET_FIRST_CHILD); if (hFirstChild) { char text[32]; TREEVIEW_ITEM_GetText(hFirstChild, text, sizeof(text)); if (strcmp(text, "(Loading...)") == 0) { // 是占位符，删除它 TREEVIEW_ITEM_Delete(hFileTree, hFirstChild); // 加载真实子项 char fullPath[256]; // 需要从根节点递归构建完整路径（这里简化） // BuildFullPath(hNode, fullPath); BuildTreeFromPath(hFileTree, hNode, fullPath); } } // 3. 调用API展开节点 TREEVIEW_ITEM_Expand(hFileTree, hNode); }

4.4 内存管理与资源释放

动态创建的FileInfo_t结构体必须被妥善管理，防止内存泄漏。

// 递归删除子树并释放关联的用户数据 static void DeleteTreeItemAndData(TREEVIEW_Handle hTree, TREEVIEW_ITEM_Handle hItem) { TREEVIEW_ITEM_Handle hChild = TREEVIEW_GetItem(hTree, hItem, TREEVIEW_GET_FIRST_CHILD); while (hChild) { TREEVIEW_ITEM_Handle hNext = TREEVIEW_GetItem(hTree, hChild, TREEVIEW_GET_NEXT_SIBLING); DeleteTreeItemAndData(hTree, hChild); // 递归删除子项 hChild = hNext; } // 释放该项的用户数据 FileInfo_t* pInfo = (FileInfo_t*)TREEVIEW_ITEM_GetUserData(hItem); if (pInfo) { GUI_ALLOC_Free(pInfo); TREEVIEW_ITEM_SetUserData(hItem, 0); } // 最后从控件中删除该项（如果它还没有被删除的话） // 注意：TREEVIEW_ITEM_Delete会触发WM_DELETE消息，在回调中做最终清理更安全 } // 在窗口的WM_DELETE消息处理中，清理整个树 case WM_DELETE: { TREEVIEW_ITEM_Handle hRoot = TREEVIEW_GetItem(hFileTree, 0, TREEVIEW_GET_FIRST); while (hRoot) { TREEVIEW_ITEM_Handle hNextRoot = TREEVIEW_GetItem(hFileTree, hRoot, TREEVIEW_GET_NEXT_SIBLING); DeleteTreeItemAndData(hFileTree, hRoot); hRoot = hNextRoot; } break; }

5. 常见问题排查与性能优化

在实际项目中，使用这两个控件时，你可能会遇到以下典型问题：

1. TEXT控件文本不显示或显示不全

• 检查控件尺寸：控件大小是否足以容纳文本？特别是使用了自动换行时，高度可能不够。
• 检查字体颜色与背景色：是否颜色相同导致“隐形”？背景色是否为GUI_INVALID_COLOR（透明），而底层恰好没有内容？
• 检查文本内容：传入TEXT_SetText的字符串是否以\0结尾？是否包含不可打印字符？
• 检查Z序：控件是否被其他窗口或控件覆盖了？使用WM_BringToTop()试试。

2. TEXT控件更新导致屏幕闪烁

• 原因：频繁调用TEXT_SetText导致局部重绘，且可能没有使用双缓冲。
• 解决方案：
  • 节流更新：在定时器中断或高速循环中，先将值存入变量，在GUI主任务（如GUI_Exec()所在上下文）中统一更新。
  • 使用内存设备：在更新复杂UI前，使用GUI_MEMDEV_Create()创建内存设备，在内存中完成所有绘制操作后，一次性刷到屏幕上。
  • 禁用自动重绘：在批量更新多个控件属性前，调用WM_DisableWindow(hText);，更新完成后调用WM_EnableWindow(hText);并触发重绘。

3. TREEVIEW滚动或展开/折叠卡顿

• 项数量过多：一个TREEVIEW包含成百上千个项时，任何操作都可能变慢。
  • 优化：实现懒加载，只渲染可视区域内的项（需要结合所有者绘制）。
  • 优化：使用TREEVIEW_ITEM_Detach()暂时将不需要显示的子树分离，需要时再Attach。
• 自定义图像过大：确保你设置的节点/叶子图标尺寸合理（通常16x16或32x32）。
• 频繁操作：避免在循环中频繁插入/删除项。批量操作时，可以考虑先用WM_DisableWindow()禁用控件，操作完成后再启用。

4. TREEVIEW项的用户数据指针失效

• 场景：项被删除后，其用户数据指针指向的内存可能已被释放，但其他地方仍持有该指针。
• 最佳实践：建立所有权关系。谁分配FileInfo_t，谁负责释放。推荐在TREEVIEW_ITEM_Delete的附近或WM_DELETE消息处理中集中释放内存。使用GUI_ALLOC_Alloc分配的内存，其生命周期可以与emWin对象绑定，相对安全。

5. 键盘导航不生效

• 检查焦点：确认TREEVIEW控件通过WM_SetFocus()获得了输入焦点。
• 检查父窗口消息循环：确保键盘事件（WM_KEY）能正确传递到控件。
• 检查控件状态：控件是否被禁用（WM_DisableWindow）？

6. 自定义绘制（OwnerDraw）效率低下

• 在OwnerDraw回调中，只做必要的绘制。利用pMsg->Data.p提供的绘制信息（如项索引、矩形区域）进行最小范围的重绘。
• 避免在OwnerDraw回调中进行复杂的计算或资源加载。可以预先计算好，将结果缓存在用户数据中。

最后，调试emWin界面问题时，GUI_DEBUG日志功能是你的好朋友。启用它（通常通过GUI_DEBUG_LEVEL）可以在调试输出中看到窗口管理、内存分配和消息传递的详细信息，对于定位控件行为异常的根本原因非常有帮助。记住，在嵌入式GUI开发中，理解数据流、消息流和内存生命周期，比单纯记忆API参数更重要。