Prompts the user to pick or select one or more objects.
Rhino.GetObjects ([strMessage [, intType [, blnGroup [, blnPreSelect [, blnSelect [, arrObjects [, intMin [, intMax ]]]]]]])
strMessage |
Optional. String. A prompt or message. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
intType |
Optional. Number. The type(s) of geometry objects (points, curves, surfaces, meshes, etc.) that can be selected. Object types can be added together to filter several different kinds of geometry.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
blnGroup |
Optional. Boolean. Honor object grouping. If omitted and the user picks a group, the entire group will be picked (True). Note, if intType is set to a value other than 0 (All objects), then group selection will be disabled. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
blnPreSelect |
Optional. Boolean. Allow for the selection of pre-selected objects. If omitted, pre-selected objects are not accepted (False). |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
blnSelect |
Optional. Boolean. Specifies whether or not the picked objects will remain selected when the function ends. If omitted, objects that were pre-picked will remain selected and the objects that were post-picked will not be selected. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
arrObjects |
Optional. Array. An array of strings identifying the objects that are allowed to be selected. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
intMin |
Optional. Number. The minimum number of objects to select. If omitted, then at least one (1) object must be selected. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
intMax |
Optional. Number. The maximum number of objects to select. If 0 (Default), then the user must press enter to finish object selection. If -1, then object selection stops as soon as there are at least intMin of object selected. If >0, then the picking stops when there are intMax objects. If a window pick, crossing pick, or Sel* command attempts to add more than intMax, then the attempt is ignored. |
Array |
An array of strings identifying the picked objects if successful. |
Null |
If not successful, or on error. |
Dim arrObjects, strObject
arrObjects = Rhino.GetObjects("Pick some curves", 4)
If IsArray(arrObjects) Then
For Each strObject In arrObjects
Rhino.Print "Object identifier: " & strObject
Next
End If