leYankFigs

leYankFigs(
d_cellViewId 
l_ptArray 
x_nLevels
[ l_refPt ] 
[ x_nSides ]
) 
=> t / nil

Description

Copies specified objects into a yank buffer for later pasting. Copies objects in cellview d_cellViewId that fall within the shape defined by the points in l_ptArray and that are in the levels of hierarchy specified by x_nLevels. Optionally uses l_refPt as the reference point for the yank and x_nSides as the number of polygon sides to use when converting objects intersected by the yank shape.

For more information about placing the contents of the yank buffer into a cellview, see lePasteFigs.

Arguments

d_cellViewId	Database ID for the cellview containing the objects to yank.
l_ptArray	List of the coordinates defining the yank shape.
x_nLevels	Specifies the number of hierarchy levels to traverse.
l_refPt	A reference point used for later placing the yanked objects with lePasteFigs. Default Value: Coordinates of the lower left point of the bounding box for the yank shape Valid Values: coordinates of any point
x_nSides	Specifies the number of sides to use when converting objects to polygons. Default Value: 20 Valid Values: any positive integer

Value Returned

t	The objects are copied.
nil	The objects are not copied.

Examples

Copies all objects and partial objects in the current cellview that fall in the square region 0:0 to 10:10 into a buffer for future pasting. Objects and partial objects are copied down to two levels.

leYankFigs( geGetEditCellView() list( 0:0 10:0 10:10 0:10 ) 2 ) 

Interactive Function

Enter this function with the window ID argument only; the system prompts you to enter the coordinates of the yank shape. If you do not specify w_windowId, the current window is used.

leHiYank( [ w_windowId ] ) => t / nil

Return to top