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

gpeSelect

gpeSelect(
g_tableView
[g_selectionList | g_type g_value]
)
=> t / nil

Description

Select cells in the Grid Pattern Editor or Grid Pattern Mapping assistants.

Arguments

g_tableView

The tableView in which all cell items need to be selected.

g_selectionList | g_type g_value

g_selectionList is a list or range of cells to be selected, or a list of type and values to search for. If no types are specified, then the display value is searched. Set the value to t to select all rows, or nil to clear the selection.

g_type is a symbol indicating the type of value to search for.

g_value is the value to search for.

Value Returned

t

The cells were selected.

nil

The cells could not be selected.

Examples

Assuming a 4x4 grid with A, B, C, D symbols in the columns, and rows alternating between R0 and MY orientation. 

tv = dwindow('gpeGridAsst_1)->tableView
gpeSelect(tv t) ; select all by row
gpeGetSelection(tv)
--> (((3 0) (3 3)) ((2 0) (2 3)) ((1 0) (1 3)) ((0 0) (0 3)))
gpeSelect(tv nil) ; select none
gpeGetSelection(tv)
--> nil
gpeSelect(tv list(list(0:0 3:0))) ; select left-most column
gpeGetSelection(tv)
--> (((0 0) (3 0)))
gpeSelect(tv '("B")) ; select all the B cells
gpeGetSelection(tv)
--> ((0 1) (1 1) (2 1) (3 1))
gpeSelect(tv '(orient "MY" symbol "C")) ; select all the C cells with MY orientation
gpeGetSelection(tv)
--> ((1 2) (3 2))

Return to top
 ⠀
X