# cw_term.pro

At APS this program is installed in the /usr/local/epics/extensions/bin/$HOST_ARCH directory. This is a utility program for generating window display terminal. It also provides a button of printing the window contents.

# List of Routines

- CW_TERM

# Routine Descriptions

## CW_TERM

[List of Routines]

     NAME:
    	cw_term

     PURPOSE:
          writtable text window widget

     CATEGORY:
    	Compound widgets.

     CALLING SEQUENCE:
    	widget_id = CW_TERM(parent)

     INPUTS:
           PARENT - The ID of the parent widget.

     KEYWORD PARAMETERS:
    	BG_NAMES:	An array of strings to be associated with
    			each button and returned in the event structure as VALUE.
    	BGEVENT_FUNCT:	The name of an user-supplied event function
    			for the buttons. This function is called with the return
    			value structure whenever a button is pressed, and
    			follows the conventions for user-written event
    			functions.
    	FONT:		The name of the font to be used for the text output
    			If this keyword is not specified, the default
    			font is used.
    	FRAME:		Specifies the width of the frame to be drawn around
    			the base.
           FILENAME:       Copy contents of file into widget
           RESET:          Clear existing widget contents and write new value/file.
                           The parent widget is the existing widget id.
    	MAP:		If set, the base will be mapped when the widget
    			is realized (the default).
    	SCROLL:		If set, the base will include scroll bars to allow
    			viewing a large text area through a smaller viewport.
    	SET_VALUE:	The initial value of the text widget. This is equivalent
    			to the later statement:

    			WIDGET_CONTROL, widget, set_value=value

           TITLE:          New Window title
    	UVALUE:         The user value for the compound widget

    	XSIZE:		The width of the text widget
    	YSIZE:		The height of the text widget

     OUTPUTS:
           The ID of the created widget is returned.

     COMMON BLOCKS:
    	None.

     SIDE EFFECTS:

     PROCEDURE:
    	WIDGET_CONTROL, id, SET_VALUE=value can be used to change the
    		current value displayed by the widget.

    	WIDGET_CONTROL, id, GET_VALUE=var can be used to obtain the current
    		value displayed by the widget.

     MODIFICATION HISTORY:
      01  8-9-95  jps  	modified from idl's cw_tmpl.pro

(See cw_term.pro)