schDirectEdit

schDirectEdit( 
x_index 
)
=> t

Description

Directly edits or manipulates the object under the cursor. Usable when editing schematics and symbols.

If the object is under the cursor or if the object is in the selected set, you can modify all objects in the selected set. If the object under the cursor is not in the selected set, you can modify only that object. If there is no object under the cursor, the SelectByArea process is used.

In the schBindkey.il file, DrawThru1 is bound to schDirectEdit as shown:

<DrawThru1> schDirectEdit(1) 
Shift<DrawThru1> schDirectEdit(2) 
Ctrl<DrawThru1> schDirectEdit(3)

The following table shows what kind of edit takes place.

Object Type/Index	1	2	3
Instance (or Block)	Stretch	Copy	Move
Wire	Stretch	Copy	Move
Wire Vertex	Stretch	Add Wire	Move
Schematic Pin	Stretch	Add Wire	Move
Note Shape	Move	Copy	Move
Note Shape Edge	Stretch	Move	Move
Note Shape Vertex	Stretch	Move	Move
Symbol Pin	Move	Add Line	Move
Labels	Move	Copy	Move
Instance Pin	Add Wire	Add Wire	Add Wire
Instance Label	Move	Move	Move
Net Expression	Move	Copy	Move

Arguments

x_index

An integer that specifies which function to execute. Valid Values: 1, 2, 3

Value Returned

Always returns t.

Examples

If the cursor is not over an object, executes selectByArea. If the object under the cursor is an instance, executes stretch on the instance. If that instance belongs to the selected set, stretches all objects in the selected set.

schDirectEdit( 1 ) 

If the cursor is not over an object, executes an additive selectByArea. If the object under the cursor is an instance, executes copy on the instance. If that instance belongs to the selected set, copies all objects in the selected set.

schDirectEdit( 2 ) 

If the cursor is not over an object, executes deselectByArea. If the object under the cursor is an instance, executes move on the instance. If the instance belongs to the selected set, moves all objects in the selected set.

schDirectEdit( 3 ) 

Related Topics

Bindkeys and Access Keys

Return to top