PM_REBUILD_DRAWING

Syntax

int_val = PM_REBUILD_DRAWING_VIEW ( drawing_name, script_file_path );

Input arguments

string	drawing_name	The name of the drawing.
string	script_file_path	The path to the script file.

Return Values

Success:

The name of view that was rebuilt.

Failure:

int	-1	Script interface error.
int	0	View creation failed.
int	MMT_E_DRW_ACTIVE	Some drawing is already active.
int	MMT_E_DRW_NOTFOUND	Drawing with the given name does not exist.
int	MMT_E_DRW_READONLY	If drawing is not being edited on user's desk.

Description

This function rebuilds a view into a given drawing by executing a rebuild script that has been previously created for the view.

See PM_OUTPUT_VIEW_REBUILD_SCRIPT in the view management chapter to find out how to generate rebuild scripts for views.

This call does not leave the drawing or view open. If any objects are missing from the plant model of the current design area, then this function emits a warning message to the message pane but does not reject the rebuild.

Notice that no drawing may be active when this function is called.