工程图函数参考 (iLogic)

使用工程图函数可自定义在工程图纸中反映模型更改的方式。

工程图函数可以协助进行高效的模型更新,并且可以包含在由 iLogic 的“工程视图更改”事件触发的规则中。

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

ThisDrawing

访问规则中的当前工程图。

ActiveSheet

访问工程图中的激活图纸。此函数是 ThisDrawing.ActiveSheet 的别名。由于其他图纸可能不是最新的图纸,大多数工程图操作都在激活图纸上执行。

ThisDrawing.Sheet

访问工程图中的图纸。

语法

ThisDrawing.Sheet(“sheetname”)

ResourceFileName

您可以为此特性指定文件名字符串,以指定从其中提取标题栏和图框定义的另一个工程图的名称。使用 TitleBlockBorder 图纸函数时,iLogic 会在此工程图中查找未在当前工程图中找到的资源。为此文件名使用相对路径名称。iLogic 会在当前工程图所在的文件夹及项目工作空间文件夹中搜索该文件。您可以指定相对于上述两个位置中的任意一个的子文件夹。

示例

ThisDrawing.ResourceFileName = “DrawingResources1.idw”

KeepExtraResources

如果外部资源文件中的资源的副本没有保留在当前工程图中,请将此特性设定为 False

如果将此特性设定为 False,则该资源将在被其他资源替代后删除。只有当 ResourceFileName 不为空时才会执行删除。该函数假设您需要的所有资源都可以在外部资源文件中找到。

示例

ThisDrawing.KeepExtraResources = False

图纸函数

适用于工程图的图纸函数通常用于激活的图纸。若要限制规则,以便其只对特定图纸运行,您可以在规则的顶部添加代码。例如:

If (ActiveSheet.Name <> "Sheet:2") Then Return

ChangeSize (使用文本字符串值)

使用文本字符串作为新尺寸的值,更改图纸尺寸。

语法

Sheet.ChangeSize (“value”,<MoveBorderItems = True>)

新尺寸的值。

MoveBorderItems

此参数为可选参数。如果将 MoveBorderItems 设定为 False,则当前位于图纸图框或边上的任何表格和明细栏均不会移至新图框。

示例

ActiveSheet.ChangeSize (“A”)
ActiveSheet.ChangeSize (“B1”, MoveBorderItems := False)

ChangeSize(使用自定义值)

使用自定义高度和宽度(以文档单位表示)更改图纸尺寸。

语法

Sheet.ChangeSize (customHeight, customWidth, <MoveBorderItems = True>)

height

以文档单位表示的高度。

width

以文档单位表示的宽度。

MoveBorderItems

此参数为可选参数。如果将 MoveBorderItems 设定为 False,则当前位于图纸图框或边上的任何表格和明细栏均不会移至新图框。

示例

ActiveSheet.ChangeSize (7.2, 4)
ActiveSheet.ChangeSize ( 7.2, 4, MoveBorderItems = False)

Sheet.Border

通过指定其他名称更改图纸上的当前图框。该名称必须是在当前工程图的工程图资源中找到的名称,或者是在 ResourceFileName 工程图(如果已经指定)中找到的名称。

示例

ActiveSheet.Border = “OtherBorder”
currentName = ActiveSheet.Border

Sheet.TitleBlock

通过指定其他名称更改图纸上的当前标题栏框。该名称必须是在当前工程图的工程图资源中找到的名称,或者是在 ResourceFileName 工程图(如果已经指定)中找到的名称。

示例

ActiveSheet.TitleBlock = “ANSI - A”
currentName = ActiveSheet.TitleBlock

使用外部源文件时的示例 -

ThisDrawing.ResourceFileName = “DrawingResources1.idw”
ActiveSheet.TitleBlock = “Custom - A”

ActiveSheet.Name

获取图纸名称。

ActiveSheet.Size

将图纸尺寸作为文本字符串返回,例如“A”或“B0”。

ActiveSheet.Height

获取以文档单位表示的图纸高度。

ActiveSheet.Width

获取以文档单位表示的图纸宽度。

ActiveSheet.View(“viewName”)

访问图纸上的视图。

视图函数

适用于工程图的视图函数通常用于激活的图纸(建议)。

View.Name

获取视图名称。

View.Height

获取以工程图文档单位表示的视图高度。

View.Width

获取以工程图文档单位表示的视图宽度。

View.Scale

获取或设定以数字表示的视图比例。

View.ScaleString

将视图比例作为文本字符串返回或将视图比例设定为文本字符串,例如“1:2”或“4.1”。

View.SetCenter(centerX,centerY)

设定视图的中心点(移动视图)。坐标以工程图文档单位指定。

View.SetSpacingToCorner(distanceX, distanceY, corner)

通过指定从视图拐角到最近的图纸拐角的距离来设定视图位置(移动视图)。变量 corner 可以是以下其中一个:

SheetCorner.BottomLeft
SheetCorner.BottomRight
SheetCorner.TopLeft
SheetCorner.TopRight

坐标以工程图单位指定。iLogic 会查找与图纸拐角最接近的拐角。

View.SpacingBetween(“otherViewName”)

通过指定此视图与另一个视图之间的间距来设定视图位置(移动视图)。另一个视图名称通常为图纸上的相邻视图。间距为视图边之间沿 X 或 Y 方向的距离。指定为正的间距值可将此视图放置在另一个视图的右侧或上方。指定为负的间距值可将此视图放置在另一个视图的左侧或下方。例如:

ActiveSheet.View("VIEW2").SpacingBetween("VIEW1") = 30 mm  '

VIEW2 位于 VIEW1 的右侧。

ActiveSheet.View("VIEW3").SpacingBetween("VIEW1") = -40 mm  '

VIEW3 位于 VIEW1 的下方。

View.Balloons

访问视图中的引出序号。

引出序号函数

适用于工程图的引出序号函数与特定视图相关联。

Balloons.Reattach

对于部件文档视图,此函数会检查视图中是否有未附着的引出序号并将它们附着到零部件(如果可能)。首选箭头处的零部件。如果在此处没有找到零部件,则会使用最近的没有引出序号的合格零部件。如果此时无法附着引出序号,则会将其移动至隐藏图层。隐藏图层是专门为此目的而创建的图层(如果需要)。

注: 该函数要求为工程图设定“保留孤立标注”选项(在“工具”“选项”“文档设置”下)。如果未设定此选项,该函数会自动设定它。

Balloons.AttachToComponent(“componentName”)

指定需要引出序号的零部件。componentName 可指定零部件引用,例如 "Pin:1"。使用该函数时,只将引出序号重附着到您指定的零部件。不使用该函数时,可将引出序号重附着到任何可用的零部件(除非被 DoNotAttachToComponent 函数取消了资格)。

Balloons.DoNotAttachToComponent(“componentName”)

指定不需要引出序号的零部件。componentName 可指定零部件引用,例如 "Pin:1"