schSelectPoint

schSelectPoint( 
w_windowId 
l_pt 
g_isPartial 
g_isAdditive 
x_timeDelay 
)
=> t / nil

Description

Interactively selects the object under the cursor. With single selection, this function first deselects all objects on the selected set. With additive selection, this function maintains the selected set and adds the current object to the selected set.

These procedures have the same functionality as mouseSingleSelectPt and mouseAddSelectPt as defined by the schematic editor.

This function also sets the most-recently selected object needed by extended selection. If time has not expired (as defined by x_timeDelay), this function calls extended selection instead of simple selection.

You can use this function only for schematics.

Arguments

w_windowId	Window in which to apply selection.
l_pt	List of X and Y coordinates that define the selection area.
g_isPartial	Boolean flag that specifies if partial selection is supported.
g_isAdditive	Boolean flag that specifies if selection is single or additive.
x_timeDelay	Specifies how much time must elapse before the selection becomes simple selection. If the command is executed a second time before time has elapsed, extended selection is applied.

Value Returned

t	Interactively selects the object under the cursor.
nil	Selection was unsuccessful.

Examples

Deselects all objects. If the cursor is over an object, the object is selected.

schSelectPoint( hiGetCurrentWindow( ) hiGetCommandPoint( ) t nil 0)

If the cursor is over the object, the object is added to the selected set.

schSelectPoint( hiGetCurrentWindow( ) hiGetCommandPoint( ) nil t 0 )

Return to top