PickBox Method (PickBoxStyle, String)


Invokes a general purpose two-click editor that lets the user to specify a rectangular area on the screen.

Namespace: Autodesk.Revit.UI.Selection
Assembly: RevitAPIUI (in RevitAPIUI.dll) Version: 24.0.0.0 (24.0.0.0)

Syntax

C#
public PickedBox PickBox(
	PickBoxStyle style,
	string statusPrompt
)
Visual Basic
Public Function PickBox ( _
	style As PickBoxStyle, _
	statusPrompt As String _
) As PickedBox
Visual C++
public:
PickedBox^ PickBox(
	PickBoxStyle style, 
	String^ statusPrompt
)

Parameters

style
Type: Autodesk.Revit.UI.SelectionPickBoxStyle
Specifies the value that controls the style of the pick box.
statusPrompt
Type: SystemString
The message shown on the status bar.

Return Value

The picked box that contains two XYZ points.

Remarks

The method starts an editor and returns when it finishes. Returns a PickedBox that contains two XYZ points.

Exceptions

ExceptionCondition
Autodesk.Revit.ExceptionsArgumentOutOfRangeExceptionThrown when the style is not a recognized value.
Autodesk.Revit.ExceptionsArgumentNullExceptionThrown when the argument statusPrompt is a null reference (Nothing in Visual Basic).
Autodesk.Revit.ExceptionsOperationCanceledExceptionThrown when the Revit user cancelled this operation. Thrown when the Revit user tried to switch the active view, close the active document or Revit application when responding to this mode.

See Also