Chapter Contents

Previous

Next
LABEL Function

LABEL Function



Places text in the graphics output. Associated variables can control the color, size, font, base angle, and rotation of the characters displayed.

Updates: XLSTT, YLSTT


Syntax
Associated Variables

Syntax

FUNCTION='LABEL';


Associated Variables

ANGLE=0...360
specifies the baseline angle of the character string with respect to the horizontal. The pivot point is at (X, Y), and the rotation is in a counterclockwise direction.

CBORDER='color' | 'CTEXT'
draws a colored border around the text. Color can be any SAS/GRAPH color name.

CBOX='color' | 'CBACK
draws a solid, colored box behind the text. Color can be any SAS/GRAPH color name.

COLOR='color'
specifies the color of the text. Color can be any SAS/GRAPH color name.

GROUP=group-value
MIDPOINT=midpoint-value
SUBGROUP=subgroup-value
specify coordinates for HBAR and VBAR charts from the GCHART procedure. Use these variables only with the data coordinate systems 1, 2, 7, and 8.

HSYS='coordinate-system'
specifies the coordinate system for the SIZE variable. See HSYS Variable for an explanation of coordinate-system.

POSITION='text-position' | '0'
controls the text string placement and alignment. Text-position can be one of the characters 1 through 9, A through F, <, +, or >. Invalid or missing values default to POSITION='5'. POSITION should always be a character variable of length 1. For details, see POSITION Variable.

ROTATE=rotation-angle
specifies the rotation angle of each character in the string. It is equivalent to the ROTATE= option in the FOOTNOTE, NOTE, and TITLE statements.

SIZE=height
specifies the height of the text string. The SIZE variable units are based on the value of the HSYS variable.

STYLE='font' | "'hardware-font-name'" | 'NONE'
specifies the font with which to draw the text that is specified by the TEXT variable. See STYLE Variable (Fonts) for a description of the various font specifications.

TEXT='text-string'
specifies the text to be written. Text-string can be up to 200 characters. Define the TEXT variable with sufficient length to contain all of the characters in your text string. If you need longer strings, use separate observations and POSITION='0' to continue the text.

WHEN='B' | 'A'
specifies when to draw the text strings in relation to other procedure output.

X=horizontal-coordinate
Y=vertical-coordinate
Z=depth-coordinate (PROC G3D only)
XC='character-type-horizontal-coordinate'
YC='character-type-vertical-coordinate'
specify the start point of the text string. The Z variable can be used only with the G3D procedure. Optionally, you can modify the placement of the text string with the POSITION variable.

XSYS='coordinate-system'
specifies the coordinate system for the X or XC variable. Use the XC variable only with XSYS='2'. See XSYS Variable for an explanation of coordinate-system.

YSYS='coordinate-system'
specifies the coordinate system for the Y or YC variable. Use the YC variable only with YSYS='2'. See YSYS Variable for an explanation of coordinate-system.

ZSYS='coordinate-system'
specifies the coordinate system for the Z variable. See ZSYS Variable for an explanation of coordinate-system.


Chapter Contents

Previous

Next

Top of Page

Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.