GetString Class

Constructs a new GetString.

If you want to allow the user to be able to type in a color r,g,b or name during GetPoint.Get(), GetObject::GetObjects(), etc., then call AcceptColor(true) before calling GetPoint()/GetObject(). If the user chooses to type in a color, then the result code GetResult.Color is returned and you can use RhinoGet.Color() to get the value of the color. If the get accepts points, then the user will not be able to type in r,g,b colors but will be able to type color names.

There are instances of RhinoGet that prompt with "Press Enter when Done." yet do not call AcceptNothing(). On the Mac, these instances need an additional call to AcceptEnterWhenDone() so the GetPointOptions dialog can correctly enable the Done button.

If you want to allow the user to be able to press enter in order to skip selecting a something in GetPoint.Get(), GetObject::GetObjects(), etc., then call AcceptNothing( true ) beforehand.

If you want to allow the user to be able to type in a number during GetPoint.Get(), GetObject::GetObjects(), etc., then call AcceptNumber() beforehand. If the user chooses to type in a number, then the result code GetResult.Number is returned and you can use RhinoGet.Number() to get the value of the number. If you are using GetPoint and you want "0" to return (0,0,0) instead of the number zero, then set acceptZero = false.

If you want to allow the user to be able to type in a point then call AcceptPoint(true) before calling GetPoint()/GetObject(). If the user chooses to type in a number, then the result code GetResult.Point is returned and you can use RhinoGet.Point() to get the value of the point.

If you want to allow the user to be able to type in a string during GetPoint.Get(), GetObject::GetObjects(), etc., then call AcceptString(true) before calling GetPoint()/GetObject(). If the user chooses to type in a string, then the result code GetResult.String is returned and you can use RhinoGet.String() to get the value of the string.

If you want to allow the user to have an 'undo' option in GetPoint.Get(), GetObject.GetObjects(), etc., then call AcceptUndo(true) beforehand.

Adds a command line option.

Adds a command line option.

Adds a command line option.

Adds a command line option.

Adds a command line option.

Adds a command line option.

Add a command line option to get colors and automatically save the value.

Add a command line option to get colors and automatically save the value.

Add a command line option to get colors and automatically save the value.

Add a command line option to get colors and automatically save the value.

Adds a command line option to get numbers and automatically save the value.

Adds a command line option to get numbers and automatically save the value.

Adds a command line option to get numbers and automatically saves the value.

Adds a command line option to get numbers and automatically save the value.

Adds a choice of enumerated values as list option

Adds a choice of enumerated values as list option. Allows to include only some enumerated values.

Adds a list of enumerated values as option list. Use enumSelection[go.Option.CurrentListOptionIndex] to retrieve selection.

Adds a command line option to get integers and automatically save the value.

Adds a command line option to get integers and automatically save the value.

Adds a command line option to get integers and automatically save the value.

Adds a command line option to get integers and automatically save the value.

Adds a command line list option.

Adds a command line list option.

Adds a command line option to toggle a setting.

Adds a command line option to toggle a setting.

Clear all command options.

Clears any defaults set using SetDefaultPoint, SetDefaultNumber, SetDefaultString, or SetCommandPromptDefault.

Gets a color if Get*() returns GetResult.Color.

Helper method for getting command result value from getter results.

Control the availability of transparent commands during the get.

Determines whether the specified object is equal to the current object.

Returns the string that the user typed. By default, space stops the string input.

Serves as the default hash function.

Returns the string that the user typed. By default, space does not stop input.

Returns the selected enumerated value. Use this in combination with AddOptionEnumListT(String, T).

This must be called directly after having called a Get method, and having obtained a Option value.

Returns the selected enumerated value by looking at the list of values from which to select. Use this in combination with AddOptionEnumSelectionListT(String, IEnumerableT, Int32)

Gets the Type of the current instance.

Returns true if user pressed Enter to accept a default point, number, or string set using SetDefaultPoint, SetDefaultNumber, or SetDefaultString.

Returns two points defining the location in the view window of the 2d line selected in GetPoint::Get2dLine().

(0,0) = upper left corner of window.

Creates a shallow copy of the current Object.

Gets a number if GetPoint.Get(), GetObject.GetObjects(), etc., returns GetResult.Number.

If the get was a GetObjects() and the mouse was used to select the objects, then the returned rectangle has left < right and top < bottom. This rectangle is the Windows GDI screen coordinates of the picking rectangle. RhinoViewport.GetPickXform( pick_rect, pick_xform ) will calculate the picking transformation that was used. In all other cases, left=right=top=bottom=0;

Gets a point if Get*() returns GetResult.Point.

Returns location in view of point in selected in GetPoint::Get() or GetPoint::Get2dPoint(). (0,0) = upper left corner of window.

Returns the location in the view of the 2d rectangle selected in GetPoint::Get2dRectangle(). rect.left < rect.right and rect.top < rect.bottom (0,0) = upper left corner of window.

Returns result of the Get*() call.

Sets prompt message that appears in the command prompt window.

Sets message that describes what default value will be used if the user presses enter. This description appears in angle brackets <> in the command prompt window. You do not need to provide a default value description unless you explicitly enable AcceptNothing.

Sets a color as default value that will be returned if the user presses ENTER key during the get.

Sets a number as default value that will be returned if the user presses ENTER key during the get.

Sets a number as default value that will be returned if the user presses ENTER key during the get.

Sets a point as default value that will be returned if the user presses the ENTER key during the get.

Sets a string as default value that will be returned if the user presses ENTER key during the get.

Sets a command line option value to print "Varies" instead of the regular value.

Sets the wait duration (in milliseconds) of the getter. If the duration passes without the user making a decision, the GetResult.Timeout code is returned.

Gets a string if GetPoint.Get(), GetObject.GetObjects(), etc., returns GetResult.String.

Returns a string that represents the current object.

Gets a direction if Get*() returns GetResult.Point (Set by some digitizers, but in general it's (0,0,0).

Gets a view the user clicked in during GetPoint.Get(), GetObject.GetObjects(), etc.