UG/NX Block UI Styler-字符串 String

一. 字符串控件功能概述‌

1. 核心功能‌

• ‌文本输入‌
  允许用户直接输入或编辑字符串内容，常用于参数化设计中的文本参数配置。
• ‌文本显示‌
  展示静态或动态生成的文本信息（如计算结果、状态提示等）。
• ‌数据绑定‌
  支持与NX表达式、属性或模型参数动态关联，实现实时更新。

---

‌2. 关键属性‌

• ‌默认值‌（Default Value）：设置初始文本内容。
• ‌最大长度‌（Maximum Length）：限制输入字符数量。
• ‌多行输入‌（Multi-Line）：支持多行文本输入（需启用属性）。
• ‌只读模式‌（Read-Only）：禁止用户编辑，仅用于显示。
• ‌标签与占位符‌：提供描述性标签（Label）和输入提示（Placeholder Text）。

---

‌3. 应用场景‌

• ‌参数化建模‌：输入特征名称、尺寸注释或公式参数。
• ‌交互提示‌：显示操作指引或错误信息。
• ‌动态更新‌：通过表达式绑定，实时反映模型数据变化（如体积、面积等）。
• ‌脚本集成‌：与NX Open API 结合，驱动自动化流程。

---

‌4. 高级特性‌

• ‌布局控制‌：调整控件在对话框中的位置、对齐方式和尺寸。
• ‌事件响应‌：支持回调函数（如文本修改触发模型更新）。
• ‌国际化‌：支持多语言文本，适配不同区域设置。

二. 字符串控件对话框属性中英文对照表

属性名‌	‌中文翻译‌	‌类型‌	‌用途‌	‌用法示例/说明‌
‌BalloonTooltipImage‌	气球提示图像	String	设置气球提示中显示的图像路径	需指定图像文件路径（如"./images/tooltip.png"）
‌BalloonTooltipLayout‌	气球提示布局	Horizontal	控制提示框的布局方向（水平或垂直）	可选值：Horizontal（默认）、Vertical
‌BalloonTooltipText‌	气球提示文本	Utfstring	定义鼠标悬停时显示的动态提示文本	支持多语言字符，如this->label->SetString("BalloonTooltipText", "输入参数限制")
‌Bitmap‌	位图图像	String	设置控件显示的位图图标	需指定位图资源ID或文件路径，常用于按钮、标签等控件的图标显示
‌MaxTextLength‌	最大文本长度	Integer	限制输入框允许的最大字符数	若值为0表示无限制，如this->input->SetInteger("MaxTextLength", 50)
‌PresentationStyle‌	显示样式	Keyln	定义控件的视觉风格（如边框、背景等）	特定于NX内置样式库，需参考开发文档选择可用值
‌ReadOnlyString‌	只读字符串	Logical	控制字符串输入框是否可编辑	设为True时用户无法修改内容，适用于显示计算结果或配置参数
‌RequiredInput‌	必需输入	Logical	强制用户必须填写该字段才能提交对话框	设为True时，若未输入则弹出错误提示
‌Tooltip‌	工具提示文本	Utfstring	设置静态工具提示文本	与BalloonTooltipText不同，此属性为固定提示，如this->button->SetString("Tooltip", "点击确认")
‌Value‌	值	String	存储控件的当前值（如输入框内容、开关状态等）	通过GetProperties()->GetString("Value")获取值
‌Width‌	控件宽度	Narrow	设置控件显示宽度（预定义选项如Narrow/Medium/Wide）	影响布局适配，如this->input->SetString("Width", "Medium")