Defines or modifies templates in the current template catalog.
Requirements: |
Assign a template catalog
before using the TDEF statement.
|
See also: |
TC statement
|
Featured in: |
Creating a Template
|
TDEFtemplate-entry
<panel-definition(s)>
<DES='entry-description'>;
|
panel-definition
has the following form:
|
panel-number / <panel-option(s)>
|
|
panel-option(s) can be one or
more of the
following:
|
|
- template-entry
- identifies an existing or a new template.
If the template is not in the template catalog, the procedure creates it.
If the template is already in the template catalog, the procedure modifies
or makes additions to that template.
Only template-entry is required, but if
you specify only the template name without any options, no changes are made
to an existing template and no new template is created.
-
CLIP
- specifies that any panels behind this panel
should be clipped. If clipping is in effect for a panel, only the graphics
output that is to be placed in that panel can appear in the space that the
panel occupies, unless a previous panel occupies all or part of that space.
-
COLOR=border-color
- specifies the color of the panel border.
If you omit border-color, then no border is displayed around
the panel when you replay graphics output in the panel. If you preview a
template that contains a panel without a border color, the GREPLAY procedure
uses the first color in the colors list as the outline for the border.
-
COPY=panel-number
- specifies the number of the panel definition
that is to be copied to this panel.
-
DEF
- specifies a default panel. A default panel
has the following characteristics:
Panel Corner |
Coordinates |
lower left |
(0,0) |
upper left |
(0,100) |
upper right |
(100,100) |
lower right |
(100,0) |
-
DELETE
DEL
- deletes the panel.
-
DES='entry-description'
- specifies the description of the catalog
entry for the template. The maximum length for entry-description
is 40 characters. By default, the procedure uses *** new template *** for
the description.
-
LLX=x
- specifies the X coordinate of the lower-left
corner of the panel. Units for x are percentage of the graphics
output area.
-
LLY=y
- specifies the Y coordinate of the lower-left
corner of the panel. Units for y are percentage of the graphics
output area.
-
LRX=x
- specifies the X coordinate of the lower-right
corner of the panel. Units for x are percentage of the graphics
output area.
-
LRY=y
- specifies the Y coordinate of the lower-right
corner of the panel. Units for y are percentage of the graphics
output area.
-
panel-number
- identifies the number of the panel that
is being defined or modified.
-
ROTATE=degrees
- specifies the rotation angle for the panel.
The coordinates of the panel corners are automatically adjusted.
-
SCALEX=factor
- specifies the scale factor for the X coordinates
in the panel. You can use this scale factor to increase or decrease the size
of the panel in the X direction or to reverse the X coordinates for the panel.
-
SCALEY=factor
- specifies the scale factor for Y coordinates
in the panel. You can use this scale factor to increase or decrease the size
of the panel in the Y direction or to reverse the Y coordinates for the panel.
-
ULX=x
- specifies the X coordinate of the upper-left
corner of the panel. Units for x are percentage of the graphics
output area.
-
ULY=y
- specifies the Y coordinate of the upper-left
corner of the panel. Units for y are percentage of the graphics
output area.
-
URX=x
- specifies the X coordinate of the upper-right
corner of the panel. Units for x are percentage of the graphics
output area.
-
URY=y
- specifies the Y coordinate of the upper-right
corner of the panel. Units for y are percentage of the graphics
output area.
-
XLATEX=distance
- specifies the distance to move the X coordinates
of the panel. Units for distance are percentage of the graphics
output area.
-
XLATEY=distance
- specifies the distance to move the Y coordinates
of the panel. Units for distance are percentage of the graphics
output area.
Use coordinate values that are
less than
0 and greater than 100 in the LLX=, LLY=, LRX=, LRY=, ULX=, ULY=, URX=, and
URY= options to zoom in on the graphics output. That is, you can see only
that part of the replayed graphics output in the range from 0 to 100 percent
of the graphics output area.
The values that you supply for the SCALEX= and SCALEY=
options are used to change the size and orientation of the panel. The scale
factors are used for the corresponding X and Y coordinates of the panel. For
example, if you specify
scalex=.5
scaley=2
the X coordinates are scaled to half the original size,
and the Y coordinates are scaled to twice the original size.
If you supply a scale factor of 0, all of the coordinates
are set to the same value. If you use a scale factor of 1, nothing happens.
If you use a scale factor greater than 1, the values of the coordinates are
increased and hence the size of the panel increases. If you use a scale factor
less than 1 but greater than 0, the values of the coordinates are decreased
and hence the size of the panel decreases. If you use a negative scale factor,
the coordinates are reversed and hence the panel (and any graphics output
replayed in the panel) is reversed.
Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.