一、CTextUI控件自适应文字宽度基础机制

CTextUI控件作为Duilib中处理文本显示的核心组件，其自适应文字宽度特性通过内部文本测量算法实现。控件在渲染前会调用CDUIString::GetTextExtentPoint32或类似API计算文本的像素宽度，结合控件的width属性设置动态调整显示区域。

1.1 属性配置要点

• width属性：当设置为-1时，控件宽度完全由文本内容决定；设置为具体数值时，文本可能被截断或显示省略号（需配合ellipsis属性）。
• textpadding属性：通过textpadding="左,上,右,下"设置文本内边距，影响自适应宽度的计算基准。例如textpadding="10,0,10,0"会在文本两侧各预留10像素空间。
• multiline属性：若启用多行显示（multiline="true"），自适应宽度会基于最长行的文本宽度计算。

代码示例：

<Text name="adaptive_text" text="动态宽度文本" width="-1" textpadding="5,0,5,0" />

此配置下，控件宽度将严格等于文本宽度加左右内边距。

1.2 动态文本更新机制

当通过SetText方法修改文本内容时，控件会重新触发宽度计算。需注意在频繁更新文本的场景中（如实时日志显示），可能引发性能问题。优化建议：

• 批量更新文本内容，减少SetText调用次数。
• 对静态文本预先计算宽度，避免重复测量。

二、自适应宽度的高级应用技巧

2.1 结合布局控件实现复杂布局

在VerticalLayout或HorizontalLayout中使用CTextUI时，可通过childpadding和childalign属性控制文本与其他控件的间距。例如：

<VerticalLayout childpadding="10">
    <Text name="title" text="标题" width="-1" font="2" />
    <Text name="content" text="正文内容..." width="-1" textcolor="#FF0000" />
</VerticalLayout>

此时，两个CTextUI控件会根据文本宽度自动扩展，且保持10像素的垂直间距。

2.2 动态调整字体大小的自适应方案

当需要文本根据容器宽度自动缩放时，可结合GetFixedWidth方法和字体调整逻辑：

void CMyUI::AdjustFontSize(CTextUI* pText, int maxWidth) {
    int currentWidth = pText->GetFixedWidth();
    if (currentWidth > maxWidth) {
        // 递减字体大小直至宽度达标
        for (int size = pText->GetFont(); size >= 8; --size) {
            pText->SetFont(size);
            if (pText->GetFixedWidth() <= maxWidth) break;
        }
    }
}

此方法适用于需要严格限制控件宽度的场景，如工具栏按钮文本。

三、常见问题与解决方案

3.1 文本显示不全或截断

问题表现：设置width为固定值后，长文本被截断且未显示省略号。
原因分析：

• 未启用ellipsis属性。
• 文本包含换行符但未设置multiline。

解决方案：

<Text text="超长文本示例" width="100" ellipsis="true" />

或启用多行显示：

<Text text="多行\n文本" width="100" multiline="true" />

3.2 性能优化策略

在需要显示大量动态文本的列表控件中（如List），频繁的宽度计算可能导致卡顿。优化方法包括：

• 缓存宽度数据：对静态文本预先计算并存储宽度。
• 异步更新：通过定时器分批更新文本内容。
• 简化样式：减少textpadding和复杂字体设置。

代码示例：

// 缓存文本宽度示例
std::map<CString, int> g_textWidthCache;
int GetCachedTextWidth(CTextUI* pText) {
    CString text = pText->GetText();
    if (g_textWidthCache.find(text) != g_textWidthCache.end()) {
        return g_textWidthCache[text];
    }
    // 模拟计算宽度
    int width = /* 实际计算逻辑 */;
    g_textWidthCache[text] = width;
    return width;
}

3.3 多语言支持问题

不同语言的文本宽度差异可能导致布局错乱。建议：

• 对每种语言单独配置布局参数。
• 使用UILIB_COMCTL32版本6以上以支持Unicode宽度计算。
• 测试阶段覆盖常见语言（如中文、英文、阿拉伯文）。

四、最佳实践总结

1. 明确宽度策略：根据场景选择固定宽度（width="100"）、自适应宽度（width="-1"）或百分比宽度（需父容器支持）。
2. 合理使用内边距：通过textpadding避免文本紧贴边缘，提升可读性。
3. 性能敏感场景优化：对动态文本列表采用虚拟化技术，仅渲染可见区域控件。
4. 样式与功能分离：将文本样式（字体、颜色）与布局属性（宽度、边距）分开配置，便于维护。

通过深入理解CTextUI控件的自适应机制，开发者能够更高效地实现复杂的文本布局需求，同时避免常见陷阱。实际开发中，建议结合Duilib的XML布局文件与C++逻辑代码，灵活应用上述技巧。