Organizational Chart: _print

Organizational Chart: _print

Prints the current chart, or part of the current chart, and optionally opens the Print window before sending the chart to the printer

Syntax
_print List Items
Details
	Tips for Printing Organizational Charts
Example

Syntax

CALL NOTIFY (orgchart-name, '_print'<, print-list>);

Argument Type Description

print-list
N specifies the identifier of an SCL list containing the items in _print List Items. A missing value for any numeric variable is interpreted as 0.

Argument	Type	Description
print-list	N	specifies the identifier of an SCL list containing the items in _print List Items. A missing value for any numeric variable is interpreted as 0.

_print List Items
List Item Type Description

'BYPAGE' N a value controlling how the nodes are printed. To print all subtrees that are at the same level as the specified node, one per page if ONEPAGE is true, specify a nonzero value for BYPAGE and a value for NODEID.

'DEVICED' C the description of the print device. If you do not set this value, successive calls use the value specified in the Print window. This item is for information only.

'DEVICEN' C the name of the device to print to, including the SAS/GRAPH print driver. If you do not set this value, successive calls use the value specified in the Print window.

'GSFNAME' C fileref to use for output. See GSFNAME under GOPTIONS.

'GSFMODE' C corresponds to GOPTIONS GSFMODE to either 'REPLACE' or 'APPEND' the output. ('REPLACE' is the default.)

'LEVELS' N the number of tree levels down from the node where printing begins. Specify 0 to print all levels.

'NODEID' N the numeric identifier of the node you wish to begin printing from.If omitted, printing begins at the root of the tree.

'ONEPAGE' N flag indicating whether "fit to page" options are used. Set to 1 to fit to page.

'SETUP' N a value controlling whether the Print window opens:

0 do not open

^= 0 open (default)

'SWAPBW' N a value controlling whether to reverse black and white color interpretation

0 do not reverse

^= 0 reverse

Details

If no list is passed in, the options from the previous call to _printSetup are used. If these options have not been set, the options window will come up automatically.

Tips for Printing Organizational Charts

When you use the _print method, you should consider the following:

The "Fit to a page" option only works when printing the SAS/GRAPH driver. Scaled output uses a software font (SIMPLEX) that scales correctly on any driver. Uniform spacing is used to maintain the relationships between multi-row text in the nodes.
Extremely large organizational charts do not scale well. The output is often incomplete and/or unreadable.
Some print drivers append multiple pages of output to the same export file while others replace the contents. Be sure to test your output.
When printing all sibling subtrees of a selected node, every subtree will begin at the left-most edge of the page and will be trimmed to the page size. The remaining content will be printed on a subsequent page or pages. If you choose the "Fit to a page" or ONEPAGE printing option, each subtree will be scaled to fit on a single page.
Note: Subtrees may be scaled differently depending on their size.

Example

This example prints the tree from the last selected node. It also causes the Print window to open. Assigning 0 to SETUP would bypass the Print window.

call notify('org1','_get_selected_',widgetid,
             nodeid);
prlist = makelist(0);
prlist = setnitemn(prlist,nodeid,'nodeid');
         /* <= 0 if none clicked on */
prlist = setnitemn(prlist,1,'setup');
call notify('org1','_print_',prlist);
rc = dellist(prlist);

Chapter Contents
Previous
Next
Top of Page