工作表函数

工作表函数用于接受一个自变量,执行一项操作,并返回一个值或多个值。有两种基本类型的函数:使用所输入的值的函数,以及使用绘图对象信息的函数。这两类函数所需的自变量是不同的。

    数字或文本自变量:以小写字母开头的函数通常需要使用一个数字值或单元格地址作为自变量。例如,acos 函数会返回函数自变量中所指定的值的反余弦。所输入的自变量可以是数学表达式(例如 3/5)、一个包含数字的单元格的地址(例如 A12)或一个实际数字。所有三角函数的自变量必须以弧度为单位。

    条件自变量:以大写字母开头的函数必须应用到绘图中的一个或多个具体对象。在数据库标题行的单元格中,函数将自动应用到每个子行中所列出的对象,因此不需要条件自变量。

但是,在电子表格单元格中,必须输入条件以选择要将函数应用至其上的对象。比如说,“面积”函数会返回符合条件所有二维对象的组合面积。如要指定获取哪些对象的面积,可以使用工作表菜单中的插入 > 条件命令,或手动输入条件。对于如何指定对象类型、类或可见性等条件的相关详情,请访问下述链接参阅面向开发人员的文档(需要访问网络):

developer.vectorworks.net/index.php/VS:Search_Criteria#Search_Criteria_Tables 

developer.vectorworks.net/index.php/VS:Function_Reference_Appendix#attrCrit 

在下列工作表函数列表中,函数使用的自变量显示在圆括号中。

acos(数字)

一个数字的反余弦。反余弦是其余弦为某个数字的角度。返回的角度以 0 至 pi 的弧度值表示。数字是角度的余弦,必须介于 -1 至 1 之间。相关函数:cos 

例如:=acos(3/5) 返回其余弦值为 3/5 的角度

Angle(条件)

符合指定条件对象的角度(从地平线开始测量,以度为单位)。使用此函数可返回线条和墙壁的角度(从地平线开始测量)、圆弧的跨角和楼板的坡角。

例如:

    数据库标题单元格:=Angle 返回数据库中每个对象的角度

    电子表格单元格:=Angle((t=arc)&(n='arc-1')) 返回绘图中名为 “arc-1” 圆弧对象的扫掠角

Area(条件)

符合指定条件的二维对象的总面积,基于“单位”对话框中的“面积”单位。相关函数:Perim 

例如:

    数据库标题单元格:=Area 返回数据库中每个对象的面积

    电子表格单元格:=Area(t=rect) 返回绘图中所有矩形对象的组合面积

asin(数字)

一个数字的反正弦。反正弦是其正弦为某个数字的角度。返回的角度以 -pi/2 至 pi/2 的弧度值表示。如要以度数为单位表示反正弦,使用 rad2deg 函数(或将结果乘以 180/pi)。数字是角度的正弦,必须介于 -1 至 1 之间。相关函数:sin 

例如:=asin(A3) 返回其正弦值为单元格 A3 中给定值的的角度

BotBound(条件)

符合指定条件的对象的二维下边界(最小 y 坐标)。相关函数:LeftBound、RightBound、TopBound 

例如:

    数据库标题单元格:=BotBound 返回数据库中每个对象的二维下边界

    电子表格单元格:=BotBound(t=locus) 返回在绘图中具有最低二维下边界值的坐标点的二维下边界

类(条件)

符合指定条件的对象的类名称。

例如:

    数据库标题单元格:=Class 返回数据库中每个对象的类

    电子表格单元格:=Class(sel=true)返回绘图中所选对象的类名称

CompAreaByClass(条件,类)

符合指定条件且在指定类中的组件的一侧的面积(减去所有孔)。相关函数:CompAreaByName, ComponentArea 

例如:

    数据库标题单元格:=CompAreaByClass('Class-1') 对于数据库中的每个墙壁、圆墙壁、屋顶、屋顶表面以及楼板对象,返回指派给 “Class-1” 类的组件的面积

    电子表格单元格:=CompAreaByClass(t=wall,'Class-1') 对于绘图中的所有墙壁,返回指派给 “Class-1” 类的组件的组合面积

CompAreaByName(条件,名称)

符合指定条件且具有指定名称的组件的一侧的面积(减去所有孔)。相关函数:CompAreaByClass, ComponentArea 

例如:

    数据库标题单元格:=CompAreaByName('Brick Veneer') 对于数据库中的每个墙壁、圆墙壁、屋顶、屋顶表面以及楼板对象,返回具有 “Brick Veneer” 名称的组件的面积

    电子表格单元格:=CompAreaByName(t=wall,'Brick Veneer') 对于绘图中的所有墙壁,返回具有 “Brick Veneer” 名称的组件的组合面积

CompClassByName(条件,名称)

符合指定条件且具有指定名称的组件名称。相关函数:CompNameByClass 

例如:

    数据库标题单元格:=CompClassByName('Brick Veneer') 对于数据库中的每个墙壁、圆墙壁、屋顶、屋顶表面以及楼板对象,返回具有 “Brick Veneer” 名称的组件的类

    电子表格单元格:=CompClassByName(t=wall,'Brick Veneer') 对于绘图中的所有墙壁,返回具有 “Brick Veneer” 名称的第一个组件的类

CompLambdaByClass(条件,类)

符合指定条件且在指定类中的组件的 Lambda 值。相关函数:CompLambdaByName, ComponentLambda 

例如:

    数据库标题单元格:=CompLambdaByClass('Class-1') 对于数据库中的每个墙壁、圆墙壁、屋顶、屋顶表面以及楼板对象,返回指派给 “Class-1” 类的组件的 Lambda 值

    电子表格单元格:=CompLambdaByClass(t=wall,'Class-1') 对于绘图中的所有墙壁,返回指派给 “Class-1” 类的第一个组件的 Lambda 值

CompLambdaByName(条件,名称)

符合指定条件且具有指定名称的组件的 Lambda 值。相关函数:CompLambdaByClass, ComponentLambda 

例如:

    数据库标题单元格:=CompLambdaByName('Brick Veneer') 对于数据库中的每个墙壁、圆墙壁、屋顶、屋顶表面以及楼板对象,返回具有 “Brick Veneer” 名称的组件的 Lambda 值

    电子表格单元格:=CompLambdaByName(t=wall,'Brick Veneer') 对于绘图中的所有墙壁,返回具有 “Brick Veneer” 名称的第一个组件的 Lambda 值

CompNameByClass(条件,类)

符合指定条件且在指定类中的组件的名称。相关函数:CompClassByName 

例如:

    数据库标题单元格:=CompNameByClass('Class-1') 对于数据库中的每个墙壁、圆墙壁、屋顶、屋顶表面以及楼板对象,返回指派给 “Class-1” 类的组件的名称

    电子表格单元格:=CompNameByClass(t=wall,'Class-1') 对于绘图中的所有墙壁,返回指派给 “Class-1” 类的第一个组件的名称

ComponentArea(条件,索引)

符合指定条件且具有指定索引的组件的一侧的面积(减去所有孔)。索引为用于识别组件的从 1 开始的索引。相关函数:CompAreaByClass, CompAreaByName 

例如:

    数据库标题单元格:=ComponentArea(2) 对于数据库中的每个墙壁、圆墙壁、屋顶、屋顶表面以及楼板对象,返回第二个组件的面积

    电子表格单元格:=ComponentArea(t=wall,1) 返回绘图中所有墙壁的第一个组件的组合面积

ComponentLambda(条件,索引)

符合指定条件且具有指定索引的组件的 Lambda 值索引为用于识别组件的从 1 开始的索引。相关函数:CompLambdaByClass, CompLambdaByName 

例如:

    数据库标题单元格:=ComponentLambda(2) 对于数据库中的每个墙壁、圆墙壁、屋顶、屋顶表面以及楼板对象,返回第二个组件的 Lambda 值

    电子表格单元格:=ComponentLambda(t=wall,1) 返回绘图中所有墙壁的第一个组件的 Lambda 值

ComponentName(条件,索引)

符合指定条件且具有指定索引的组件名称。索引为用于识别组件的从 1 开始的索引。相关函数:CompNameByClass 

例如:

    数据库标题单元格:=ComponentName(2) 对于数据库中的每个墙壁、圆墙壁、屋顶、屋顶表面以及楼板对象,返回第二个组件的名称

    电子表格单元格:=ComponentName(t=wall,1) 返回绘图中所有墙壁的第一个组件的名称

ComponentRValue(条件,索引)

符合指定条件且具有指定索引的组件的 R 值。索引为用于识别组件的从 1 开始的索引。相关函数:CompRValueByClass, CompRValueByName 

例如:

    数据库标题单元格:=ComponentRValue(2) 对于数据库中的每个墙壁、圆墙壁、屋顶、屋顶表面以及楼板对象,返回第二个组件的 R 值

    电子表格单元格:=ComponentRValue(t=wall,1) 返回绘图中所有墙壁的第一个组件的组合 R 值

ComponentThickness(条件,索引)

符合指定条件且具有指定索引的组件的厚度。索引为用于识别组件的从 1 开始的索引。相关函数:CompThicknessByClass, CompThicknessByName 

例如:

    数据库标题单元格:=ComponentThickness(2) 对于数据库中的每个墙壁、圆墙壁、屋顶、屋顶表面以及楼板对象,返回第二个组件的厚度

    电子表格单元格:=ComponentThickness(t=wall,1) 返回绘图中所有墙壁的第一个组件的组合厚度

ComponentUValue(条件,索引)

符合指定条件且具有指定索引的组件的 U 值。索引为用于识别组件的从 1 开始的索引。相关函数:CompUValueByClass, CompUValueByName 

例如:

    数据库标题单元格:=ComponentUValue(2) 对于数据库中的每个墙壁、圆墙壁、屋顶、屋顶表面以及楼板对象,返回第二个组件的 U 值

    电子表格单元格:=ComponentUValue(t=wall,1) 返回绘图中所有墙壁的第一个组件的组合 U 值

ComponentVolume(条件,索引)

符合指定条件且具有指定索引的组件的体积(减去所有孔)。索引为用于识别组件的从 1 开始的索引。相关函数:CompVolumeByClass, CompVolumeByName 

例如:

    数据库标题单元格:=ComponentVolume(2) 对于数据库中的每个墙壁、圆墙壁、屋顶、屋顶表面以及楼板对象,返回第二个组件的体积

    电子表格单元格:=ComponentVolume(t=wall,1) 返回绘图中所有墙壁的第一个组件的组合体积

CompRValueByClass(条件,类)

符合指定条件且在指定类中的组件的 R 值。相关函数:CompRValueByClass, ComponentRValue 

例如:

    数据库标题单元格:=CompRValueByClass('Class-1') 对于数据库中的每个墙壁、圆墙壁、屋顶、屋顶表面以及楼板对象,返回指派给 “Class-1” 类的组件的 R 值

    电子表格单元格:=CompRValueByClass(t=wall,'Class-1') 对于绘图中的所有墙壁,返回指派给 “Class-1” 类的组件的组合 R 值

CompRValueByName(条件,名称)

符合指定条件且具有指定名称的组件的 R 值。相关函数:CompRValueByClass, ComponentRValue 

例如:

    数据库标题单元格:=CompRValueByName(t=wall,'Brick Veneer') 对于数据库中的每个墙壁、圆墙壁、屋顶、屋顶表面以及楼板对象,返回具有 “Brick Veneer” 名称的组件的 R 值

    电子表格单元格:=CompRValueByName(t=wall,'Brick Veneer') 对于绘图中的所有墙壁,返回具有 “Brick Veneer” 名称的组件的组合 R 值

CompThicknessByClass(条件,类)

符合指定条件且在指定类中的组件的厚度。相关函数:CompThicknessByName, ComponentThickness 

例如:

    数据库标题单元格:=CompThicknessByClass('Class-1') 对于数据库中的每个墙壁、圆墙壁、屋顶、屋顶表面以及楼板对象,返回指派给 “Class-1” 类的组件的厚度

    电子表格单元格:=CompThicknessByClass(t=wall,'Class-1') 对于绘图中的所有墙壁,返回指派给 “Class-1” 类的组件的组合厚度

CompThicknessByName(条件,名称)

符合指定条件且具有指定名称的组件的厚度。相关函数:CompThicknessByClass, ComponentThickness 

例如:

    数据库标题单元格:=CompThicknessByName('Brick Veneer') 对于数据库中的每个墙壁、圆墙壁、屋顶、屋顶表面以及楼板对象,返回具有 “Brick Veneer” 名称的组件的厚度

    电子表格单元格:=CompThicknessByName(t=wall,'Brick Veneer') 对于绘图中的所有墙壁,返回具有 “Brick Veneer” 名称的组件的组合厚度

CompUValueByClass(条件,类)

符合指定条件且在指定类中的组件的 U 值。相关函数:CompUValueByName, ComponentUValue 

例如:

    数据库标题单元格:=CompUValueByClass('Class-1') 对于数据库中的每个墙壁、圆墙壁、屋顶、屋顶表面以及楼板对象,返回指派给 “Class-1” 类的组件的 U 值

    电子表格单元格:=CompUValueByClass(t=wall,'Class-1') 对于绘图中的所有墙壁,返回指派给 “Class-1” 类的组件的组合 U 值

CompUValueByName(条件,名称)

符合指定条件且具有指定名称的组件的 U 值。相关函数:CompUValueByClass, ComponentUValue 

例如:

    数据库标题单元格:=CompUValueByName('Brick Veneer') 对于数据库中的每个墙壁、圆墙壁、屋顶、屋顶表面以及楼板对象,返回具有 “Brick Veneer” 名称的组件的 U 值

    电子表格单元格:=CompUValueByName(t=wall,'Brick Veneer' 对于绘图中的所有墙壁,返回具有 “Brick Veneer” 名称的组件的组合 U 值

CompVolumeByClass(条件,类)

符合指定条件且在指定类中的组件的体积。相关函数:CompVolumeByName, ComponentVolume 

例如:

    数据库标题单元格:=CompVolumeByClass('Class-1') 对于数据库中的每个墙壁、圆墙壁、屋顶、屋顶表面以及楼板对象,返回指派给 “Class-1” 类的组件的体积

    电子表格单元格:=CompVolumeByClass(t=wall,'Class-1') 对于绘图中的所有墙壁,返回指派给 “Class-1” 类的组件的组合体积

CompVolumeByName(条件,名称)

符合指定条件且具有指定名称的组件的体积。相关函数:CompVolumeByClass, ComponentVolume 

例如:

    数据库标题单元格:=CompVolumeByName('Brick Veneer') 对于数据库中的每个墙壁、圆墙壁、屋顶、屋顶表面以及楼板对象,返回具有 “Brick Veneer” 名称的组件的体积

    电子表格单元格:=CompVolumeByName(t=wall,'Brick Veneer') 对于绘图中的所有墙壁,返回具有 “Brick Veneer” 名称的组件的组合体积

concat(文本1, 文本2, 文本3)

将多个文本字符串合成一个文本字符串。

例如:=concat(B3,', ',B4) 将单元格 B3 和 B4 的内容返回为一个字符串,以一个逗号和一个空格分开

cos(数字)

给定角度的余弦。数字是以弧度表示、要计算其余弦的角度。相关函数:acos 

例如:=cos(deg2rad(23)) 将 23 度角转换为对等的弧度值,并返回该角度的余弦

Count(条件)

符合条件的对象数量。

例如:

    数据库标题单元格:=Count 返回数据库中每行对象的总数

    电子表格单元格:=Count(s='simple sofa') 返回绘图中名为“simple sofa” 符号对象的总数

搭配“计数”函数使用时,SEL(选择状态)条件会为实际不可选的对象计数,比如组内的个别项目。VSEL(可见选择状态)条件则只会为可见选定项目计数,与“对象信息”面板所用的计数方法相同。例如:如果您选择一个有 11 个项目的组并为其计数,则 SEL 条件的返回值会是 12 (该组,加上 11 个项目)。VSEL 条件的返回值则会是 1 (仅组)。

CurtWallFrameLength(条件,类)

符合指定条件且在指定类中的幕墙壁框架的组合长度。要找到某幕墙壁中的所有框架,请使用一个空的类名称。相关函数:CurtWallPnlAreaNet, CurtWallPnlAreaGross 

例如:

    数据库标题单元格:=CurtWallFrameLength('') 返回数据库中每个幕墙壁的幕墙壁框架的组合长度

    电子表格单元格:=CurtWallFrameLength(t=wall, '') 返回绘图中所有幕墙壁的幕墙壁框架的组合长度

CurtWallPnlAreaGross(条件,类)

符合指定条件且在指定类中的墙壁中幕墙壁面板的组合总面积。总面积包括框架覆盖面板的部分。要找到某幕墙壁中的所有面板,请使用一个空的类名称。相关函数:CurtWallFrameLength, CurtWallPnlAreaNet 

例如:

    数据库标题单元格:=CurtWallPnlAreaGross('') 返回数据库中每个幕墙壁的幕墙壁面板的组合总面积

    电子表格单元格:=CurtWallPnlAreaGross(t=wall, '') 返回绘图中所有幕墙壁的幕墙壁面板的组合总面积

CurtWallPnlAreaNet(条件,类)

符合指定条件且在指定类中的墙壁中幕墙壁面板的净面积。净面积仅包括以框架为边界的可见面积。要找到某幕墙壁中的所有面板,请使用一个空的类名称。相关函数:CurtWallFrameLength, CurtWallPnlAreaGross 

例如:

    数据库标题单元格:=CurtWallPnlAreaNet ('Class-1') 返回数据库中每个幕墙壁被指派给 “Class-1” 类的幕墙壁面板的组合净面积

    电子表格单元格:=CurtWallPnlAreaNet(t=wall, 'Class-1') 返回绘图中所有幕墙壁被指派给 “Class-1” 类的幕墙壁面板的组合净面积

deg2rad(数字)

将一个数字从度数转换为弧度。数字是以度数为单位、要将其转换为弧度的值。

例如:=deg2rad(47) 将 47 度角度测量结果转换为其对等的弧度值

exp(数字)

e 的指定次数冪。常数 e 等于 2.71828182845904,是自然对数的底。数字是应用至底 e 的冪。

例如:=exp(2) 返回 e 的 2 次冪值

GetCOBieProperty(条件)

(需要 Vectorworks Design Series)对象的 COBie 属性的值。条件是一个带有两个元素(由一个句点隔开)的字符串。第一个元素是 COBie 工作表的名称,第二个元素是该工作表中列的名称。

例如:=GETCOBIEPROPERTY('space.floorname')返回 COBie 属性为 Space 的对象的 FloorName 值 

GetCOBieSource(条件)

(需要 Vectorworks Design Series)所选工作表的数据源和对象的列。条件是一个带有两个元素(由一个句点隔开)的字符串。第一个元素是 COBie 工作表的名称,第二个元素是该工作表中列的名称

例如:=GETCOBIESOURCE('space.floorname')返回 COBie 属性为 Space 的对象的 FloorName 数据源

GetIfcProperty(条件)

(需要 Vectorworks Design Series)与某 IFC 对象关联的某特定 IFC 特性的值。条件是一个带有两个元素(由一个句点隔开)的字符串。第一个元素是一个 IFC 实体或 PSet 名称,而第二个元素则是 IFC 特性的名称。

例如:=GETIFCPROPERTY ('ifcfurnishingelement.name') 返回那个 IFC 实体为 IfcFurnishingElement 的 IFC 对象的“名称”值

GetSpaceNameForObj(条件)

(需要 Vectorworks Architect)符合指定条件的对象周围的空间名称。相关函数:GetSpaceNumForObj 

例如:

    数据库标题单元格:=GetSpaceNameForObj 返回数据库中每个对象的空间名称

    电子表格单元格:=GetSpaceNameForObj(n='chair-1') 返回名为 “chair-1” 的对象的空间名称

GetSpaceNumForObj(条件)

(需要 Vectorworks Architect)符合指定条件的对象周围的空间编号。相关函数:GetSpaceNameForObj 

例如:

    数据库标题单元格:=GetSpaceNumForObj 返回数据库中每个对象的空间编号

    电子表格单元格:=GetSpaceNumForObj(n='chair-1') 返回名为 “chair-1” 的对象的空间编号

GradientFill(条件)

符合指定条件的对象的渐变填充。

例如:

    数据库标题单元格:=GradientFill 返回数据库中每个对象的渐变填充

    电子表格单元格:=GradientFill(sel=true) 返回绘图中所选对象的渐变填充

HatchFill(条件)

符合指定条件的对象的影线填充。

例如:

    数据库标题单元格:=HatchFill 为数据库中的每个对象返回影线填充

    电子表格单元格:=HatchFill(sel=true) 返回绘图中所选对象的影线填充

Height(条件)

符合指定条件的对象的组合Δ y(高度)。相关函数:宽度 

例如:

    数据库标题单元格:=Height 返回数据库中每个对象的高度(Δ y)

    电子表格单元格:=Height(sel=true) 返回绘图中选定对象的组合高度(Δ y)值

if ((logical_test), value_if_true, value_if_false)

如果 logical_test 为真,使用 value_if_true,如果 logical_test 为假,使用 value_if_false。

使用此函数对值和公式进行条件测试,并基于该测试的结果选择分支。测试结果决定 If 函数返回的值。logical_test 可以是可将其求值结果确定为 true 或 false 的任何值或表达式。最多可以将七个 If 语句嵌套为 value_if_true、value_if_false 自变量。if 语句内的布尔语句必须包含在圆括号内。if 语句内的文本必须包含在引号内。

例如:

    =if(('Existing Tree'.'Condition'='Not Set'), '-', 'Existing Tree'.'Condition') 如果没有为现有树对象设置条件值,则此单元格中的值为短划线;否则,此单元格中的值是为树对象设置的条件值。

    =if(('Existing Tree'.'Condition'='Not Set'); '-'; 'Existing Tree'.'Condition') 当逗号用作操作系统的小数点分隔符时,请改用分号。

Image(条件)

(需要 Vectorworks Design Series)满足指定条件的与对象关联的图像。在单元格格式中,指定是否显示对象的缩略图或应用于对象的二维属性。

例如:

    数据库标题单元格:=Image 返回数据库中每个对象的图像

    电子表格单元格:=Image(s='cabinet') 返回名为 "Cabinet" 的符号的图像

ImageFill(条件)

符合指定条件的对象的图像填充。

例如:

    数据库标题单元格:=ImageFill 返回数据库中每个对象的图像填充

    电子表格单元格:=ImageFill(sel=true) 返回绘图中所选对象的图像填充

int(数字)

除去一个数字的任何小数部分。数字是要转换为整数的实数。相关函数:round 

例如:=int(B9) 返回单元格 B9 中去掉其小数部分的值

IsFlipped(条件)

符合指定条件对象的翻转状态。

例如:

    数据库标题单元格:=IsFlipped 返回数据库中每个对象的翻转状态

    电子表格单元格:=IsFlipped(PON=window) 返回已翻转绘图中窗口对象的总数

Layer(条件)

符合指定条件的对象的图层名称。

例如:

    数据库标题单元格:=Layer 返回数据库中每个对象的图层

    电子表格单元格:=Layer(sel=true) 返回绘图中所选对象的图层名称

LeftBound(条件)

符合指定条件的对象的二维左边界(最小 x 坐标)。相关函数:BotBound, TopBound, RightBound 

例如:

    数据库标题单元格:=LeftBound 返回数据库中每个对象的二维左边界

    电子表格单元格:=LeftBound(t=locus) 返回绘图中最左侧坐标点的二维左边界

Length(条件)

符合指定条件的线条、墙壁或基于路径对象的长度。

例如:

    数据库标题单元格:=Length 返回数据库中每个对象的长度

    电子表格单元格:=Length(t=line) 返回绘图中所有线条对象的总长

LineType(条件)

符合指定条件的对象的线型。

例如:

    数据库标题单元格:=LineType 返回数据库中每个对象的线型

    电子表格单元格:=LineType(sel=true) 返回绘图中所选对象的线型

ln(数字)

自然对数(底 e)。数字是要计算其对数的正实数。相关函数:exp 

例如:=ln(12) 返回 12 的自然对数

log(数字)

以 10 为底的对数。数字是要计算其对数的正实数。相关函数:ln 

例如:=ln(12) 返回 12 的自然对数

max(数值1, 数值2,...)

自变量列表中的最大数。数字是 1-14 个数字中要查找的最大值数字。相关函数:min 

例如:=max(C5,C7,C9) 返回单元格 C5、C7 和 C9 中的最大数字

min(数值1, 数值2,...)

自变量列表中的最小数。数字是 1-14 个数字中要查找的最小值数字。相关函数:max 

例如:=min(C5,C7,C9) 返回单元格 C5、C7 和 C9 中的最小数字

Name(条件)

符合指定条件的对象的名称。

例如:

    数据库标题单元格:=Name 返回数据库中每个对象的名称

    电子表格单元格:=Name(sel=true) 返回绘图中所选对象的名称

ObjectTexture(条件)

符合指定条件的对象的纹理。

例如:

    数据库标题单元格:=ObjectTexture 返回数据库中每个对象的纹理

    电子表格单元格:=ObjectTexture(sel=true) 返回绘图中所选对象的纹理

ObjectType(条件)

符合指定条件的对象的数字对象类型标识。对于对象类型标识列表,请参阅下述链接参阅面向开发人员的文档(需要访问网络):

developer.vectorworks.net/index.php/VS:Function_Reference_Appendix#objects

例如:

    数据库标题单元格:=ObjectType 返回数据库中每个对象的对象类型值

    电子表格单元格:=ObjectType(sel=true) 返回选定对象的对象类型值;例如,光源的对象类型值为 81

ObjectTypeName(条件)

符合指定条件的对象的类型名称。

例如:

    数据库标题单元格:=ObjectTypeName 返回数据库中每个对象的类型名称

    电子表格单元格:=ObjectTypeName(sel=true) 返回绘图中所选对象的类型名称

ObjIncludeInEnergos(条件)

(需要 Vectorworks Architect)符合指定条件的对象的 Energos 状态(如果它包含在计算中,则为 1;如果不包含在计算中,则为 0)。

例如:

    数据库标题单元格:=ObjIncludeInEnergos 对于数据库中的每个墙、圆墙、屋顶、屋顶表面、楼板、门以及窗对象,返回 Energos 状态

    电子表格单元格:=ObjIncludeInEnergos(t=wall) 返回绘图中所有墙壁的 Energos 状态

ObjRValue(条件)

(需要 Vectorworks Architect)符合指定条件的对象的 R 值。相关函数:ObjUValue 

例如:

    数据库标题单元格:=ObjectRValue 对于数据库中的每个墙、圆墙、屋顶、屋顶表面、楼板、门以及窗对象,返回 R 值

    电子表格单元格:=ObjectRValue(n='wall-1') 返回名为 “wall-1” 的墙壁的 R 值

ObjUValue(条件)

(需要 Vectorworks Architect)符合指定条件的对象的 U 值。相关函数:ObjRValue 

例如:

    数据库标题单元格:=ObjectUValue 对于数据库中的每个墙、圆墙、屋顶、屋顶表面、楼板、门以及窗对象,返回 U 值

    电子表格单元格:=ObjectUValue(n='wall-1') 返回名为 “wall-1” 的墙壁的 U 值

Perim(条件)

符合指定条件的对象的组合周长。

例如:

    数据库标题单元格:=Perim 返回数据库中每个对象的周长

    电子表格单元格:=Perim(sel=true) 返回所有选定对象的总周长

PlantImage(条件,数字)

(需要 Vectorworks Landmark)来自植物定义数据窗格的特定植物图像。指示 1、2、3 或 4 以分别从“图像植物形态”、“图像细节”、“图像杂项”或“自定义图像”中设置图像。在单元格格式中,按条件指定植物(通过选择具有条件的植物,例如“字段值 = 植物 ID = xx)。

例如:

    数据库标题单元格:=PlantImage(2) 在植物符号定义的“植物数据”窗格中显示为“图像细节”指定的图像

    电子表格单元格:=PlantImage((‘Plant’.’plant ID’=’TaxfR’), 4) 在植物符号定义的“植物数据”窗格中显示为“自定义图像”指定的图像,植物编号为 TaxfR

rad2deg(数字)

将一个数字从弧度转换为度数。数字是以弧度为单位、要将其转换为度数的值。

例如:=rad2deg(0.5235987) 将弧度角度测量结果转换为其对等的度数值

RightBound(条件)

符合指定条件的对象的二维右边界(最大 x 坐标)。相关函数:BotBound、TopBound、LeftBound 

例如:

    数据库标题单元格:=RightBound 返回数据库中每个对象的二维右边界

    电子表格单元格:=RightBound(t=rect) 返回绘图中最右侧矩形的二维右边界

RoofArea_Heated(条件)

沿斜坡的屋顶的受热面积(减去屋檐悬垂),为符合指定条件的所有对象组合该数据。相关函数:RoofArea_HeatedProj 

例如:

    数据库标题单元格:=RoofArea_Heated 返回绘图中每个屋顶和屋顶面对象的受热面积

    电子表格单元格:=RoofArea_Heated (st=roofface) 返回绘图中所有屋顶面对象的组合受热面积

RoofArea_HeatedProj(条件)

投影到图层平面的屋顶的受热面积(减去屋檐悬垂),为符合指定条件的所有对象组合该数据。相关函数:RoofArea_Heated 

例如:

    数据库标题单元格:=RoofArea_HeatedProj 返回数据库中每个屋顶和屋顶面对象投影到图层平面的受热面积

    电子表格单元格:=RoofArea_HeatedProj (t=roof) 返回绘图中所有屋顶对象投影到图层平面的组合受热面积

RoofArea_Total(条件)

沿着斜坡的屋顶面积。相关函数:RoofArea_TotalProj 

例如:

    数据库标题单元格:=RoofArea_Total 返回数据库中每个屋顶和屋顶面对象的总面积

    电子表格单元格:=RoofArea_Total(st=roofface) 返回绘图中所有屋顶面对象的组合总面积

RoofArea_TotalProj(条件)

投影到图层平面的屋顶的总面积。相关函数:RoofArea_Total 

例如:

    数据库标题单元格:=RoofArea_TotalProj 返回数据库中每个屋顶和屋顶面对象投影到图层平面的总面积

    电子表格单元格:=RoofArea_Totalproj(t=roof) 返回绘图中所有屋顶对象投影到图层平面的组合总面积

RoofStyleName(条件)

(需要 Vectorworks Design Series)屋顶样式的名称。

例如:

    数据库标题单元格:=RoofStyleName 返回数据库中每个屋顶对象的屋顶样式名称

    电子表格单元格:=RoofStyleName(n='roof-1') 返回名为 “roof-1” 的对象的屋顶样式名称

round(数字)

将指定数字四舍五入至最接近的整数。相关函数:int 

例如:=round(2.345) 返回 2

rounddown(数字,位数)

将指定的数字向下四舍五入到指定的小数位数。相关函数:round, roundup

例如:=rounddown(2.345, 2) 返回 2.34

roundup(数字,位数)

将指定的数字向上四舍五入到指定的小数位数。相关函数:round, rounddown

例如:=roundup(2.345, 2) 返回 2.35

RunScript(scriptName, param1, param2,...)

运行指定的 VectorScript 或 Python 脚本,将使用该脚本名称的参数传递到该脚本。脚本名称前面的可选参数指定该脚本在 Vectorworks 安装中的文件夹路径。对于文件夹路径值列表,请参阅下述面向开发人员的文档(需要访问网络):

developer.vectorworks.net/index.php/VS:GetFolderPath 

请参阅从工作表运行脚本了解细节。

例如:

    数据库标题单元格:=RunScript('My Script') 运行名为 “My Script” 的 VectorScript 脚本并为数据库中的每个对象返回一个值

    电子表格单元格:=RunScript(2, 'ScriptFile.py', 2, 1) 在 Vectorworks Plug-Ins 文件夹中执行 Python 脚本 “ScriptFile.py”,传递参数 “2” 和 “1”,并返回一个值

sin(数字)

给定角度的正弦。数字是以弧度表示、要计算其正弦的角度。相关函数:asin 

例如:=sin(deg2rad(32)) 将 32 度角转换为对等的弧度值,并返回该角度的正弦

SketchStyle(条件)

符合指定条件的对象的草图样式。

例如:

    数据库标题单元格:=SketchStyle 返回数据库中每个对象的草图样式

    电子表格单元格:=SketchStyle(sel=true) 返回绘图中所选对象的草图样式

SlabStyleName(条件)

(需要 Vectorworks Design Series)楼板样式的名称。

例如:

    数据库标题单元格:=SlabStyleName 返回数据库中每个楼板对象楼板样式的名称

    电子表格单元格:=SlabStyleName(n='slab-1') 返回名为“slab-1”的对象的楼板样式的名称

SlabThickness(条件)

(需要 Vectorworks Designer)符合指定条件的楼板对象(楼面和屋顶面)的组合厚度。

例如:

    数据库标题单元格:=SlabThickness 返回数据库中每个对象的厚度

    电子表格单元格:=SlabThickness(PON=slab) 返回绘图中所有楼板对象的组合厚度

sqrt(数字)

一个正平方根。数字是要计算其平方根的数字。

例如:=sqrt(D27) 返回单元格 D27 中的数字的平方根

Story(条件)

符合指定条件的对象的楼层名称。

例如:

    数据库标题单元格:=Story 返回数据库中每个对象的楼层名称

    电子表格单元格:=Story(sel=true) 返回绘图中所选对象的楼层名称

子字符串(文本/函数、分隔符、索引)

利用一个分隔符将单独字符串拆分成一个字符串阵列,并按指定索引输出每个字符串。

例如:=SUBSTRING(('kitchen;bedroom;bathroom;basement', ';', 2) 返回指定字符串中的第二个子字符串—— “bedroom”

sum(数字1, 数字2,...)

自变量列表中所有数字的总和。数字是 1-14 个要计算其总和的数字。相关函数:Average 

例如:=sum(A2,A10..A12) 返回包含在单元格 A2、A10、A11 和 A12 中的数字的总和

SurfaceArea(条件)

符合条件的所有对象的总曲面面积,基于“单位”对话框中的“面积”单位。

例如:

    数据库标题单元格:=SurfaceArea 返回数据库中每个对象的曲面面积

    电子表格单元格:=SurfaceArea(st=sphere) 返回绘图中所有球体对象的总曲面面积

SymbolName(条件)

符合指定条件的符号实例的符号名称。

例如:

    数据库标题单元格:=SymbolName 返回数据库中每个符号实例的名称

    电子表格单元格:=SymbolName(sel=true) 返回绘图中所选符号实例的符号名称

tan(数字)

给定角度的正切。数字是以弧度表示、要计算其正切的角度。相关函数:atan 

例如:=tan(deg2rad(32)) 将 32 度角转换为对等的弧度值,并返回该角度的正切

TopBound(条件)

符合指定条件的对象的二维上边界(最大 y 坐标)。相关函数:BotBound、LeftBound、RightBound 

例如:

    数据库标题单元格:=TopBound 返回数据库中每个对象的二维上边界

    电子表格单元格:=TopBound(sel=true) 返回最上方选定对象的二维上边界

value(文本)

将一个表示数字的文本字符串转换为一个数字。

例如:=value('2e3') 返回 2 乘以 10 的 3 次冪后得到的数值

体积(条件)

符合条件的所有对象的总体积,基于“单位”对话框中的“体积”单位。

例如:

    数据库标题单元格:=Volume 返回数据库中每个对象的体积

    电子表格单元格:=Volume(t=xtrd) 返回绘图中所有拉伸对象的总体积

WallArea_Gross(条件)

墙的内表面和外表面(忽略墙上的孔)的二维总表面积的平均值(对于符合指定条件的墙)。相关函数:WallArea_NetComponentAreaCompAreaByClassCompAreaByName 

例如:

    数据库标题单元格:=WallArea_Gross 返回数据库中每个墙的内墙面和外墙面总面积的平均值;总面积忽略墙上的孔

    电子表格单元格:=WallArea_Gross(t=wall) 返回墙内表面和外表面的总面积的平均值,组合了绘图中的所有墙;总面积忽略墙上的孔

WallArea_Net(条件)

墙的内表面和外表面(根据墙上的孔调整)的二维净表面积的平均值(对于符合指定条件的墙)。相关函数:WallArea_GrossComponentAreaCompAreaByClassCompAreaByName 

例如:

    数据库标题单元格:=WallArea_Net 返回数据库中每个墙的内表面和外表面净面积的平均值;净面积根据墙上的孔调整

    电子表格单元格:=WallArea_Net(t=wall) 返回墙内表面和外表面净面积的平均值,组合了绘图中的所有墙;净面积根据墙上的孔调整

WallAverageHeight(条件)

墙壁的平均高度,包括墙壁最高点和不同的开始和结束高度。

例如:

    数据库标题单元格:=WallAverageHeight 返回数据库中每个墙壁对象的平均高度

    电子表格单元格:=WallAverageHeight((t=wall)&(sel=true)) 返回绘图中已选定所有墙壁的平均高度

WallStyleName(条件)

(需要 Vectorworks Design Series)墙壁样式的名称。

例如:

    数据库标题单元格:=WallStyleName 返回数据库中每个墙壁对象墙壁样式的名称

    电子表格单元格:=WallStyleName(n='wall-1') 返回名为“wall-1”的对象的墙壁样式的名称

WallThickness(条件)

符合指定条件的墙壁对象的组合厚度。

例如:

    数据库标题单元格:=WallThickness 返回数据库中每个墙壁对象的厚度

    电子表格单元格:=WallThickness(t=wall) 返回绘图中所有墙壁的组合厚度

Width(条件)

符合指定条件的对象的组合Δ x(宽度)。相关函数:高度 

例如:

    数据库标题单元格:=Width 返回数据库中每个对象的宽度(Δ x)

    电子表格单元格:=Width(sel=true) 返回选定对象的组合宽度(Δ x 值)

XCenter(条件)

符合指定条件的对象中央点的 x 坐标。相关函数:YCenter、ZCenter、XCoordinate 

例如:

    数据库标题单元格:=XCenter 返回数据库中每个对象二维边界中央的 x 坐标值

    电子表格单元格:=XCenter(sel=true) 返回选定对象二维边界中央的 x 坐标值

XCoordinate(条件)

符号、点插件对象和坐标点的插入点的 x 坐标。返回值相对于用户原点。相关函数:YCoordinate、ZCoordinate、XCenter 

例如:

    数据库标题单元格:=XCoordinate 返回数据库中每个对象的 x 坐标值

YCenter(条件)

符合指定条件的对象中央点的 y 坐标。相关函数:XCenter、ZCenter、YCoordinate 

例如:

    数据库标题单元格:=YCenter 返回数据库中每个对象二维边界中央的 y 坐标值

    电子表格单元格:=YCenter(sel=true) 返回选定对象二维边界中央的 y 坐标值

YCoordinate(条件)

符号、点插件对象和坐标点的插入点的 y 坐标。返回值相对于用户原点。相关函数:XCoordinate、ZCoordinate、YCenter 

例如:

    数据库标题单元格:=YCoordinate 返回数据库中每个对象的 y 坐标值

ZCenter(条件)

符合指定条件的对象中央点的 z 坐标。相关函数:XCenter、YCenter、ZCoordinate 

例如:

    数据库标题单元格:=ZCenter 返回数据库中每个对象二维边界中央的 z 坐标值

    电子表格单元格:=ZCenter(sel=true) 返回选定对象二维边界中央的 z 坐标值

ZCoordinate(条件)

符号、点插件对象和坐标点的插入点的 z 坐标。返回值相对于用户原点。相关函数:XCoordinate、YCoordinate、ZCenter 

例如:

    数据库标题单元格:=ZCoordinate 返回数据库中每个对象的 z 坐标值

 

这个页面有帮助吗?