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

pteSetNoneValidity

pteSetNoneValidity(
[ ?mode { Display | Selection | Propagate } ]
[ ?only { t | nil } ]
[ ?panel { Layers | Objects | Grids } ]
[ ?window w_windowId ]
)
=> t / nil

Description

Sets as invalid the specified items in the specified Palette panel.

Arguments

?mode

Scope of execution of the command.

Valid values:

  • Display: All items displayed in the specified Palette panel are set as invalid. If the parent and child items in the Objects and Grids panels are in a desynchronized state, only the parent items are set as invalid.
  • Selection: Only the items selected in the specified Palette panel are set as invalid.
    The Selection option is applicable when multi-select mode is selected in Palette Options form or it is enabled using the environment variable, pteMultiSelectionMode. This lets you select multiple LPPs in the Layers panel using the CTRL + LMB or Shift + LMB after an initial LMB click on an LPP. The Selection mode in the active command applies to the selected LPPs Layers panel.
  • Propagate: Both parent and child items in the specified Palette panel are set as invalid. Use this mode only if the parent and child items in the Objects and Grids panels are in a desynchronized state.

?only

If set to t, only the items corresponding to the specified mode are set as invalid.

?panel

Name of the Palette panel.
Valid values: Layers, Objects, and Grids
Default: The panel that is currently active. If none of the panels is active, the command is run on the Layers panel.

?window w_windowId

ID of the window containing the Palette that you want to update.
Valid values: ID of any open window
Default: Current window

Value Returned

t

The specified items were set as invalid.

nil

The command was unsuccessful.

Examples

pteSetNoneValidity(?panel "Layers")
pteSetNoneValidity(?only t)
pteSetNoneValidity(?mode "Display")
pteSetNoneValidity(?window window(2))
pteSetNoneValidity(?mode "Display" ?only t ?panel "Layers" ?window window(2))

Return to top
 ⠀
X