SAS 9.1 Output Delivery System Users Guide

PROC TEMPLATE ;

PROC TEMPLATE Statement

PROC TEMPLATE ;

DEFINE STYLE style- path </ STORE= libref . template-store >;

• statements-and-attributes

• END ;

DEFINE STYLE Statement

Creates a style definition for any destination that supports the STYLE= option

Requirement: An END statement must be the last statement in the definition.

Featured in: Example 1 on page 342

DEFINE STYLE style-path </ STORE= libref . template-store >;

• <PARENT= style-path ;>

• NOTES ' text ';

• REPLACE new-style-element- name <FROM existing-style-element-name ><' text '>

  • < /style-attribute-specification(s) >;

• STYLE new-style-element-name <FROM existing-style-element-name ><' text '>

  • < /style-attribute-specification(s) >;

• END;

Required Arguments

style-path

• specifies where to store the style definition. A style-path consists of one or more names , separated by periods. Each name represents a directory in a template store . PROC TEMPLATE writes the definition to the first template store that you can write to in the current path.

Options

STORE= libref . template-store

• specifies the template store in which to store the definition. If the template store does not exist, then it is created.

• Restriction: The syntax of the STORE= option does not become part of the compiled definition.

Style Definition Attributes

PARENT= style-path

• specifies the style definition for which the current definition is inherited from. A style-path consists of one or more names, separated by periods. Each name represents a directory in a template store. The current style definition inherits from the specified style definition in the first template store that you can read from in the current path.

  When you specify a parent, all the style elements, style attributes, and statements that are specified in the parent's definition are used in the current definition unless the current definition overrides them.

  SAS provides some style definitions. You can specify one of these style definitions for style-path , or you can specify a user -defined style definition. Some of the style definitions that are currently shipped with SAS include:

  • styles.default

  • styles.beige

  • styles.brick

  • styles.brown

  • styles.d3d

  • styles.minimal

  • styles.printer

  • styles.statdoc.

• For information about finding an up-to-date list of the style definitions and for viewing a style definition, see 'Viewing the Contents of a Style Definition' on page 319.

NOTES Statement

Provides information about the style definition

Tip: The NOTES statement becomes part of the compiled style definition, which you can view with the SOURCE statement, whereas SAS comments do not.

NOTES ' text ';

Required Arguments

text

• provides information about the style definition.

REPLACE Statement

Adds a style element to the child style definition from the parent style definition

Restriction: To use the REPLACE statement, you must specify a parent style definition with the PARENT= attribute in the DEFINE STYLE statement.

See also: 'About Style Definition Inheritance and Style Element Inheritance' on page 322

Featured in: Example 3 on page 355

Tip: You can think of the REPLACE statement as replacing the statement that defines the like-named style element in the parent style definition. The REPLACE statement does not actually change the parent style definition, but PROC TEMPLATE builds the child style definition as if it had changed the parent. All style elements that inherit attributes from this style element inherit the attributes that are specified in the REPLACE statement, not those used in the parent style definition.

REPLACE style-element-name-1 <FROM style-element-name-2 ><' text '>

• </ style-attribute-specification(s) >;

Required Arguments

style-element-name-1

• names the style element to replace. A like-named style element must exist in the parent style definition. PROC TEMPLATE stores style-element-name-1 in the current style definition and replaces all its attributes with the attributes that you specify in the REPLACE statement. If an attribute is defined in the like-named style element in the parent style definition and you do not explicitly specify it in the REPLACE statement, then the value of the attribute defaults to the value that was inherited from the parent of the like-named style element.

Options

style-element-name-2

• names the style element that style-element-name-1 inherits from. The style element must exist in the current style definition or in the parent of the current style definition. PROC TEMPLATE looks first in the current style definition for the style element. If PROC TEMPLATE does not find the style element, then it looks in the parent style definition.

style-attribute-specification(s)

• specifies the style attributes for style-element-name-1 . The new style element inherits from the parent style element all the attributes that the parent inherits. However, all the attributes that are explicitly specified in the definition of style-element-name-2 must be respecified in the REPLACE statement if you want to keep them. You can override any attribute of the parent style element, whether it is inherited or explicitly defined, by specifying it in the REPLACE statement. Each style-attribute-specification has the following general form:

  • style-attribute-name = style-attribute-value

• style-attribute-name

  • can be the name of an attribute that is listed in 'Style Attributes and Their Values' on page 292, or it can be the name of a user-defined attribute.

  • Restriction: If style-attribute-name refers to a user-defined attribute, then you must enclose the name in quotation marks. If style-attribute-name refers to an attribute that is listed in 'Style Attributes and Their Values' on page 292, then you do not enclose the name in quotation marks. For more information about user-defined attributes, see 'Style Attributes and Their Values' on page 292.

• style-attribute-value

  • assigns the value to the attribute. For information about style-attribute values, see 'Style Attributes and Their Values' on page 292.

' text '

• provides information about the REPLACE statement. Text of this type becomes part of the compiled definition, which you can view with the SOURCE statement, whereas SAS comments do not.

STYLE Statement

Creates a new style element

Featured in: Example 1 on page 342

STYLE new-style-element-name <FROM existing-style-element-name ><' text '>

• </ style-attribute-specification(s) >;

Required Arguments

new-style-element-name

• names the style element to create. PROC TEMPLATE stores the style element in the current style definition.

Options

existing-style-element-name

• names an existing style element to inherit from. The style element must exist in the current style definition or in the parent of the current style definition.

style-attribute-specification(s)

• specify new style attributes or modifications to existing style attributes for the new style element. The new style element inherits all of the style attributes of existing-style-element-name . You can override any of these attributes by specifying attributes in the STYLE statement. Each style-attribute-specification has the following general form:

  • style-attribute-name = style-attribute-value

• style-attribute-name

  • can be the name of an attribute that is listed in 'Style Attributes and Their Values' on page 292, or it can be the name of a user-defined style attribute.

  • Restriction: If style-attribute-name refers to a user-defined attribute, then you must enclose the name in quotation marks. If style-attribute-name refers to an attribute that is listed in 'Style Attributes and Their Values' on page 292, then do not enclose the name in quotation marks.

• style-attribute-value

  • assigns the value to the attribute. If you use an attribute from the list in 'Style Attributes and Their Values' on page 292, then you must use the kind of value that the attribute expects.

    For more information about style-attribute values, see 'Style Attributes and Their Values' on page 292.

' text '

• provides information about the REPLACE statement. Text of this type becomes part of the compiled definition, which you can view with the SOURCE statement, whereas SAS comments do not.

Style Attributes and Their Values

The default value that is used for an attribute depends on the style definition that is in use. For information about viewing the attributes in a style definition, see 'Viewing the Contents of a Style Definition' on page 319. The implementation of an attribute depends on the ODS destination that formats the output. In addition, if you are creating HTML output, then the implementation of an attribute depends on the browser that you use.

Data Values

• Values for style attributes are one of the following:

• color

  • is a string that identifies a color. A color can be

    • any of the color names that are supported by SAS/GRAPH. These names include

      • a predefined SAS color (for example, blue or VIYG)

      • a red/green/blue (RGB) value (for example, CX0023FF)

      • a hue/light/saturation (HLS) value (for example, H14E162D)

      • a gray-scale value (for example, GRAYBB).

    • an RGB value with a leading pound sign (#) rather than CX (for example, #0023FF).

    • one of the colors that exists in the SAS session when the style definition is used:

      • • DMSBLUE

        • DMSRED

        • DMSPINK

        • DMSGREEN

        • DMSCYAN

        • DMSYELLOW

        • DMSWHITE

        • DMSBLACK

        • DMSMAGENTA

        • DMSORANGE

        • DMSGRAY

        • DMSBROWN

        • SYSBACK

        • SYSSECB

        • SYSFORE.

    • Note: Use these colors only if you are running SAS in the windowing environment.

    • an English description of an HLS. Such descriptions use a combination of words to describe the lightness, the saturation, and the hue (in that order). You can use the Color Naming System to form a color by

      • • combining a chromatic hue with a lightness, a saturation, or both

        • combining the achromatic hue gray with a lightness

        • combining the achromatic hue black or white without qualifiers.

    • The words that you can use are shown in the following table:

      Lightness	Saturation	Chromatic Hue	Achromatic Hue
      		blue	black [*]
      very dark	grayish	purple
      dark	moderate	red
      medium	strong	orange brown	gray [**]
      light	vivid	yellow
      very light		green
      			white [*]
      [*] Black and white cannot be combined with a lightness or a saturation value. [**] Gray cannot be combined with a saturation value.

    • You can combine these words to form a wide variety of colors. Some examples are

      • light vivid green

      • dark vivid orange

      • light yellow.

    • Note: The Output Delivery System first tries to match a color with a SAS/ GRAPH color. Thus, although brown and orange are interchangeable in the table, if you use them as unmodified hues, then they are different. The reason for this is that ODS interprets them as SAS colors, which are mapped to different colors.

      You can also specify hues that are intermediate between two neighboring colors. To do so, combine one of the following adjectives with one of its neighboring colors:

      • reddish

      • orangish

      • brownish

      • yellowish

      • greenish

      • bluish

      • purplish.

      For example, you can use the following as hues:

      • bluish purple

      • reddish orange

      • yellowish green.

  • See also: SAS/GRAPH Reference, Volumes 1 and 2 for information about SAS/ GRAPH colors.

• dimension

  • is a nonnegative number, optionally followed by one of the following units of measure:

    cm	centimeters
    em	standard typesetting measurement unit for width
    ex	standard typesetting measurement unit for height
    in	inches
    mm	millimeters
    pt	a printer's point

  • Default: For the Printer destination, units of 1/150 of an inch

• font-definition

  • is the name of a font, the font size , and font keywords. A font definition has the following general format:

    • (' font-face-1 < , font-face-n >', font-size , keyword-list )

  • If you specify only one font and if its name does not include a space character, then you can omit the quotation marks. If you specify more than one font , then the destination device uses the first one that is installed on your system.

    font-size specifies the size of the font. font-size can be a dimension or a number without units of measure. If you specify a dimension, then you must specify a unit of measure. Without a unit of measure the number becomes a size that is relative to all other font sizes in the document. For more information see dimensions on page 294.

    keyword-list specifies the font weight, font style, and font width. You can include one value for each, in any order. The following table shows the keywords that you can use:

    Keywords for Font Weight	Keywords for Font Style	Keywords for Font Width
    MEDIUM	ITALIC	NORMAL [*]
    BOLD	ROMAN	COMPRESSED [*]
    DEMI_BOLD [*]	SLANT	EXTRA_COMPRESSED [*]
    EXTRA_BOLD [*]		NARROW [*]
    LIGHT		WIDE [*]
    DEMI_LIGHT [*]		EXPANDED [*]
    EXTRA_LIGHT [*]
    [*] Few fonts honor these values.

  • Featured in: Example 2 on page 348

• format

  • is a SAS format or a user-defined format.

• reference

  • is a reference to an attribute that is defined in the current style definition or in the parent style definition (or beyond). The value that you use is the name of the style element followed by the name of an attribute, in parentheses, within that element. For example, suppose that you create a style element called DATACELL that uses the FOREGROUND= and BACKGROUND= style elements this way:

    style datacell / background=blue foreground=white;

    Later, you can ensure that another style element, NEWCELL, uses the same background color by defining it this way:

    style newcell / background=datacell(background);

    Similarly, suppose that you create a style element called HIGHLIGHTING that defines three attributes this way:

    style highlighting / "go"=green "caution"=yellow "stop"=red;

  • Later, you can define a style element called MESSAGES that uses the colors that are defined in HIGHLIGHTING:

    style messages; "note"=highlighting("go") "warning"=highlighting("caution") "error"=highlighting("stop");

  • In this way, multiple style elements could use the colors that you define in HIGHLIGHTING. If you decide to change the value of go to blue, you simply change its value in the definition of HIGHLIGHTING, and every style element that references highlighting ('go') will use blue instead of green.

    Note: In the first example, the style attribute BACKGROUND= is a predefined style attribute. Therefore, when you reference it, you do not put it in quotation marks. However, in the second example, go is a user-defined attribute. You define it with quotation marks, and when you reference it, you must use quotation marks.

    You can use a special form of reference to get a value for a style attribute from the macro table at the time that the style element is used. For example, the following STYLE statement uses the current value of the macro variable bkgr for the background color of the style element cell :

    style cell / background=symget("bkgr");

  • Featured in: Example 2 on page 348

  ' string '

  • is a quoted character string.

Style Attributes

Note: You can use the value _UNDEF_ for any style attribute. ODS treats an attribute that is set to _UNDEF_ as if its value had never been set, even in the parent or beyond.

ABSTRACT= ON OFF

• determines whether or not styles are used in CSS or LaTex style files.

• ON

  • specifies that styles are used in CSS or LaTex style files.

• OFF

  • specifies that styles are not used in CSS or LaTex style files.

• Applies to: document

• ODS Destination: HTML, MARKUP, and LaTex

ACTIVELINKCOLOR= color

• specifies the color that a link changes to after you click on it, but before the browser opens that file.

• Applies to: document

• ODS Destination: HTML

• See: color on page 292

ASIS=ONOFF

• specifies how to handle leading spaces and line breaks.

• ON

  • prints text with leading spaces and line breaks, in the same manner as the listing output.

• OFF

  • trims leading spaces and ignores line breaks.

• Default: OFF

• Applies to: document

• ODS Destinations: HTML, RTF, PS, PCL, and PDF

BACKGROUND= color

• specifies the color of the background.

• Tip: Generally, the background color of the cell overrides the background color of the table. You see the background color for the table only as the space between cells (see CELLSPACING= on page 305).

• Applies to: tables or cells and graphs

• ODS Destinations: HTML, PCL, PDF, PS, and RTF

• Overridden by: CBACK= option in the SAS/GRAPH GOPTIONS statement

• Featured in: Example 1 on page 342 and Example 3 on page 355

• See: color on page 292

BACKGROUNDIMAGE=' string '

• specifies an image to use as the background. Viewers can tile or stretch the image as the background for the HTML table or graph that the procedure creates. For graphs, the specified image is stretched. string is the name of a GIF or JPEG file. You can use a simple file name, a complete path, or a URL. However, the most versatile approach is to use a simple filename and to place all image files in the local directory.

• Applies to: tables or cells and graphs

• ODS Destinations: HTML, PCL, and PS

• Overridden by: IBACK= and IMAGESTYLE=FIT options in the SAS/GRAPH GOPTIONS statement

• See: string on page 296

BODYSCROLLBAR=YES NO AUTO

• specifies whether or not to put a scrollbar in the frame that references the body file.

• YES

  • places a scrollbar in the frame that references the body file.

• NO

  • specifies not to put a scrollbar in the frame that references the body file.

• AUTO

  • places a scrollbar in the frame that references the body file only if needed.

• Tip: Typically, BODYSCROLLBAR is set to AUTO.

• Applies to: frame

• ODS Destinations: HTML

BODYSIZE= dimension number %*

• specifies the width of the frame that displays the body file in the HTML frame file. (For information about the HTML files that ODS creates, see 'HTML Links and References Produced by the HTML Destination' on page 637.)

• dimension

  • is a nonnegative number. The unit of measure is pixels.

  • See: dimension on page 294

• number %

  • specifies the width of the frame as a percentage of the entire display.

• *

  • specifies to use whatever space is left after displaying the content and page files as specified by the CONTENTSIZE= attribute.

• Applies to: frame

• ODS Destinations: HTML

BORDERCOLOR= color

• specifies the color of the border if the border is just one color.

• Applies to: tables or cells

• ODS Destinations: HTML, RTF, PRINTER family

• See: color on page 292

BORDERCOLORDARK= color

• specifies the darker color to use in a border that uses two colors to create a three-dimensional effect.

• Interaction: If you create HTML4 output, then the BORDERCOLORDARK style attribute is ignored because it is not part of the HTML4 standard. If you want a color border, then use the BORDERCOLOR= style attribute.

• Applies to: tables or cells

• ODS Destinations: HTML, RTF, PRINTER family

• Featured in: Example 4 on page 361

• See also: color on page 292

BORDERCOLORLIGHT= color

• specifies the lighter color to use in a border that uses two colors to create a three-dimensional effect.

• Interaction: If you create HTML4 output, then the BORDERCOLORLIGHT style attribute is ignored because it is not part of the HTML4 standard. If you want a color border, then use the BORDERCOLOR= style attribute.

• Applies to: tables or cells

• ODS Destinations: HTML, RTF, PRINTER family

• Featured in: Example 4 on page 361

• See: color on page 292

BORDERWIDTH= dimension

• specifies the width of the border of the table.

• Applies to: tables

• ODS Destinations: HTML, RTF, PRINTER family

• Tip: Typically, when BORDERWIDTH=0, the ODS destination sets RULES=NONE (see the discussion about RULES= on page 317) and FRAME=VOID (see the discussion about FRAME= on page 310).

• Featured in: Example 1 on page 342 and Example 3 on page 355

• See: dimension on page 294

BOTTOMMARGIN= dimension

• specifies the bottom margin for the document.

• Applies to: document

• ODS Destinations: HTML, RTF, PRINTER family

• See: dimension on page 294

BULLETS=' string '

• specifies the string to use for bullets in the contents file. ODS uses bullets in the contents file. string can be one of the following:

  • circle

  • decimal

  • disc

  • lower-alpha

  • lower-roman

  • none

  • square

  • upper-alpha

  • upper-roman.

• Applies to: contents

• ODS Destinations: HTML

• See: string on page 296

CELLHEIGHT= dimension integer %

• specifies the height of the cell. If you specify a percent, it represents a percentage of the height of the table. A row of cells will have the height of the highest cell in the row.

• dimension

  • is a nonnegative number, optionally followed by one of the following units of measure.

  • See: dimension on page 294

• integer %

  • specifies the height of the cell as a percentage of the height of the table.

• Alias: OUTPUTHEIGHT=

• Tip: HTML automatically sets cell height appropriately. You should seldom need to specify this attribute in the HTML destination.

• Applies to: cells

• ODS Destinations: HTML, RTF, PDF, PCL, and PS

CELLPADDING= dimension integer %

• specifies the amount of white space on each of the four sides of the text in a cell.

• dimension

  • is a nonnegative number, optionally followed by one of the following units of measure.

  • See: dimension on page 294

• integer %

  • specifies the amount of white space on each of the four sides of the text in a cell as a percentage of the table.

• Applies to: tables

• ODS Destinations: HTML, RTF, PRINTER family

• Featured in: Example 3 on page 355

CELLSPACING= dimension

• specifies the thickness of the spacing between cells.

• Applies to: tables

• Interaction: If BORDERWIDTH= is nonzero, and if the background color of the cells contrasts with the background color of the table, then the color of the cell spacing is determined by the table's background.

• Featured in: Example 1 on page 342 and Example 3 on page 355

• See: dimension on page 294

CELLWIDTH= dimension integer %

• specifies the width of the cell. If you specify a percent, it represents a percentage of the width of the table. A column of cells will have the width of the widest cell in the column.

• dimension

  • is a nonnegative number, optionally followed by one of the following units of measure.

  • See: dimension on page 294

• integer %

  • specifies the width of the cell as a percentage of the width of the table.

• Alias: OUTPUTWIDTH=

• Applies to: cells

• ODS Destinations: HTML, RTF, PRINTER family

CONTENTPOSITION= LEFT RIGHT TOP BOTTOM

• specifies the position, within the frame file, of the frames that display the contents and the page files. (For information about the HTML files that ODS creates, see 'HTML Links and References Produced by the HTML Destination' on page 637.)

• LEFT

  • places the frames on the left.

  • Alias: L

• RIGHT

  • places the frames on the right.

  • Alias: R

• TOP

  • places the frames at the top.

  • Alias: T

• BOTTOM

  • places the frames at the bottom.

  • Alias: B

• Applies to: frame

• ODS Destinations: HTML

CONTENTSCROLLBAR=YES NO AUTO

• specifies whether or not to put a scrollbar in the frames in the frame file that display the contents and the page files. (For information about the HTML files that ODS creates, see 'HTML Links and References Produced by the HTML Destination' on page 637.)

• YES

  • places a scrollbar in the frames in the frame file that display the contents and the page files.

• NO

  • specifies not to put a scrollbar in the frames in the frame file that display the contents and the page files.

• AUTO

• Tip: Typically, CONTENTSCROLLBAR= is set to AUTO.

• Applies to: frame

• ODS Destinations: HTML

CONTENTSIZE= dimension number %*

• specifies the width of the frames in the frame file that display the contents and the page files. (For information about the HTML files that ODS creates, see 'HTML Links and References Produced by the HTML Destination' on page 637

• dimension

  • is a nonnegative number. The unit of measure is pixels.

  • See: dimension on page 294

• number %

  • specifies the width of the frames as a percentage of the entire display.

  • Requirement: number % must be a positive number between 0 and 100.

• *

  • specifies to use whatever space is left after displaying the body file as specified by the BODYSIZE= attribute.

• See also: BODYSIZE= on page 303

• Applies to: frame

• ODS Destinations: HTML

CONTRASTCOLOR= color

• specifies the alternate colors for maps. The alternate colors are applied to the blocks on region areas in block maps.

• Applies to: graphs

• ODS Destinations: HTML

• See: color on page 292

DROPSHADOW= ON OFF

• determines whether drop shadow effect is used with text.

• ON

  • specifies that a drop shadow effect is used with text.

• OFF

  • specifies that a drop shadow effect is not used with text.

• Applies to: graphs

• ODS Destinations: HTML

ENDCOLOR= color

• indicates the end fill color for a graph. It is used to create a gradient effect.

  Note: You can have either a start and end gradient effect or no gradient effect. If you specify a TRANSPARENCY level and you only specify the ENDCOLOR, then the start color will be completely transparent gradationally to the end color.

• Applies to: graphs

• ODS Destinations: HTML

• See: color on page 292

FILLRULEWIDTH= dimension

• causes a rule of the specified width to be placed into the space around the text (or entire cell if there is no text) where white space would otherwise appear.

• Tip: If no text is specified, then FILLRULEWIDTH= fills the space around the text with dash marks. For example: -this- or this --.

• Applies to: tables

• ODS Destinations: PDF, PS, and PCL

• See: dimension on page 294

FLYOVER=' string '

• specifies the text to show in a tool tip for the cell.

• Applies to: cells

• ODS Destinations: HTML and PDF

• See: string on page 296

FONT= font-definition

• specifies a font definition to use.

• Tip: When you specify this attribute for a table, it affects only the text that is specified with the PRETEXT=, POSTTEXT=, PREHTML=, and POSTHTML= attributes. To alter the font for the text that appears in the table, you must set the attribute for a cell.

• Tip: If the system does not recognize the font specified, then it will refer to your system's default font. This attribute does not accept concatenated fonts. SAS Graph Styles can only specify one font.

• Applies to: tables, cells, and graphs

• ODS Destinations: HTML, RTF, PRINTER family

• Featured in: Example 3 on page 355

• See: font definition on page 294

FONT_FACE=' string-1 < , string-n >'

• specifies the font to use. If you supply multiple fonts, then the destination device uses the first one that is installed on your system.

  You cannot be sure what fonts are available to someone who is viewing your output in a browser or printing it on a high-resolution printer. Most devices support

  • times

  • courier

  • arial, helvetica.

• Tip: When you specify this attribute for a table, it affects only the text that is specified with the PRETEXT=, POSTTEXT=, PREHTML=, and POSTHTML= attributes. To alter the font for the text that appears in the table, you must set the attribute for a cell.

• Applies to: cells and graphs

• ODS Destinations: HTML, RTF, PRINTER family

• Featured in: Example 1 on page 342

• See: string on page 296

FONT_SIZE= dimension size

• specifies the size of the font.

• dimension

  • is a nonnegative number.

  • See: dimension on page 294

  • Restriction: If you specify a dimension, then you must specify a unit of measure. Without a unit of measure, the number becomes a relative size.

• size

  • The value of size is relative to all other font sizes in the document.

  • Range: 1 to 7, for size

• Tip: When you specify this attribute for a table, it affects only the text that is specified with the PRETEXT=, POSTTEXT=, PREHTML=, and POSTHTML= attributes. To alter the font for the text that appears in the table, you must set the attribute for a cell.

• Applies to: table, cells, and graphs

• ODS Destinations: HTML, RTF, PDF, PCL, and PS

• Featured in: Example 1 on page 342

FONT_STYLE=ITALIC ROMAN SLANT

• specifies the style of the font. In many cases, italic and slant map to the same font.

• Tip: When you specify this attribute for a table, it affects only the text that is specified with the PRETEXT=, POSTTEXT=, PREHTML=, and POSTHTML= attributes. To alter the font for the text that appears in the table, you must set the attribute for a cell.

• Applies to: tables, cells, and graphs

• ODS Destinations: HTML, PCL, PDF, PS, and RTF

• Featured in: Example 1 on page 342 and Example 3 on page 355

FONT_WEIGHT= weight

• specifies the font weight. weight can be any of the following:

  • MEDIUM

  • BOLD

  • DEMI_BOLD

  • EXTRA_BOLD

  • LIGHT

  • DEMI_LIGHT

  • EXTRA_LIGHT.

• Restriction: You cannot be sure what font weights are available to someone who is viewing your output in a browser or printing it on a high-resolution printer. Most devices support only MEDIUM and BOLD, and possibly LIGHT.

• Tip: When you specify this attribute for a table, it affects only the text that is specified with the PRETEXT=, POSTTEXT=, PREHTML=, and POSTHTML= attributes. To alter the font for the text that appears in the table, you must set the attribute for a cell.

• Applies to: tables, cells, and graphs

• ODS Destinations: HTML, PCL, PDF, PS, and RTF

• Featured in: Example 1 on page 342

FONT_WIDTH= relative-width

• specifies the font width compared to the width of the usual design. relative-width can be any of the following:

  • NORMAL

  • COMPRESSED

  • EXTRA_COMPRESSED

  • NARROW

  • WIDE

  • EXPANDED.

• Restriction: Few fonts honor these values.

• Tip: When you specify this attribute for a table, it affects only the text that is specified with the PRETEXT=, POSTTEXT=, PREHTML=, and POSTHTML= attributes. To alter the font for the text that appears in the table, you must set the attribute for a cell.

• Applies to: tables, cells, and graphs

• ODS Destinations: HTML, RTF, PCL, PDF, PS, and RTF

• Featured in: Example 1 on page 342

FOREGROUND= color

• specifies the color of the foreground, which is primarily the color of text.

• Tip: When you specify this attribute for a table, it affects only the text that is specified with the PRETEXT=, POSTTEXT=, PREHTML=, and POSTHTML= attributes. To alter the font for the text that appears in the table, you must set the attribute for a cell.

• Applies to: tables, cells, and graphs

• ODS Destinations: HTML, PCL, PDF, PS, and RTF

• Overridden by: CBACK= option in the SAS/GRAPH GOPTIONS statement

• Featured in: Example 3 on page 355

• See: color on page 292

FRAME= frame-type

• specifies the type of frame to use on a table. The following table shows the possible values for frame-type and their meanings:

  Value for frame-type	Frame type
  ABOVE	a border at the top
  BELOW	a border at the bottom
  BOX	borders at the top, bottom, and both sides
  HSIDES	borders at the top and bottom
  LHS	a border at the left side
  RHS	a border at the right side
  VOID	no borders
  VSIDES	borders at the left and right sides

• Applies to: tables

• ODS Destinations: HTML, PRINTER family, and RTF

• Featured in: Example 3 on page 355

FRAMEBORDER=ON OFF

• specifies whether or not to put a border around the frame for an HTML file that uses frames.

• ON

  • places a border around the frame for an HTML file that uses frames.

• OFF

  • specifies not to put a border around the frame for an HTML file that uses frames.

• Applies to: frame

• ODS Destinations: HTML

FRAMEBORDERWIDTH= dimension

• specifies the width of the border around the frames for an HTML file that uses frames.

• Applies to: frame

• ODS Destinations: HTML

• See: dimension on page 294

FRAMESPACING= integer

• specifies the width of the space between frames for HTML that uses frames.

• Applies to: frame

• ODS Destinations: HTML

GRADIENT_DIRECTION= XAXIS YAXIS

• specifies the direction for the gradient effect for a graph's background, legend background, charts, walls, and floors. Use XAXIS for a left-to-right gradient and YAXIS for a bottom-to-top gradient.

• Applies to: graphs

• ODS Destinations: HTML

HREFTARGET= target

• specifies the window or frame in which to open the target of the link. target can be one of the following values.

• _BLANK

  • opens the target in a new, blank window. The window has no name.

• _PARENT

  • opens the target in the window from which the current window was opened.

• _SEARCH

  • opens the target in the browser's search pane.

  • Restriction: Only available in Internet Explorer 5.0 or later.

• _SELF

  • opens the target in the current window.

• _TOP

  • opens the target in the topmost window.

• ' name '

  • opens the target in the specified window or the frame.

• Default: _SELF

• Applies to: cells

• ODS Destinations: HTML

HTMLCLASS=' string '

• specifies the name of the style sheet class to use for the table or cell.

• Applies to: document

• ODS Destinations: HTML

• See: string on page 296

HTMLCONTENTTYPE=' string '

• provides the value of the content type for pages that you send directly to a web server rather than to a file.

• Tip: The value of string is usually 'text/html'.

• Applies to: document

• ODS Destinations: HTML

• See: string on page 296

HTMLDOCTYPE=' string '

• specifies the entire doctype declaration for the HTML document, including the opening '<!DOCTYPE' and the closing '>'.

• Applies to: document

• ODS Destinations: HTML

• See: string on page 296

HTMLID=' string '

• specifies an id for the table or cell. The id is for use by a Javascript.

• Applies to: tables and cells

• ODS Destinations: HTML

• See: string on page 296

HTMLSTYLE=' string '

• specifies individual attributes and values for the table or cell.

• Applies to: document

• ODS Destinations: HTML

• See: string on page 296

IMAGE= string

• specifies the image to appear in the graph. This image can be positioned or tiled.

• Applies to: graphs

• ODS Destinations: HTML

• Overridden by: IBACK= and IMAGESTYLE=TILE options in the SAS/GRAPH GOPTIONS statement

• See: string on page 296

INDENT= n

• specifies that the output be indented one more indention level, using the number of spaces specified by the INDENT= statement.

• Default: The default value for XML is 2. For all other ODS destinations, the default value is 0.

• ODS Destinations: MARKUP, RTF and PRINTER family

• n

  • specifies the number of spaces that you want the output to indent.

JUST=CENTER DEC LEFT RIGHT

• specifies justification. In graphs, this option specifies the justification of the image specified with the IMAGE= statement.

• CENTER

  • specifies center justification.

  • Alias: C

• DEC

  • specifies aligning the values by the decimal point.

  • Alias: D

• LEFT

  • specifies left justification.

  • Alias: L

• RIGHT

  • specifies right justification.

  • Alias: R

  • Restriction: Not all contexts support RIGHT. If RIGHT is not supported, it is interpreted as CENTER.

  • Interaction: If the column is numeric, then values are aligned to the right if you specify JUST=C and JUSTIFY=OFF.

  • Interaction: All destinations except LISTING justify the values in columns as if JUSTIFY=ON for JUST=R and JUST=L.

  • Main discussion: 'How Are Values in Table Columns Justified?' on page 512

  • Applied to: tables, cells, and graphs

  • ODS Destinations: HTML, PCL, PDF, PS, and RTF

  • Tip: For Printer Family destinations and the MARKUP destination, you can use the style attribute JUST= with the style attribute VJUST= in the style element PAGENO to control the placement of page numbers .

    For example, the following statement would produce a page number that is centered at the bottom of the page:

    style PageNo from TitleAndFooters / just=c vjust=b ;

  • Tip: For Printer Family destinations and the MARKUP destination, you can control the placement of dates by using the style attribute JUST= with the style attribute VJUST= in any of the following style elements:

    • BODYDATE

    • DATE.

    For example, the following statement would produce a date in the body file that is left justified at the top of the page:

    style BodyDate from Date / just=l vjust=t ;

LEFTMARGIN= dimension

• specifies the left margin for the document.

• Applies to: document

• ODS Destinations: HTML, RTF, PRINTER family

• See: dimension on page 294

LINESTYLE= 1 ... 46

• controls the line style for a graph. Possible values are SAS/GRAPH line types one through 46. If LINESTYLE=1, then a solid line is drawn. Dashed lines are drawn when values between (and including) two and 46 are specified as the LINESTYLE= value.

• Applies to: graphs

• ODS Destinations: HTML, RTF, PRINTER family

• See also: SAS/GRAPH Reference, Volumes 1 and 2

LINETHICKNESS= dimension number%

• specifies the thickness (width) of a line that is part of a graph. This attribute may appear in many style elements that pertain to graphs such as GraphAxisLines and GraphBorderLines. If you specify a percent, it represents a percentage of the width of the window or display.

• dimension

  • is a nonnegative number.

  • See: dimension on page 294

• number%

• Restriction: The LINETHICKNESS= attribute does not apply to output generated as a result of GRSEG (graph segment) output.

• Overridden by: WIDTH= option in the AXIS or SYMBOL statement, or other options that are specific to charts which set line width.

• Applies to: graphs

• ODS Destinations: HTML, RTF, Printer Family

• See also: SAS/GRAPH Reference, Volumes 1 and 2

LINKCOLOR= color

• specifies the color for links that have not yet been visited.

• Applies to: document

• ODS Destinations: HTML, RTF, and PDF

• See: color on page 292

LISTENTRYANCHOR=ON OFF

• specifies whether or not to make this entry in the table of contents a link to the body file.

• ON

  • specifies to make this entry in the table of contents a link to the body file.

• OFF

  • specifies not to make this entry in the table of contents a link to the body file.

• Applies to: document

• ODS Destinations: HTML

LISTENTRYDBLSPACE=ON OFF

• specifies whether or not to double space between entries in the table of contents.

• ON

  • specifies to double space between entries in the table of contents.

• OFF

  • specifies not to double space between entries in the table of contents.

• Applies to: document

• ODS Destinations: HTML

NOBREAKSPACE=ON OFF

• specifies how to handle space characters.

• ON

  • does not allow SAS to break a line at a space character.

• OFF

  • allows SAS to break a line at a space character if appropriate.

• Applies to: cells

• ODS Destinations: All

OUTPUTHEIGHT= dimension

• specifies the height for a graph or graphics in a document.

• Note: When used with graphs, the OUTPUTHEIGHT= dimension must be specified as a pixel or percentage value. If a unit of measure is not specified with the dimension , then the value will be in pixels. If a unit of measure other than pixels or percentage is specified with the dimension , then the OUTPUTHEIGHT= dimension is not applied to the graph.

• Alias: CELLHEIGHT=

• Restriction: The OUTPUTHEIGHT= option does not apply to output generated as a result of GRSEG (graph segment) output.

• Applies to: graphs and documents

• ODS Destinations: HTML, RTF, PRINTER family

• Overridden by: YPIXELS= option in the SAS/GRAPH GOPTIONS statement

• See: dimension on page 294

OUTPUTWIDTH= dimension number %

• specifies the width of a table, line, or a graph. If you specify a percent, it represents a percentage of the width of the window or display.

  Note: When used with graphs, the OUTPUTHEIGHT= dimension must be specified as a pixel or percentage value. If a unit of measure is not specified with the dimension , then the value will be in pixels. If a unit of measure other than pixels or percentage is specified with the dimension , then the OUTPUTHEIGHT= dimension is not applied to the graph.

• dimension

  • is a nonnegative number.

  • See: dimension on page 294

• number %

• Alias: CELLWIDTH=

• Restriction: The OUTPUTHEIGHT= option does not apply to output generated as a result of GRSEG (graph segment) output.

• Tip: Use OUTPUTWIDTH=100% to make the table or graph as wide as the window that it is open in.

• Applies to: tables and graphs

• ODS Destinations: HTML, RTF, PRINTER family

• Overridden by: XPIXELS= option in the SAS/GRAPH GOPTIONS statement

OVERHANGFACTOR= nonnegative-number

• specifies an upper limit for extending the width of the column.

• Tip: Typically, an overhang factor between 1 and 2 works well.

• Tip: The HTML that is generated by ODS tries to ensure that the text in a column wraps when it reaches the requested column width. If you make the overhang factor greater than 1, then the text can extend beyond the specified width.

• Applies to: document

• ODS Destinations: HTML, RTF, PRINTER family

PAGEBREAKHTML=' string '

• specifies HTML to place at page breaks.

• Applies to: document

• ODS Destinations: HTML

• See: string on page 296

POSTHTML=' string '

• specifies the HTML code to place after the table or cell.

• Applies to: tables or cells

• ODS Destinations: HTML

• Featured in: Example 3 on page 355

• See: string on page 296

POSTIMAGE= ' string ' fileref

• specifies an image to place before the table or cell.

• string

  • names a GIF or JPEG file. You can use a simple filename, a complete path, or a URL.

  • See: string on page 296

• fileref

  • is a reference that has been assigned to an external file. Use the FILENAME statement to assign a fileref. (For information about the FILENAME statement, see 'Statements' in SAS Language Reference: Dictionary .)

• Applies to: tables or cells

• ODS Destinations: HTML, PCL, PDF, PS, and RTF

POSTTEXT=' string '

• specifies text to place after the cell or table.

• Applies to: tables or cells

• ODS Destinations: HTML, PCL, PDF, PS, and RTF

• See: string on page 296

PREHTML=' string '

• specifies the HTML code to place before the table or cell.

• Applies to: tables or cells

• ODS Destinations: HTML

• See: string on page 296

PREIMAGE= ' string ' fileref

• specifies an image to place before the table or cell.

• string

  • names a GIF or JPEG file. You can use a simple filename, a complete path, or a URL.

  • See: string on page 296

• fileref

  • is a reference that has been assigned to an external file. Use the FILENAME statement to assign a fileref. (For information about the FILENAME statement, see 'Statements' in SAS Language Reference: Dictionary .)

• Applies to: tables or cells

• ODS Destinations: HTML, PCL, PDF, PS, and RTF

PRETEXT=' string '

• specifies text to place before the cell or table.

• Applies to: tables or cells

• ODS Destinations: HTML, PCL, PDF, PS, and RTF

• See: string on page 296

PROTECTSPECIALCHARACTERS=ON OFF AUTO

• determines how less-than signs (<), greater-than signs (>), and ampersands (&) are interpreted. In HTML and other markup languages, these characters indicate the beginning of a markup tag, the end of a markup tag, and the beginning of the name of a file or character entity.

• ON

  • interprets special characters as the characters themselves . That is, when ON is in effect the characters are protected before they are passed to the HTML or other markup language destination so that the characters are not interpreted as part of the markup language. Using ON enables you to show markup language tags in your document.

• OFF

  • interprets special characters as markup language tags. That is, when OFF is in effect, the characters are passed to the HTML or other markup language destination without any protection so that the special characters are interpreted as part of the markup language.

• AUTO

  • interprets any string that starts with a < and ends with a > as a markup language tag (ignoring spaces that immediately precede the <, spaces that immediately follow the >, and spaces at the beginning and end of the string). In any other string, AUTO protects the special characters from their markup language meaning.

• Applies to: cells

• ODS Destinations: HTML, MARKUP family, PRINTER family, and RTF

RIGHTMARGIN= dimension

• specifies the right margin for the document.

• Applies to: document

• ODS Destinations: HTML, RTF, PRINTER family

• See: dimension on page 294

RULES= rule-type

• specifies the types of rules to use in a table. The following table shows the possible values for rule and their meanings:

  This value of rule	Creates rules in these locations
  ALL	between all rows and columns
  COLS	between all columns
  GROUPS	between the table header and the table and between the table and the table footer, if there is one
  NONE	no rules anywhere
  ROWS	between all rows

• Applies to: tables

• ODS Destinations: HTML, RTF, PRINTER family

• Featured in: Example 4 on page 361

STARTCOLOR= color

• indicates the start fill color for a graph. It is used to create a gradient effect.

• Note: You can have either a start and end gradient effect or no gradient effect. If you specify a TRANSPARENCY level and you only specify the STARTCOLOR, then the end color will be completely transparent gradationally to the specified start color.

• Applies to: graphs

• ODS Destinations: HTML

• See: color on page 292

TAGATTR=' string '

• specifies text to insert in the HTML. The string must be valid HTML for the context in which the style element is created. Many style elements are created between <TD> and </TD> tags. To determine how a style element is created, look at the source for the output.

• Applies to: cells

• ODS Destinations: HTML

• See: string on page 296

TOPMARGIN= dimension

• specifies the top margin for the document.

• Applies to: document

• ODS Destinations: HTML, RTF, PRINTER family

• See: dimension on page 294

TRANSPARENCY= dimension

• specifies a transparency level. Valid values are 0.0 ( opaque ) to 1.0 (transparent).

• Applies to: graphs

• ODS Destinations: HTML

• See: dimension on page 294

URL=' uniform-resource-locator '

• specifies a URL to link to from the current cell.

• Applies to: cells

• ODS Destinations: HTML, RTF, and PDF

VISITEDLINKCOLOR= color

• specifies the color for links that have been visited.

• Applies to: document

• ODS Destinations: HTML and RTF

• See: color on page 292

VJUST=BOTTOM MIDDLE TOP

• specifies vertical justification. In graphs, this option specifies the vertical justification of the image specified with IMAGE=.

• BOTTOM

  • specifies bottom justification.

  • Alias: B

• MIDDLE

  • specifies center justification.

  • Alias: M

• TOP

  • specifies top justification.

  • Alias: T

• Applies to: cells and graphs

• ODS Destinations: HTML, PCL, PDF, PS, and RTF

• Tip: For Printer Family destinations and the MARKUP destination, you can use the style attribute VJUST= with the style attribute JUST= in the style element PAGENO to control the placement of page numbers.

  For example, the following statement produces a page number that is centered at the bottom of the page:

  style PageNo from TitleAndFooters / just=c vjust=b ;

• Tip: For Printer Family destinations and the MARKUP destination, you can control the placement of dates by using the style attribute VJUST= with the style attribute JUST= in any of the following style elements:

  • BODYDATE

    DATE

  For example, the following statement produces a date in the body file that is left justified at the top of the page:

  style BodyDate from Date / just=l vjust=t ;

WATERMARK=ON OFF

• specifies whether or not to make the image that is specified by BACKGROUNDIMAGE= into a 'watermark.' A watermark appears in a fixed position as the window is scrolled.

• ON

  • specifies to make the image that is specified by BACKGROUNDIMAGE= into a 'watermark.'

• OFF

  • specifies not to make the image that is specified by BACKGROUNDIMAGE= into a 'watermark.'

• Applies to: document

• ODS Destinations: HTML

END Statement

Ends the style definition

END ;