UserInputEvents.OnSelect Event
Parent Object: UserInputEventsDescription
Fires when the user selects an object by clicking.
Syntax
UserInputEvents.OnSelect( JustSelectedEntities As ObjectsEnumerator, MoreSelectedEntities As ObjectCollection, SelectionDevice As SelectionDeviceEnum, ModelPosition As Point, ViewPosition As Point2d, View As View )Parameters
Name | Type | Description |
JustSelectedEntities | ObjectsEnumerator | Returns the object(s) that were just selected by the user. This may be the only one selected so far or the latest one in a series during this selection process. Multiple objects may be returned if the user does a window (area) select. |
MoreSelectedEntities | ObjectCollection | Subsequently selected entities. |
SelectionDevice | SelectionDeviceEnum | Returns a constant denoting whether the selection was made via a pick in a graphics window or was it by a pick in the browser or by some other means. An object can also be selected programmatically by calling the selection simulation methods on the CommandManager. A value of kGraphicsWindowSelection indicates it was selected in a graphic window. For all other values the View, ModelPosition, and ViewPosition arguments are meaningless. |
ModelPosition | Point | Returns the coordinates that result from projecting the click point onto the selected entity. This is returned in centimeters relative to model space. Applicable only when the SelectionDevice argument is kGraphicsWindowSelection. |
ViewPosition | Point2d | Returns the coordinates that specify the current location of the mouse pointer in window space and are returned in pixels. Applicable only when the SelectionDevice argument is kGraphicsWindowSelection. |
View | View | Returns the View object where the selection took place. Applicable only when the SelectionDevice argument is kGraphicsWindowSelection. |