geAddSelectBox

geAddSelectBox( 
[ w_windowId ] 
[ g_partial ] 
[ l_bBox ] 
) 
=> t / nil 

Description

Implements the add mode of area selection. With no arguments given, it prompts you to enter the area to be selected in the current window. Partial selection is performed only when the window environment variable partialSelect is set and the stretch command is active. Partial selection lets you select an edge, vertex, or endpoint of an object to stretch.

Arguments

w_windowId	Database ID of the window containing the objects.
g_partial	Partial selection is used only in conjunction with the stretch command. In this case, this function indicates whether partial selection (t) or full selection (nil) should be performed. If you use partial selection with the move command, the selection mode is always set to full selection and cannot be overwritten. Valid Values: t, nil
l_bBox	The bounding box to be used for selection. When no bBox is specified, this function operates interactively.

Value Returned

t	The selection is performed.
nil	The selection is not performed.

Examples

Selects the objects in win1 enclosed in the bounding box described by the coordinates 0:0, 25:25 and adds them to the selected set. Partial selection is not performed.

geAddSelectBox( win1 nil list(0:0 25:25) )

Related Topics

partialSelect

Object Stretching

Selection Functions

Return to top