Prompts the user to pick, or select, a single object.
Rhino.GetObjectEx ([strMessage [, intType [, blnPreSelect [, blnSelect [, arrObjects ]]]]])
strMessage |
Optional. String. A prompt or message. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
intType |
Optional. Number. The type or types 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.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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. |
Array |
An array of selection information if successful. The array will contain the following information:
|
||||||||||||
Null |
If not successful, or on error. |
Dim arrObject
arrObject = Rhino.GetObjectEx("Select object", 0, True)
If IsArray(arrObject) Then
Rhino.Print "Object id = " & arrObject(0)
Rhino.Print "Object was preselected = " & CStr(arrObject(1))
Select Case arrObject(2)
Case 0
Rhino.Print "Selection method = 0 (non-mouse)"
Case 1
Rhino.Print "Selection method = 1 (mouse)"
Rhino.Print "Pick point = " & Rhino.Pt2Str(arrObject(3))
Case 2
Rhino.Print "Selection method = 1 (window)"
Case 3
Rhino.Print "Selection method = 1 (crossing)"
End Select
Rhino.Print "Active view = " & CStr(arrObject(4))
End If