4.3 矢量图形和表格

用户可以使用 MicroCity 脚本操作 形状（Shapes） 和 表格（Tables）。有关形状（Shapes）的详细数据结构，您可以参考上一章节 2.2 和 3.2。由于形状（Shapes）可以被视为带有地理数据的表格（Tables），因此一些用于表格数据操作的嵌入函数可以在 形状（Shapes） 和 表格（Tables） 中同时使用。本章节的示例代码可以在 项目（Project） 选项卡的"shapes_samples"文件夹中找到，该文件夹位于 ScriptEditor。

表格数据操作

CreateShapes ("name", "Point|Line|Polygon")

返回一个 Shapes 对象。

CreateTable ("Name")

返回一个 Table 对象。

GetFieldCount (Shapes|Table)

返回 Shapes 或 Table 中字段的数量。

GetField (Shapes|Table, iField)

输入字段的索引（从 1 开始）并返回字段名和类型（"Int"、"Float"、"Double" 或 "String"）。

AddField (Shapes|Table, "field1", "Int|Float|Double|String" [, "field2", "Int|Float|Double|String", ...])

向 *Table 或 Shapes 添加字段，并按照顺序返回布尔值（true 或 false）。

DelField (Shapes|Table, iField)

成功删除字段时返回 true。

GetRecCount (Shapes|Table)

返回 Shapes 或 Table 中的记录总数。

AddRecord (Shapes|Table)

向 Shapes 或 Table 添加一条记录，并返回该记录的索引。

GetValue (Shapes|Table, "field_name", index1 [, index2, ...])

从指定字段和 Shapes 或 Table 的索引中检索值。按照索引的顺序返回多个值。

SetValue (Shapes|Table, value, "field_name", index1 [, index2, ...])

为指定字段和 Shapes 或 Table 的索引设置值。

地理数据操作

GetSelections (Shapes)

从Shapes中返回所选的形状对象。

GetShape (Shapes, index1 [, index2, ...])

按索引顺序从Shapes中返回Shape对象。

AddShape (Shapes, Shape)

将Shape对象添加到Shapes中并返回其索引。

AddShape (Shapes [, x1, y1, x2, y2, ...])

将定义为点的Shape对象添加到Shapes中。返回Shape对象和索引。

DelShape (Shape|Shapes)

删除一个Shape或Shapes对象，如果成功则返回true。

AddPoint (Shape, x, y [, iPart = 1])

在Shape中添加一个点，如果成功则返回true。

InsPoint (Shape, x, y [, iPoint = 1 [, iPart = 1]])

在Shape中插入一个点，如果成功则返回true。

SetPoint (Shape, x, y [, iPoint = 1 [, iPart = 1]])

设置Shape中的点坐标，如果成功则返回true。

DelPoint (Shape, iPoint [, iPart=1])

从Shape中删除位置为iPoint的一个点，如果成功则返回true。

DelPart (Shape, iPart)

从Shape中删除一个部分，如果成功则返回true。

GetPartCount (Shape)

返回Shape中部分的数量。

GetPointCount (Shape [, iPart])

返回Shape中点的数量。

GetPointXY (Shape [, iPoint [, iPart = 1]])

从Shape或指定点的坐标中返回所有点的坐标：x1，y1，x2，y2，...。

CopyShapeTo (TargetShapes, dx, dy, Shape1 [, Shape2, ...])

将Shape对象复制到目标Shapes，并进行相对平移（dx，dy），返回新的Shape对象。

MoveShapeTo (dx, dy, Shape1 [, Shape2, ...])

将Shape对象平移到其相对位置（dx，dy）。

GetCenterXY (Shapes)

返回Shapes的中心坐标（x，y）。

GetCenterXY (Shapes, index1 [, index2, ...])

返回在Shapes中由索引指定的Shape对象的中心坐标（x1，y1，x2，y2，...）。

GetCenterXY (Shape1 [, Shape2, ...])

返回Shape对象的中心坐标（x1，y1，x2，y2，...）。

GetDistance (x1, y1, x2, y2 [, x3, y3, ...])

返回每两个坐标（x，y）对之间的总距离。

GetShapeLen (Shape1 [, Shape2, ...])

返回Shape对象的长度。

GetShapeArea (Shape1 [, Shape2, ...])

返回Shape对象的面积。

GetShapeType (Shape|Shapes)

返回Shapes或Shape对象的类型（"Point"，"Line"或"Polygon"）。

GetExtent (Shapes)

返回Shapes的范围坐标（Lx，By，Rx，Ty）。

GetExtent (Shapes, index)

返回Shapes中索引为index的Shape的范围坐标（Lx，By，Rx，Ty）。

GetExtent (Shape)

返回Shape的范围坐标（Lx，By，Rx，Ty）。

GetIntersection (ShapeA, ShapeB)

返回两个Shapes的交集的Shape（Point，Line或Polygon）对象。

GetValue (Shape, "field_name")

返回Shape的指定字段的值。

SetValue (Shape, value1, "field_name1" [, value2, "field_name2", ...])

为Shape的不同字段设置值。

SetCoorSys ("Earth"|"Non-Earth")

设置坐标系统。如果使用"Earth"，距离、长度和面积将根据地球椭球坐标系统计算。默认情况下使用"Non-Earth"，即笛卡尔坐标系统。

这篇文章使用ChatGPT翻译自其他语言，如果有问题请在反馈页面提交反馈。