Product Documentation
Virtuoso Layout Suite SKILL Reference
Product Version IC23.1, November 2023

pteRegisterUserSelectionTrigger

pteRegisterUserSelectionTrigger(
t_funcName
)
=> t / nil

Description

Registers a trigger, which is a user-defined SKILL procedure, from CIW. This trigger is called with an argument list containing windowId, layerName, purposeName, mouseButton, and modifier for every selection action. Valid values for mouseButton are Left, Right, and Middle; valid values for modifier are None, Shift, and Ctrl.

Only one trigger can be registered at a time; it can be unregistered using pteUnRegisterUserSelectionTrigger.

The trigger works only in Single Selection mode. In Multi Selection mode, the trigger is ignored.

Arguments

t_funcName

Name of the trigger to be registered.

Value Returned

t

The trigger was successfully registered.

nil

The command was unsuccessful.

Example

pteRegisterUserSelectionTrigger("mytrigger")

The following is a sample implementation of mytrigger:

procedure(mytrigger(windowId layerName layerPurpose button modifier)
prog( ()
if(layerName == "Metal1" &&
 layerPurpose == "net" &&
 button == "Left" &&
 modifier == "None"
then
 pteSetSelectable("Metal1 drawing" nil "Layers")
else
if(layerName == "Metal1" &&
 layerPurpose == "net" &&
 button == "Left" &&
 modifier == "Shift"
then
 pteSetSelectable("Metal1 drawing" t "Layers")
else
if(layerName == "Metal1" &&
 layerPurpose == "net" &&
 button == "Middle" &&
 modifier == "None"
then
 pteSetSelectable("Metal1 slot" nil "Layers")
else
if(layerName == "Metal1" &&
 layerPurpose == "net" &&
 button == "Middle" &&
 modifier == "Shift"
then
 pteSetSelectable("Metal1 slot" t "Layers")
else
if(layerName == "Metal1" &&
 layerPurpose == "net" &&
 button == "Right" &&
 modifier == "None"
then
 pteSetSelectable("Metal1 pin" nil "Layers")
else
if(layerName == "Metal1" &&
 layerPurpose == "net" &&
 button == "Right" &&
 modifier == "Shift"
then
 pteSetSelectable("Metal1 pin" t "Layers")
)
)
)
)
)
)
); prog
); procedure

Return to top
 ⠀
X