Layer Visibility In a View

Synopsis

&LYRVVW('view name',layer number[,IFERR,label:])

Description

Allows you to verify/change layer visibility in a view.

If the specified view does not have an individual layer visibility mask:

READ -the visibility status of the layer in the global mask is returned

WRITE -an individual visibility mask is defined for the view, which is the same as the global mask, except for the layer specified.

If the view is active, the current layer visibility mask is verified or edited. Note that this may be different than the saved version of this mask. To save the changes, you must save the view.

NOTE: A range of layers is not supported. This command only accepts a single numeric entry and a Do loop should be constructed to set the layer visibility for a range of layers.

Characteristics

Read/Write - Number - [1,2]

Constant Values

1 = &YES (layer is visible)
2 = &NO (layer is not visible)

Parameters

Parameter

Description

'view name'

A string or string variable which represents the name of the view in which the specified layer's visibility is to be changed. Note that the view name that corresponds to a drawing is the drawing name with an "@0" appended to it.

layer number

The layer number of which you wish to change the layer visibility in a specified view.

IFERR,label:

Specifies a label to which program execution jumps if an error occurs. Possible errors include: invalid view name; view does not exist; invalid layer number; value not within valid limits.

&YES

GPA constant indicating that the specified layer is to be made visible.

&NO

GPA constant indicating that the specified layer is to be made not visible.

Parameter	Description
'view name'	A string or string variable which represents the name of the view in which the specified layer's visibility is to be changed. Note that the view name that corresponds to a drawing is the drawing name with an "@0" appended to it.
layer number	The layer number of which you wish to change the layer visibility in a specified view.
IFERR,label:	Specifies a label to which program execution jumps if an error occurs. Possible errors include: invalid view name; view does not exist; invalid layer number; value not within valid limits.
&YES	GPA constant indicating that the specified layer is to be made visible.
&NO	GPA constant indicating that the specified layer is to be made not visible.