Prompts the user to pick or select one or more objects.
Rhino.GetObjectsEx ([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 that contains arrays of selection information if successful. The array of selection information will contain the following:
|
||||||||||||
Null |
If not successful, or on error. |
Dim arrObjects, arrObj
arrObjects = Rhino.GetObjectsEx("Select object", 0, True)
If IsArray(arrObjects) Then
For Each arrObj In arrObjects
Rhino.Print "Object id = " & arrObj(0)
Rhino.Print "Object was preselected = " & CStr(arrObj(1))
Select Case arrObj(2)
Case 0
Rhino.Print "Selection method = 0 (non-mouse)"
Case 1
Rhino.Print "Selection method = 1 (mouse)"
Rhino.Print "Pick point = " & Rhino.Pt2Str(arrObj(3))
Case 2
Rhino.Print "Selection method = 1 (window)"
Case 3
Rhino.Print "Selection method = 1 (crossing)"
End Select
Rhino.Print "Active view = " & CStr(arrObj(4))
Next
End If