dmAddCellToCategory

dmAddCellToCategory( 
g_categoryId 
l_cellList 
) 
=> t / nil

Description

Adds the specified cells to the category.

Supplied for compatibility. The equivalent functionality using the ddCat API would be

foreach( i cellList 
    ddCatAddItem( categoryId i~>name "cell ) 
)
ddCatSave( categoryId )

Using the ddCat API is more efficient because the categories are implemented using check-point files that must be locked against access by other users. Although the edits are written to disk (ddCatSave), the process still has a lock on the category until it is freed using ddCatClose.

After you call dmAddCellToCategory, use ddCatClose on g_categoryId.

The DFII-DM function accepted a list of cell IDs. For forward compatibility, the implementation of this function accepts a list of cell IDs or cell names.

Arguments

g_categoryId	ID of the category to which the specified cells are added.
l_cellList	List of cells to be added to the category.

Value Returned

`t`	The cells are added.
`nil`	The specified cells or the category ID cannot be found.

Return to top

Virtuoso Studio Design Environment SKILL ReferenceProduct Version IC23.1, November 2023