特征函数参考 (iLogic)

iLogic 提供了一些用于设定或读取特征抑制状态、颜色和螺纹规格的函数。

对螺纹使用特征函数以设定或读取螺纹特征或螺纹孔的特性。这些特性还显示在螺纹特征或螺纹孔的编辑对话框中。

若要访问特征函数，请展开 iLogic“编辑规则”对话框“代码段”区域中“系统”选项卡上的“特征”节点。

Feature.IsActive（使用特征名称）

设定或读取零件或部件特征的抑制状态。使用该函数可以抑制或解除抑制 Inventor 零件或部件的任何特征。当您更改特征的激活状态时，还会更改从属特征。这样便不再需要在规则中指定从属特征。

注： 手动更改特征的激活状态不会导致参考这些特征的规则自动触发。在零件中，您可以将此类规则添加到由“特征抑制更改”事件触发的规则列表中，以便自动触发这些规则。可以使用“事件触发器”命令访问该事件。

如果您在编写了包含该函数的规则后更改了特征名称，请编辑该规则。使用新名称替换旧名称。在编写规则之前更改特征名称（如果需要）。

特征名称必须始终放在引号中。

语法

Feature.IsActive(“featurename”)

示例 

if bracket_width >= 3 then
Feature.IsActive("flange_hole_pattern") = true
Feature.IsActive("base_hole_pattern") = true
else
Feature.IsActive("flange_hole_pattern") = false
end if

Feature.IsActive（使用零部件名称和特征名称）

函数 Feature.IsActive 的该变体通过指定零部件和特征名称，可以设定或读取零件或子部件中特征的抑制状态。从部件级规则中，使用该语法可以控制零件中特征的激活状态。

语法

Feature.IsActive(“componentname”, “featurename”)

示例

设定抑制状态： 

Feature.IsActive("PartA:1", "Hole:1") = false

读取抑制状态： 

MyBooleanParameter = Feature.IsActive("PartA:1","Hole:1")

Feature.Color

通过指定特征名称，设定或读取零件特征的颜色。该函数对部件特征不起作用。

颜色值是文本字符串。必须将该文本包含在引号中。该值还必须与当前 Autodesk Inventor 文档的激活标准中的可用颜色在拼写和大小写方面完全匹配。

语法

Feature.Color("featurename")

示例

若要设定颜色： 

Feature.Color("Hole:1") = "Green"
Feature.Color("Hole:2") = "Aluminum (Cast)
"Feature.Color("Hole:3") = "As Material"

若要读取颜色： 

MyStringParameter = Feature.Color("Chamfer:1")

通过指定零部件名称和特征名称来设定或读取子部件或零件特征的颜色。 

Feature.Color("componentName", "featurename")

Feature.ThreadDesignation

设定或读取零件或部件文档中的螺纹特征的螺纹规格。螺纹规格是文本字符串。必须将它指定为与螺纹特征编辑对话框的“规格”字段中所显示的字符串完全匹配。

对于锥螺纹，请指定将在“螺纹”对话框的“大小”字段中显示的值。该值通常是完整螺纹规格的缩写版本。

语法

Feature.ThreadDesignation("featurename") = "<designation value>"

（可选）使用以下语法来显示当前螺纹规格（使用设定螺纹规格所需的格式）。

threadDes = Feature.ThreadDesignation("Thread1")

使用规则为孔设定螺纹规格时，孔尺寸会自动调整。

对于螺纹杆，您可以使用规则同时更改杆直径和螺纹规格。杆直径必须符合螺纹规格。

示例 

If rod_type = "small" Then
Feature.ThreadDesignation("Thread1") = "3/8-16 UNC"
rod_diameter = 0.375
ElseIf rod_type = "large" Then
Feature.ThreadDesignation("Thread1") = "1/2-13 UNC"
rod_diameter = 0.500
End If

您还可以从部件级规则中设定或读取零件或部件文档中的螺纹特征的螺纹规格。指定零部件名称或文件名称以及螺纹特征名称： 

Feature.ThreadDesignation("PartA.ipt", "featurename") = "1/2-13UNC"
Feature.ThreadDesignation("PartA:1", "featurename") = "1/2-13UNC"

Feature.SetThread

对孔或螺纹特征进行主要更改。设定类型、规格和公差等级。使用该函数可以在英制和公制螺纹之间切换。您无法在直螺纹和锥螺纹之间切换。

注： 对于锥螺纹，使用空字符串 ("") 替换螺纹公差等级。并且使用“尺寸”而不是“规格”。

语法

Feature.SetThread("featurename", "thread type", "thread designation", "thread class")

还可以使用以下语法对零部件中的孔或螺纹特征进行主要更改。

Feature.SetThread("componentName", "featurename", "thread type", "thread designation", "thread class")

Feature.ThreadType

获取孔或螺纹特征的螺纹类型。例如，“ANSI 统一标准螺钉螺纹”、“ANSI 公制螺纹规格”等。若要更改类型，请使用 SetThread，同时设定规格和级别。

语法

currentType = Feature.ThreadType("featurename")

还可以使用该语法来获取零部件中的孔或螺纹特征的螺纹类型：

currentType = Feature.ThreadType("componentName", "featurename")

Feature.ThreadClass

设定孔或螺纹特征的螺纹公差等级。数值越大，精确度越高。

语法

Feature.ThreadClass("featurename") = "3B"

使用该语法可以获取孔或螺纹特征的螺纹公差等级：

currentClass = Feature.ThreadClass("featurename")

使用该语法可以设定零部件中的孔或螺纹特征的螺纹公差等级。

Feature.ThreadClass("componentName", "featurename") = "3B"

注： 不能应用于锥螺纹。

获取零部件中的孔或螺纹特征的螺纹公差等级。

currentClass = Feature.ThreadClass("componentName", "featurename")

父主题： 关于 iLogic 中的规则的函数