工作表函数

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

    数字或文本自变量:以小写字母开头的函数通常需要使用一个数字值或单元格地址作为自变量。例如,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 之间。

=acos(3/5)

(返回其余弦值为 3/5 的角度)

cos

Angle(条件)

符合指定条件对象的角度(从地平线开始测量,以度为单位)。

使用此函数可返回线条和墙的角度(从地平线开始测量)、圆弧的跨角和楼板的坡角。

数据库标题单元格:

=Angle

(返回数据库中每个对象的角度)

电子表格单元格:

=Angle((t=arc)&(n='arc-1'))

(返回绘图中名为 “arc-1” 圆弧对象的扫掠角)

 

Area(条件)

符合指定条件的二维对象的总面积,基于“单位”对话框中的“面积”单位

数据库标题单元格:

=Area

(返回数据库中每个对象的面积)

电子表格单元格:

=Area(t=rect)

(返回绘图中所有矩形对象的组合面积)

Perim

asin(数字)

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

数字是角度的正弦,必须介于 -1 至 1 之间。

=asin(A3)

(返回其正弦值为单元格 A3 中给定值的的角度)

sin

atan(数字)

一个数字的反正切。反正切是其正切为某个数字的角度。返回的角度以 -pi/2 至 pi/2 的弧度值表示。如要以度数为单位表示反正切,使用 rad2deg 函数(或将结果乘以 180/pi)。

数字是对应角度的正切。

=atan(4/3)

(返回其正切值为 4/3 的角度)

tan

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

自变量的平均(中间)值

=average(85,70,95)

(返回这三个数字的平均值)

max、min、sum

BotBound(条件)

符合指定条件的对象的二维下边界(最小 y 坐标)

数据库标题单元格:

=BotBound

(返回数据库中每个对象的二维下边界)

电子表格单元格:

=BotBound(t=locus)

(返回在绘图中具有最低二维下边界值的坐标点的二维下边界)

LeftBound、RightBound、TopBound

CompAreaByClass
(条件,类)

符合指定条件且在指定类中的组件的一侧的面积(减去所有孔)。

数据库标题单元格:

=CompAreaByClass('Class-1')

(对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回指派给 “Class-1” 类的组件的面积)

电子表格单元格:

=CompAreaByClass(t=wall,'Class-1')

(对于绘图中的所有墙,返回指派给 “Class-1” 类的组件的组合面积)

CompAreaByName, ComponentArea

CompAreaByName
(条件,名称)

符合指定条件且具有指定名称的组件的一侧的面积(减去所有孔)。

数据库标题单元格:

=CompAreaByName('Brick Veneer')

(对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回具有 “Brick Veneer” 名称的组件的面积)

电子表格单元格:

=CompAreaByName(t=wall,'Brick Veneer')

(对于绘图中的所有墙,返回具有 “Brick Veneer” 名称的组件的组合面积)

CompAreaByClass, ComponentArea

CompClassByName
(条件,名称)

符合指定条件且具有指定名称的组件名称

数据库标题单元格:

=CompClassByName('Brick Veneer')

(对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回具有 “Brick Veneer” 名称的组件的类)

电子表格单元格:

=CompClassByName(t=wall,'Brick Veneer')

(对于绘图中的所有墙,返回具有 “Brick Veneer” 名称的第一个组件的类)

CompNameByClass

CompLambdaByClass
(条件,类)

符合指定条件且在指定类中的组件的 Lambda 值

数据库标题单元格:

=CompLambdaByClass('Class-1')

(对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回指派给 “Class-1” 类的组件的 Lambda 值)

电子表格单元格:

=CompLambdaByClass(t=wall,'Class-1')

(对于绘图中的所有墙,返回指派给 “Class-1” 类的第一个组件的 Lambda 值)

CompLambdaByName, ComponentLambda

CompLambdaByName
(条件,名称)

符合指定条件且具有指定名称的组件的 Lambda 值

数据库标题单元格:

=CompLambdaByName('Brick Veneer')

(对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回具有 “Brick Veneer” 名称的组件的 Lambda 值)

电子表格单元格:

=CompLambdaByName(t=wall,'Brick Veneer')

(对于绘图中的所有墙,返回具有 “Brick Veneer” 名称的第一个组件的 Lambda 值)

CompLambdaByClass, ComponentLambda

CompNameByClass
(条件,类)

符合指定条件且在指定类中的组件的名称

数据库标题单元格:

=CompNameByClass('Class-1')

(对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回指派给 “Class-1” 类的组件的名称)

电子表格单元格:

=CompNameByClass(t=wall,'Class-1')

(对于绘图中的所有墙,返回指派给 “Class-1” 类的第一个组件的名称)

CompClassByName

ComponentArea
(criteria, index)

符合指定条件且具有指定索引的组件的一侧的面积(减去所有孔)。

索引为用于识别组件的从 1 开始的索引。

数据库标题单元格:

=ComponentArea(2)

(对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回第二个组件的面积)

电子表格单元格:

=ComponentArea(t=wall,1)

(返回绘图中所有墙的第一个组件的组合面积)

CompAreaByClass, CompAreaByName

ComponentLambda
(criteria, index)

符合指定条件且具有指定索引的组件的 Lambda 值

索引为用于识别组件的从 1 开始的索引。

数据库标题单元格:

=ComponentLambda(2)

(对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回第二个组件的 Lambda 值)

电子表格单元格:

=ComponentLambda(t=wall,1)

(返回绘图中所有墙的第一个组件的 Lambda 值)

CompLambdaByClass, CompLambdaByName

ComponentName
(criteria, index)

符合指定条件且具有指定索引的组件名称。

索引为用于识别组件的从 1 开始的索引。

数据库标题单元格:

=ComponentName(2)

(对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回第二个组件的名称)

电子表格单元格:

=ComponentName(t=wall,1)

(返回绘图中所有墙的第一个组件的名称)

CompNameByClass

ComponentRValue
(criteria, index)

符合指定条件且具有指定索引的组件的 R 值。

索引为用于识别组件的从 1 开始的索引。

数据库标题单元格:

=ComponentRValue(2)

(对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回第二个组件的 R 值)

电子表格单元格:

=ComponentRValue(t=wall,1)

(返回绘图中所有墙的第一个组件的组合 R 值)

CompRValueByClass, CompRValueByName

ComponentThickness
(criteria, index)

符合指定条件且具有指定索引的组件的厚度。

索引为用于识别组件的从 1 开始的索引。

数据库标题单元格:

=ComponentThickness(2)

(对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回第二个组件的厚度)

电子表格单元格:

=ComponentThickness(t=wall,1)

(返回绘图中所有墙的第一个组件的组合厚度)

CompThicknessByClass, CompThicknessByName

ComponentUValue
(criteria, index)

符合指定条件且具有指定索引的组件的 U 值。

索引为用于识别组件的从 1 开始的索引。

数据库标题单元格:

=ComponentUValue(2)

(对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回第二个组件的 U 值)

电子表格单元格:

=ComponentUValue(t=wall,1)

(返回绘图中所有墙的第一个组件的组合 U 值)

CompUValueByClass, CompUValueByName

ComponentVolume
(criteria, index)

符合指定条件且具有指定索引的组件的体积(减去所有孔)。

索引为用于识别组件的从 1 开始的索引。

数据库标题单元格:

=ComponentVolume(2)

(对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回第二个组件的体积)

电子表格单元格:

=ComponentVolume(t=wall,1)

(返回绘图中所有墙的第一个组件的组合体积)

CompVolumeByClass, CompVolumeByName

CompRValueByClass
(条件,类)

符合指定条件且在指定类中的组件的 R 值

数据库标题单元格:

=CompRValueByClass('Class-1')

(对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回指派给 “Class-1” 类的组件的 R 值)

电子表格单元格:

=CompRValueByClass(t=wall,'Class-1')

(对于绘图中的所有墙,返回指派给 “Class-1” 类的组件的组合 R 值)

CompRValueByName, ComponentRValue

CompRValueByName
(条件,名称)

符合指定条件且具有指定名称的组件的 R 值。

数据库标题单元格:

=CompRValueByName('Brick Veneer')

(对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回具有 “Brick Veneer” 名称的组件的 R 值)

电子表格单元格:

=CompRValueByName(t=wall,'Brick Veneer')

(对于绘图中的所有墙,返回具有 “Brick Veneer” 名称的组件的组合 R 值)

CompRValueByClass, ComponentRValue

CompThicknessByClass
(条件,类)

符合指定条件且在指定类中的组件的厚度

数据库标题单元格:

=CompThicknessByClass('Class-1')

(对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回指派给 “Class-1” 类的组件的厚度)

电子表格单元格:

=CompThicknessByClass(t=wall,'Class-1')

(对于绘图中的所有墙,返回指派给 “Class-1” 类的组件的组合厚度)

CompThicknessByName, ComponentThickness

CompThicknessByName
(条件,名称)

符合指定条件且具有指定名称的组件的厚度

数据库标题单元格:

=CompThicknessByName('Brick Veneer')

(对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回具有 “Brick Veneer” 名称的组件的厚度)

电子表格单元格:

=CompThicknessByName(t=wall,'Brick Veneer')

(对于绘图中的所有墙,返回具有 “Brick Veneer” 名称的组件的组合厚度)

CompThicknessByClass, ComponentThickness

CompUValueByClass
(条件,类)

符合指定条件且在指定类中的组件的 U 值

数据库标题单元格:

=CompUValueByClass('Class-1')

(对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回指派给 “Class-1” 类的组件的 U 值)

电子表格单元格:

=CompUValueByClass(t=wall,'Class-1')

(对于绘图中的所有墙,返回指派给 “Class-1” 类的组件的组合 U 值)

CompUValueByName, ComponentUValue

CompUValueByName
(条件,名称)

符合指定条件且具有指定名称的组件的 U 值。

数据库标题单元格:

=CompUValueByName('Brick Veneer')

(对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回具有 “Brick Veneer” 名称的组件的 U 值)

电子表格单元格:

=CompUValueByName(t=wall,'Brick Veneer')

(对于绘图中的所有墙,返回具有 “Brick Veneer” 名称的组件的组合 U 值)

CompUValueByClass, ComponentUValue

CompVolumeByClass
(条件,类)

符合指定条件且在指定类中的组件的体积

数据库标题单元格:

=CompVolumeByClass('Class-1')

(对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回指派给 “Class-1” 类的组件的体积)

电子表格单元格:

=CompVolumeByClass(t=wall,'Class-1')

(对于绘图中的所有墙,返回指派给 “Class-1” 类的组件的组合体积)

CompVolumeByName, ComponentVolume

CompVolumeByName
(条件,名称)

符合指定条件且具有指定名称的组件的体积。

数据库标题单元格:

=CompVolumeByName('Brick Veneer')

(对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回具有 “Brick Veneer” 名称的组件的体积)

电子表格单元格:

=CompVolumeByName(t=wall,'Brick Veneer')

(对于绘图中的所有墙,返回具有 “Brick Veneer” 名称的组件的组合体积)

CompVolumeByClass, ComponentVolume

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

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

=concat(B3,', ',B4)

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

 

cos(数字)

给定角度的余弦。

数字是以弧度表示、要计算其余弦的角度。

=cos(deg2rad(23))

(将 23 度角转换为对等的弧度值,并返回该角度的余弦)

acos

Count(条件)

符合条件的对象数量

数据库标题单元格:

=Count

(返回数据库中每行对象的总数)

电子表格单元格:

=Count(s='simple sofa')

(返回绘图中名为“simple sofa” 符号对象的总数)

 

CurtWallFrameLength
(条件,类)

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

数据库标题单元格:

=CurtWallFrameLength('')

(返回数据库中每个幕墙的幕墙框架的组合长度)

电子表格单元格:

=CurtWallFrameLength(t=wall, '')

(返回绘图中所有幕墙的幕墙框架的组合长度)

CurtWallPnlAreaNet, CurtWallPnlAreaGross

CurtWallPnlAreaGross(条件,类)

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

数据库标题单元格:

=CurtWallPnlAreaGross('')

(返回数据库中每个幕墙的幕墙面板的组合总面积)

电子表格单元格:

=CurtWallPnlAreaGross(t=wall, '')

(返回绘图中所有幕墙的幕墙面板的组合总面积)

CurtWallFrameLength, CurtWallPnlAreaNet

CurtWallPnlAreaNet
(条件,类)

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

数据库标题单元格:

=CurtWallPnlAreaNet ('Class-1')

(返回数据库中每个幕墙被指派给 “Class-1” 类的幕墙面板的组合净面积)

电子表格单元格:

=CurtWallPnlAreaNet(t=wall, 'Class-1')

(返回绘图中所有幕墙被指派给 “Class-1” 类的幕墙面板的组合净面积)

CurtWallFrameLength, CurtWallPnlAreaGross

deg2rad(数字)

将一个数字从度数转换为弧度。

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

=deg2rad(47)

(将 47 度角度测量结果转换为其对等的弧度值)

 

exp(数字)

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

数字是应用至底 e 的冪。

=exp(2)

(返回 e 的 2 次冪值)

ln

GetIfcProperty(条件)

(需要 Vectorworks Design Series)

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

=GETIFCPROPERTY ('ifcfurnishingelement.name')

(返回那个 IFC 实体为 IfcFurnishingElement 的 IFC 对象的“名称”值)

 

GetSpaceNameForObj
(条件)

(需要 Vectorworks Architect)

符合指定条件的对象周围的空间名称

数据库标题单元格:

=GetSpaceNameForObj

(返回数据库中每个对象的空间名称)

电子表格单元格:

=GetSpaceNameForObj(n='chair-1')

(返回名为 “chair-1” 的对象的空间名称)

GetSpaceNumForObj

GetSpaceNumForObj
(条件)

(需要 Vectorworks Architect)

符合指定条件的对象周围的空间编号

数据库标题单元格:

=GetSpaceNumForObj

(返回数据库中每个对象的空间编号)

电子表格单元格:

=GetSpaceNumForObj(n='chair-1')

(返回名为 “chair-1” 的对象的空间编号)

GetSpaceNameForObj

Height(条件)

符合指定条件的对象的组合Δ y(高度)

数据库标题单元格:

=Height

(返回数据库中每个对象的高度(Δ y))

电子表格单元格:

=Height(sel=true)

(返回绘图中选定对象的组合高度(Δ y)值)

宽度

if ((logical_test), value_if_true, value_if_false)

如果 logical_test 为 true,使用 value_if_true,如果 logical_test 为 false,使用 value_is_false。

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

=if((C7>100),100,C7)

如果操作系统将逗号用作小数点,使用分号代替:

=if((C7>100);100;C7)

(如果单元格 C7 中的值大于 100,则此单元格中的值为 100;否则此单元格中的值与单元格 C7 中的值相同)

 

Image(条件)

(需要 Vectorworks Design Series)

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

数据库标题单元格:

=Image

(返回数据库中每个对象的图像)

电子表格单元格:

=Image(s='cabinet')

(返回名为 "Cabinet" 的符号的图像)

 

int(数字)

除去一个数字的任何小数部分。

数字是要转换为整数的实数。

=int(B9)

(返回单元格 B9 中去掉其小数部分的值)

round

IsFlipped(条件)

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

数据库标题单元格:

=IsFlipped

(返回数据库中每个对象的翻转状态)

电子表格单元格:

=IsFlipped(PON=window)

(返回已翻转绘图中窗口对象的总数)

 

LeftBound(条件)

符合指定条件的对象的二维左边界(最小 x 坐标)

数据库标题单元格:

=LeftBound

(返回数据库中每个对象的二维左边界)

电子表格单元格:

=LeftBound(t=locus)

(返回绘图中最左侧坐标点的二维左边界)

BotBound, TopBound, RightBound

Length(条件)

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

数据库标题单元格:

=Length

(返回数据库中每个对象的长度)

电子表格单元格:

=Length(t=line)

(返回绘图中所有线条对象的总长)

 

ln(数字)

自然对数(底 e)。

数字是要计算其对数的正实数。

=ln(12)

(返回 12 的自然对数)

exp

log(数字)

以 10 为底的对数。

数字是要计算其对数的正实数。

=log(2)

(返回以 10 为底的 2 的对数)

ln

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

自变量列表中的最大数。

数字是 1 至 14 个要查找其中最大值的数字。

=max(C5,C7,C9)

(返回单元格 C5、C7 和 C9 中的最大数字)

min

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

自变量列表中的最小数。

数字是 1 至 14 个要查找其中最小值的数字。

=min(C5,C7,C9)

(返回单元格 C5、C7 和 C9 中的最小数字)

max

ObjectType(条件)

符合指定条件的对象的数字对象类型标识。

对于对象类型标识列表,请参阅下述链接参阅面向开发人员的文档:

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

数据库标题单元格:

=ObjectType

(返回数据库中每个对象的对象类型值)

电子表格单元格:

=ObjectType(sel=true)

(返回选定对象的对象类型值;例如,光源的对象类型值为 81)

 

ObjIncludeInEnergos
(条件)

(需要 Vectorworks Architect)

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

数据库标题单元格:

=ObjIncludeInEnergos

(对于数据库中的每个墙、圆墙、屋顶、屋顶表面、楼板、门以及窗对象,返回 Energos 状态)

电子表格单元格:

=ObjIncludeInEnergos(t=wall)

(返回绘图中所有墙的 Energos 状态)

 

ObjRValue(条件)

(需要 Vectorworks Architect)

符合指定条件的对象的 R 值

数据库标题单元格:

=ObjectRValue

(对于数据库中的每个墙、圆墙、屋顶、屋顶表面、楼板、门以及窗对象,返回 R 值)

电子表格单元格:

=ObjectRValue(n='wall-1')

(返回名为 “wall-1” 的墙的 R 值)

ObjUValue

ObjUValue(条件)

(需要 Vectorworks Architect)

符合指定条件的对象的 U 值

数据库标题单元格:

=ObjectUValue

(对于数据库中的每个墙、圆墙、屋顶、屋顶表面、楼板、门以及窗对象,返回 U 值)

电子表格单元格:

=ObjectUValue(n='wall-1')

(返回名为 “wall-1” 的墙的 U 值)

ObjRValue

Perim(条件)

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

数据库标题单元格:

=Perim

(返回数据库中每个对象的周长)

电子表格单元格:

=Perim(sel=true)

(返回所有选定对象的总周长)

 

rad2deg(数字)

将一个数字从弧度转换为度数。

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

=rad2deg(0.5235987)

(将弧度角度测量结果转换为其对等的度数值)

 

RightBound(条件)

符合指定条件的对象的二维右边界(最大 x 坐标)

数据库标题单元格:

=RightBound

(返回数据库中每个对象的二维右边界)

电子表格单元格:

=RightBound(t=rect)

(返回绘图中最右侧矩形的二维右边界)

BotBound、TopBound、LeftBound

RoofArea_Heated
(条件)

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

数据库标题单元格:

=RoofArea_Heated

(返回绘图中每个屋顶和屋顶面对象的受热面积)

电子表格单元格:

=RoofArea_Heated (st=roofface)

(返回绘图中所有屋顶面对象的组合受热面积)

RoofArea_HeatedProj

RoofArea_HeatedProj
(条件)

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

数据库标题单元格:

=RoofArea_HeatedProj

(返回数据库中每个屋顶和屋顶面对象投影到图层平面的受热面积)

电子表格单元格:

=RoofArea_Heatedproj(t=roof)

(返回绘图中所有屋顶对象投影到图层平面的组合受热面积)

RoofArea_Heated

RoofArea_Total
(条件)

沿着斜坡的屋顶面积

数据库标题单元格:

=RoofArea_Total

(返回数据库中每个屋顶和屋顶面对象的总面积)

电子表格单元格:

=RoofArea_Total(st=roofface)

(返回绘图中所有屋顶面对象的组合总面积)

RoofArea_TotalProj

RoofArea_TotalProj
(条件)

投影到图层平面的屋顶的总面积

数据库标题单元格:

=RoofArea_TotalProj

(返回数据库中每个屋顶和屋顶面对象投影到图层平面的总面积)

电子表格单元格:

=RoofArea_Totalproj(t=roof)

(返回绘图中所有屋顶对象投影到图层平面的组合总面积)

RoofArea_Total

RoofStyleName(条件)

(需要 Vectorworks Design Series)

屋顶样式的名称

数据库标题单元格:

=RoofStyleName

(返回数据库中每个屋顶对象的屋顶样式名称)

电子表格单元格:

=RoofStyleName(n='roof-1')

(返回名为 “roof-1” 的对象的屋顶样式名称)

 

round(数字)

将指定数字四舍五入至最接近的整数

=round(D11)

(将单元格 D11 中的值四舍五入返回为最接近的整数)

int

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(数字)

给定角度的正弦。

数字是以弧度表示、要计算其正弦的角度。

=sin(deg2rad(32))

(将 32 度角转换为对等的弧度值,并返回该角度的正弦)

asin

SlabStyleName

(需要 Vectorworks Architect)

楼板样式的名称

数据库标题单元格:

=SlabStyleName

(返回数据库中每个楼板对象楼板样式的名称)

 

SlabThickness(条件)

(需要 Vectorworks Architect)

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

数据库标题单元格:

=SlabThickness

(返回数据库中每个对象的厚度)

电子表格单元格:

=SlabThickness(PON=slab)

(返回绘图中所有楼板对象的组合厚度)

 

sqrt(数字)

一个正平方根。

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

=sqrt(D27)

(返回单元格 D27 中的数字的平方根)

 

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

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

=SUBSTRING(('kitchen;bedroom;bathroom;basement', ';', 2)

(返回指定字符串中的第二个子字符串—— “bedroom”)

 

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

自变量列表中所有数字的总和。

数字是 1 至 14 个要计算其总和的数字。

=sum(A2,A10..A12)

(返回包含在单元格 A2、A10、A11 和 A12 中的数字的总和)

Average

SurfaceArea(条件)

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

数据库标题单元格:

=SurfaceArea

(返回数据库中每个对象的曲面面积)

电子表格单元格:

=SurfaceArea(st=sphere)

(返回绘图中所有球体对象的总曲面面积)

 

tan(数字)

给定角度的正切。

数字是以弧度表示、要计算其正切的角度。

=tan(deg2rad(32))

(将 32 度角转换为对等的弧度值,并返回该角度的正切)

atan

TopBound(条件)

符合指定条件的对象的二维上边界(最大 y 坐标)

数据库标题单元格:

=TopBound

(返回数据库中每个对象的二维上边界)

电子表格单元格:

=TopBound(sel=true)

(返回最上方选定对象的二维上边界)

BotBound、LeftBound、RightBound

value(文本)

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

=value('2e3')

(返回 2 乘以 10 的 3 次冪后得到的数值)

 

Volume(条件)

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

数据库标题单元格:

=Volume

(返回数据库中每个对象的体积)

电子表格单元格:

=Volume(t=xtrd)

(返回绘图中所有拉伸对象的总体积)

 

WallArea_Gross
(条件)

符合指定条件的墙的一个墙面的组合二维总曲面面积

数据库标题单元格:

=WallArea_Gross

(返回数据库中每个墙的一个墙面的总曲面面积)

电子表格单元格:

=WallArea_Gross(t=wall)

(返回绘图中所有墙的一个墙面的组合总曲面面积)

WallArea_Net

WallArea_Net(条件)

符合指定条件的墙的一个墙面的组合二维净曲面面积,不含门、窗和插入符号的面积

数据库标题单元格:

=WallArea_Net

(返回数据库中每个对象的一个墙面的净曲面面积,减去插入对象面积)

电子表格单元格:

=WallArea_Net(t=wall)

(返回绘图中所有墙的一个墙面的组合净曲面面积,减去插入对象面积)

WallArea_Gross

WallAverageHeight
(条件)

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

数据库标题单元格:

=WallAverageHeight

(返回数据库中每个墙对象的平均高度)

电子表格单元格:

=WallAverageHeight((t=wall)&
(sel=true))

(返回绘图中已选定所有墙的平均高度)

 

WallStyleName(条件)

(需要 Vectorworks Architect 或 Landmark)

墙样式的名称

数据库标题单元格:

=WallStyleName

(返回数据库中每个墙对象墙样式的名称)

 

WallThickness(条件)

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

数据库标题单元格:

=WallThickness

(返回数据库中每个墙对象的厚度)

电子表格单元格:

=WallThickness(t=wall)

(返回绘图中所有墙的组合厚度)

 

Width(条件)

符合指定条件的对象的组合Δ x(宽度)

数据库标题单元格:

=Width

(返回数据库中每个对象的宽度(Δ x))

电子表格单元格:

=Width(sel=true)

(返回选定对象的组合宽度(Δ x 值))

高度

XCenter(条件)

符合指定条件的对象中心点的 x 坐标

数据库标题单元格:

=XCenter

(返回数据库中每个对象二维边界中心的 x 坐标值)

电子表格单元格:

=XCenter(sel=true)

(返回选定对象二维边界中心的 x 坐标值)

YCenter、ZCenter、XCoordinate

XCoordinate(标准)

符号、点插件对象和坐标点的插入点的 x 坐标。

返回值相对于用户原点。

数据库标题单元格:

=XCoordinate

(返回数据库中每个对象的 x 坐标值)

YCoordinate、ZCoordinate、XCenter

YCenter(条件)

符合指定条件的对象中心点的 y 坐标

数据库标题单元格:

=YCenter

(返回数据库中每个对象二维边界中心的 y 坐标值)

电子表格单元格:

=YCenter(sel=true)

(返回选定对象二维边界中心的 y 坐标值)

XCenter、ZCenter、YCoordinate

YCoordinate(条件)

符号、点插件对象和坐标点的插入点的 y 坐标。

返回值相对于用户原点。

数据库标题单元格:

=YCoordinate

(返回数据库中每个对象的 y 坐标值)

XCoordinate、ZCoordinate、YCenter

ZCenter(条件)

符合指定条件的对象中心点的 z 坐标

数据库标题单元格:

=ZCenter

(返回数据库中每个对象三维边界中心的 z 坐标值)

电子表格单元格:

=ZCenter(sel=true)

(返回选定对象三维边界中心的 z 坐标值)

XCenter、YCenter、ZCoordinate

ZCoordinate(条件)

符号、点插件对象和坐标点的插入点的 z 坐标。

返回值相对于用户原点。

数据库标题单元格:

=ZCoordinate

(返回数据库中每个对象的 z 坐标值)

XCoordinate、YCoordinate、ZCenter

~~~~~~~~~~~~~~~~~~~~~~~~~

在电子表格单元格中输入数据

在数据库行中输入数据

 

vectorworks.cn