提示用户选取一个或多个物件。
rhinoscriptsyntax.GetObjects ( message=None, filter=0, group=True, preselect=False, select=False, objects=None, minimum_count=1, maximum_count=0, custom_filter=None )
rhinoscript.selection.GetObjects ( message=None, filter=0, group=True, preselect=False, select=False, objects=None, minimum_count=1, maximum_count=0, custom_filter=None )
message |
可选参数。字符串。提示信息。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
filter |
可选参数。数字。可以选取的物件类型(点,曲线,曲面,网格等)。类型代码可以相加代入此参数,以实现多种类型物件的选取。
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
group |
可选参数。布尔值。群组选取。如果省略此参数,用户选取一个群组中的物件,整个群组都会被选取 (True)。注意,如果 filter参数不为 0 (所有物件),群组选取失效。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
preselect |
可选参数。布尔值。允许直接使用执行函数之前选取的物件。如果省略,将不会使用之前选取的物件(False)。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
select |
可选参数。布尔值。函数执行结束以后选取的物件是否为选中状态。如果省略,函数执行之前选取的物件依旧为选中状态,之后选取的物件依旧为非选中状态。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
objects |
可选参数。列表。允许选取物件的 Guid 构成的列表。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
minimum_count |
可选参数。数字。最小选取数量。如果省略,至少选取一个(1)物件。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
maximum_count |
可选参数。数字。最大选取数量。如果为 0 (默认值),用户必须按回车键以完成选取。如果为 -1 选取数量达到最小选取数量时完成选取。如果大于 0 ,达到最大选取数量时完成选取。如果在视图中框选物件的数量大于最大选取数量,这种框选将被忽略。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
custom_filter |
可选参数。传递 Rhino 物件、几何体、元素序号给函数,返回 True 或 False 表明物件是否能被选取。 |
列表 |
由选取的物件 Guid 构成的列表。 |
import rhinoscriptsyntax as rs
objectIds = rs.GetObjects("Pick some curves", rs.filter.curve)
for id in objectIds: print "Object identifier:", id