SAS/AF Software: Class Dictionary |
The text viewer object is a generic viewer that is the parent of two
predefined viewer classes:
- the External File Viewer class that displays the contents of an
external file (see the External File Viewer class)
- the Catalog Entry Viewer class that displays the text contained
in a SAS catalog entry (see the Catalog Entry Viewer class).
If, in a given object, you are displaying only external files or only
catalog entries, use either an external file viewer or a catalog entry viewer.
Use the Text Viewer class in any of these conditions:
- You have created a subclass of a predefined model in order to
provide additional functionality.
- You have created a new model for a particular data type.
- You need to switch between an external file model and a
catalog
entry model within one instance of the text viewer.
All text viewers must be connected to a model. A model retrieves data
and delivers lines of text to the text viewer for display. There are different
models for the different types of text a text viewer might display. Two models
are provided with SAS software:
- the External File Model class allows the text viewer to look at
the contents of an external file (see the External File Model class)
- the Catalog Entry Model class allows the text viewer to look at
the contents of a catalog entry (see the Catalog Entry Model class).
If your viewer requires special functionality or if it needs
to display text from any source not already covered by the provided models,
you can create a custom model for it. To create a custom model, you can either
subclass an existing model, or you can create a completely new model using
the Text Model Template class. For examples, see the Text Model Template class
and the External File Model class.
By default, the Text Viewer class is not on the Selection List opened
by the
Make
item of the Actions menu. Therefore, to create a text viewer object,
do one of the following:
- From a command line, issue the command
rm make 'text viewer'
- Add the Text Viewer class to the Selection List. Then you can
create the object by selecting
Text Viewer
from the list.
- If you are using your own RESOURCE entry, edit it and add the
Text Viewer class. Make sure the DISPLAY status is on.
Text Viewer
will be added
to the Selection List.
- Otherwise, copy the default RESOURCE entry, SASHELP.FSP.BUILD.RESOURCE,
into your current catalog. Edit the RESOURCE entry and make sure the DISPLAY
status is on.
Text Viewer
will be added to the Selection List.
|
Specifying a Model for a Text Viewer |
To specify which model your text viewer should use, do one of the following:
- Select a
model or enter your own model on the
Data Source
field in the
Attributes window.
- Specify a model by using the text viewer _attach method
in the
SCL program for the frame.
Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.