NAME

       XmCreateScrolledText  —  The  Text  ScrolledText  convenience  creation  function  "XmCreateScrolledText"
       "creation functions" "XmCreateScrolledText"

SYNOPSIS

       #include <Xm/Text.h>
       Widget XmCreateScrolledText(
       Widget parent,
       String name,
       ArgList arglist,
       Cardinal argcount);

DESCRIPTION

       XmCreateScrolledText creates an instance of a Text widget that is contained within a ScrolledWindow.  The
       ScrolledWindow parent is created managed.  All ScrolledWindow subarea widgets are  automatically  created
       by  this  function.   The ID returned by this function is that of the Text widget (not the ScrolledWindow
       widget).  Use this widget ID for all operations on the Text widget.   Use  the  widget  ID  of  the  Text
       widget's  parent for all operations on the ScrolledWindow.  To obtain the ID of the ScrolledWindow widget
       associated with the Text widget, use the Xt Intrinsics XtParent function.  The name of the ScrolledWindow
       created by this function is formed by concatenating the letters SW onto the end of the name specified  in
       the parameter list.

       The  Text  widget  defaults  to  single-line  text edit; therefore, no ScrollBars are displayed. The Text
       resource XmNeditMode must be set to XmMULTI_LINE_EDIT to display the ScrollBars.  The results of  placing
       a Text widget inside a ScrolledWindow when the Text's XmNeditMode is XmSINGLE_LINE_EDIT are undefined.

       All arguments to either the Text or the ScrolledWindow widget can be specified at creation time with this
       function.   Changes  to  initial  position  and  size  are sent only to the ScrolledWindow widget.  Other
       resources are sent to the Text or the ScrolledWindow widget as appropriate.   Note  that  the  result  of
       providing  the XmNdestroyCallback resource in the creation arglist is unspecified. The application should
       use the XtAddCallback function to add callbacks to the appropriate widget (Text or ScrolledWindow)  after
       creating it.

       This function forces the following initial values for ScrolledWindow resources:

          •  XmNscrollingPolicy is set to XmAPPLICATION_DEFINED.

          •  XmNvisualPolicy is set to XmVARIABLE.

          •  XmNscrollBarDisplayPolicy is set to XmSTATIC.

          •  XmNshadowThickness is set to 0 (zero).

       parent    Specifies the parent widget ID

       name      Specifies the name of the created widget

       arglist   Specifies the argument list

       argcount  Specifies the number of attribute/value pairs in the argument list (arglist)

       For a complete definition of Text and its associated resources, see XmText(3).

RETURN

       Returns the Text widget ID.

RELATED

       XmScrolledWindow(3) and XmText(3).

                                                                                         XmCreateScrolledText(3)