GetObjectGrips

Prompts the user to pick or select one or more object grips from one or more objects.

Syntax

Rhino.GetObjectGrips ([strMessage [, blnPreSelect [, blnSelect]]])

Parameters

strMessage

Optional.  String.  A prompt or message.

blnPreSelect

Optional.  Boolean.  Allow for the selection of a pre-selected object grips.  If omitted, pre-selected object grips are not accepted (False).

blnSelect

Optional.  Boolean.  Select the picked object grips.  If omitted, the object grips that are picked is not selected (False).

Returns

Array

A one-dimensional array containing one or more object grip records if successful. An object grip record itself is a one-dimensional array that contains the following three elements:

Element

Type

Description

0

String

The identifier of the object that owns the grip.

1

Number

The zero-based index value of the grip.

2

Array

A 3-D point identifying the location of the grip.

Null

If not successful, or on error.

Example

Dim arrCurves, strCurve, arrGrips, arrGrip

arrCurves = Rhino.GetObjects("Select curves", 4)

If IsArray(arrCurves) Then

For Each strCurve In arrCurves

Rhino.EnableObjectGrips strCurve

Next

arrGrips = Rhino.GetObjectGrips("Select curve grips")

If IsArray(arrGrips) Then

For Each arrGrip In arrGrips

Rhino.Print arrGrip(0)

Next

End If

End If

Also See

GetObjectGrip