Overview | Statement List | Example
DRAWV/['drawing name',][{PLOT|DVSTAT,variable,}]variable list[,IFERR,label:]
Returns the parameters of the specified drawing to a series of variables. Some of the variables in the list must be declared as arrays. The parameter returned depends upon its field position in the list. Therefore, if certain parameters are not desired, the field must be defined using two commas (,,). However, once you have specified the last desired parameter, do not use commas to define the remaining positions. For example, if you wished to only verify the name of each member view and the number of member views, you would specify
DRAWV/VNAM,,NUMVW,IFERR,label:
where VNAM is the member view name; ,, represents the omitted reference coordinates parameter, and NUMVW represents the number of member views.
You can verify plot or non-plot information, which is determined by the minor word PLOT. If verifying non-plot information (by omitting the minor word PLOT), you can also return the status of each view in addition to the regular list of data. This is done by specifying the minor word DVSTAT followed by a numerical array.
NOTE: You cannot specify both PLOT and DVSTAT in the same
statement.
If you do not specify the minor word PLOT, the following regular list of data is returned to a variable list:
Position |
Parameter |
Data Type |
1 |
Name of each member view |
String array |
2 |
Reference point (x,y) of each member view in drawing coordinates |
Num. array |
3 |
Number of member views |
Number |
4 |
Drawing units |
[1,2] |
5 |
Drawing height |
Number |
6 |
Drawing width |
Number |
If you specify the minor word PLOT, the following plot information is returned to a variable list:
Position |
Parameter |
Data Type |
1 |
Plotter name |
String Variable |
2 |
Scale |
Number |
3 |
Rotation angle |
Number |
4 |
Media reference number |
Number |
5 |
Number of copies |
Number |
6 |
X coordinate of plot origin (in drawing coordinates) |
Number |
7 |
Y coordinate of plot origin (in drawing coordinates) |
Number |
8 |
X offset value from the plotter origin |
Number |
9 |
Y offset value from the plotter origin |
Number |
10 |
Pen assignment |
[1,2] |
11-25 |
Pen list |
Number |
Parameter |
Description |
'drawing name' |
A string or string variable which represents the name of the drawing being accessed. If no name is specified, the current drawing is accessed. If no drawing name is specified and there is no current drawing, an error occurs. |
PLOT |
Minor word which indicates that the plotting parameters of the drawing are to be returned to the variable list. |
DVSTAT |
Minor word which indicates that the status (reference or active) of each view on the drawing is to be returned. |
variable |
A numerical array which receives the status of each view in the drawing when the minor word DVSTAT is specified. The view status is returned in the same order as the view names which can be extracted in this and other DRAWV statements. The values returned are: 0 for a Reference View 1 for an Active View |
variable list |
A list of variables to which either plot or non-plot parameters are assigned. Some of the variables in the list must be declared as arrays. Specifying the minor word PLOT returns plot information to this list. Omitting PLOT returns non-plot data. |
IFERR,label: |
Specifies a label to which program execution jumps if an error occurs while the drawing is being accessed. |