UG/NX Block UI Styler-线性尺寸 Linear_Dim

一. 线性尺寸控件功能概述‌

1. ‌核心功能‌

• ‌动态尺寸调整‌：通过拖动手柄或输入数值直接修改模型的线性尺寸（如长度、高度等），实现参数化建模‌。
• ‌同步建模支持‌：可在不依赖特征历史的情况下修改实体面间距，适用于复杂模型的快速调整‌。
• ‌实时数值更新‌：控件支持公式动态计算（如 Formula="A1+B1"），数值变化自动同步到关联模型‌。

2. ‌属性配置‌

• ‌数值约束‌：
  • 设定输入范围（MinimumValue/MaximumValue），支持闭区间（MinInclusive/MaxInclusive）‌。
  • 容差控制（LimitCheckTolerance）：避免浮点运算误差导致的校验误报‌。
• ‌动态提示‌：
  • 悬停显示自定义文本（BalloonTooltipText）或图片（BalloonTooltipImage），提升交互友好性‌。
  • 布局方向可选水平/垂直（BalloonTooltipLayout）‌。

3. ‌交互操作‌

• ‌手柄控制‌：
  • 显示/隐藏调节手柄（ShowSpin），支持手柄原点（HandleOrigin）和方向（HandleOrientation）自定义‌。
  • 拖动手柄时支持负数逆向操作（AutoReverseDuringDrag）‌。
• ‌单位管理‌：
  • 启用单位菜单（HasUnitsMenu），适配不同量纲（Dimensionality，如无单位、长度、质量）‌。

4. ‌应用场景‌

• ‌参数化设计‌：通过公式驱动模型尺寸，实现自动化更新（如 Value 关联表达式）‌。
• ‌工程校验‌：结合最大/最小值限制，验证输入是否符合安全规范‌。
• ‌模型修复‌：快速调整实体面间距，修复因设计变更导致的几何冲突‌。

二. 线性尺寸控件对话框属性中英文对照表

英文属性名	中文翻译	数据类型	值示例/选项	功能描述
AutoReverseDuringDrag	拖动时自动反转	布尔值	true/false	控制拖动操作时是否自动反转方向‌1
BalloonTooltipLayout	气球提示布局	枚举	水平/垂直	定义提示信息的排列方式‌1
LimitCheckTolerance	限制检查容差	双精度浮点数	-1 或 0.01	设置数值输入容差范围‌2
HandleOrientation	句柄方向	向量	(0.0, 1.0, 0.0)	定义三维空间中操作手柄的朝向‌
ActivePage	起始激活页	整数	0 或 1	指定选项卡控件默认显示的页面索引‌
HiddenTabPages	隐藏页面	字符串数组	["Page2","Page3"]	设置需要隐藏的选项卡页面名称‌
ShowHandle	显示句柄	布尔值	true/false	控制操作手柄的可见性‌
Formula	公式	双精度浮点数	0.0 或 3.1415	用于数值计算的表达式输入‌
MaximumValue	最大值	双精度浮点数	1.7976931348623e+308	定义数值输入上限‌
Localize	本地化	布尔值	true/false	控制界面元素是否进行本地化翻译‌
RetainValue	保存值	布尔值	true/false	控制控件值在对话框关闭后是否保留‌

注：

1. 布尔值类型对应逻辑值 true/false，在代码中通过 GetLogical() 方法获取‌
2. 枚举类型属性需使用 GetEnum() 方法获取整数值，再通过映射关系转换为具体选项‌
3. 向量/点类型数据通过 GetVector() 或 GetPoint() 方法获取三维坐标值‌
4. 带"(仅创建)"标注的属性需在 initialize_cb() 或 dialogShown_cb() 回调函数中初始化‌