Treeview HTML Generator

Defining How the Data is Displayed

Use the following arguments in your DS2TREE macro call to define how the data is to be displayed. Default argument values are listed first and displayed in bold type.

labels=Y | N
indicates whether or not labels will be displayed in the tree. Specify LABELS=N to suppress the display of the labels.

lcolor=var
specifies the variable that you want to use to determine the color of the link lines. This variable should contain valid HTML color names. If it does not, you may be able to use the LCOLFMT argument to specify a SAS format that transforms the variable value to a valid HTML color. This variable must be of type character, unless LCOLFMT is specified.

lcolfmt=SAS-format-name
specifies the name of a valid SAS format to be applied to the variable specified in the LCOLOR argument. This is a user-defined format whose purpose is to transform the raw data value specified in LCOLOR to a valid HTML color.

Note that the raw data in the data set is not altered; the formatted value is used in the hierarchical tree rather than the raw data value. This is useful if your data set has a variable that can be used as a color if it were properly formatted.

lstip=var
specifies the variable whose value is used as the stipple mask. The value must be an integer, which is then converted into a binary value (for example, 1111000011110000); a "1" bit causes a pixel to be drawn and a "0" bit means that no pixel is drawn. Our example would cause four pixels to be drawn, four pixels to be skipped, four pixels to be drawn, and then four pixels to be skipped.

lstipfac=var
specifies the variable whose value is the multiplier that is applied to each bit in the stipple mask. This multiplier must be an integer. It specifies how many times to use each bit. For example, if your stipple mask is 1111000011110000 and the multiplier is 2, each bit of the mask counts as two pixels. Eight pixels, eight blanks, eight pixels, and eight blanks would be drawn in sequence.

lwidth=var
specifies the variable that you want to use to determine the width, in pixels, of the link lines. This variable must be of type numeric.

naction=var
specifies the variable that you want to use to determine the description of the action to be performed when the popup menu for this node is displayed.

ncolor=var
specifies the variable that you want to use to determine the color of the nodes. This variable should contain valid HTML color names. If it does not, you may be able to use the NCOLFMT argument to specify a SAS format that transforms the variable value to a valid HTML color. This variable must be of type character, unless NCOLFMT is specified.

ncolfmt=SAS-format-name
specifies the name of a valid SAS format to be applied to the variable specified in the NCOLOR argument. This is a user-defined format whose purpose is to transform the raw data value specified in NCOLOR to a valid HTML color.

Note that the raw data in the data set is not altered; the formatted value is used in the hierarchical tree rather than the raw data value. This is useful if your data set has a variable that can be used as a color if it were properly formatted.

ndata=SAS-data-set-name
specifies the SAS data set that contains the data you want to use to create the hierarchical tree. This argument is required.

nfntname=var
specifies the variable that you want to use to determine the font for the node label.

nfntsize=var
specifies the variable that you want to use to determine the size of the font, in points, for the node label.

nfntstyl=var
specifies the variable that you want to use to determine the font style for the node label. Supported values include Bold, Italic, and Plain.

nid=var
specifies the variable that you want to use represent the nodes in the hierarchical tree. This variable can be of type numeric or character.

nlabel=var
specifies the variable that you want to use represent the node labels. This variable can be of type numeric or character.

nparent=var
specifies the variable that you want to use represent the parent nodes. This variable can be of type numeric or character.

npw=password
specifies the password that is needed for accessing a password-protected data set. This argument is required if the data set has a READ or PW password. (You do not need to specify this argument if the data set has only WRITE or ALTER passwords.)

ntextcol=var
specifies the variable that you want to use to determine the color of the text for the node label.

ntip=var
specifies the variable that you want to use represent the floating "tips" associated with a node. This variable can be of type numeric or character.

ntipfmt=SAS-format-name
specifies the name of a valid SAS format to be applied to the variable specified in the NTIP argument. This is a user-defined format whose purpose is to transform the raw data value specified in NTIP to a more suitable value.

Note that the raw data in the data set is not altered; the formatted value is used in the hierarchical tree rather than the raw data value. This is useful if your data set has a variable that can be used as a tip if it were properly formatted.

nurl=var
specifies the variable that you want to use represent the URL to be displayed when Open URL is selected from the pop-up menu for a node. This variable must be of type character.

nwhere=where-expression
specifies a valid WHERE clause that selects observations from the SAS data set. Using this argument, you can subset your data based on the criteria specified in the where expression.

Note: If your expression contains any special characters (for example, % , & ), include %NRBQUOTE in the argument in order to process these characters correctly. This example shows the correct way to specify Int%. 

       where=%NRBQUOTE(value="Int%")