WHEN Variable

Specifies when the function is performed in relation to generating other graphics output for the procedure or in relation to generating other Annotate graphics.

Type:	character
Length:	1
Default:	B

Syntax

Details

The WHEN Variable and Annotate Data Set Processing

Functions

Syntax

WHEN='B' | 'A' ;

Variable Values

B | A

specifies whether to draw the annotation before (B) or after (A) the graph. These values are not case sensitive. A missing value is equivalent to specifying B.

Note:The frame of some plot types is drawn before annotations where WHEN="B". If you use the Annotate facility to draw a background and you want your graph frame to be visible, then you can use the BAR function to draw a frame. The following annotate statements draw a white graph frame:

xsys="3"; ysys="3"; when="b";
function="move"; x=0; y=0; output;
function="bar"; style="solid"; color="white"; x=100; y=100; output;

Details

The WHEN Variable and Annotate Data Set Processing

Normally, observations in an Annotate data set are processed sequentially. If you use the WHEN variable, all those observations with a WHEN value of B are processed first, the procedure output is then processed (if one is to be produced), and finally the observations with a WHEN value of A are processed.

Functions

You can use the WHEN variable with these functions:

BAR	MOVE	POLY
DRAW	PIE	POLYCONT
DRAW2TXT	PIECNTR	SYMBOL
FRAME	PIEXY
LABEL	POINT