XmCreateScrolledText(3X)

NAME
     XmCreateScrolledText --The TextScrolledText convenience creation function

SYNOPSIS
     #include <Xm/Text.h>

     Widget XmCreateScrolledText (parent, name, arglist, argcount)
          Widget    parent;
          String    name;
          ArgList   arglist;
          Cardinal  argcount;


VERSION
     This page documents version 1.2 of the Motif library.

DESCRIPTION
     XmCreateScrolledText creates an instance of a Text widget that is contained
     within  a ScrolledWindow.  All ScrolledWindow subarea widgets are automati-
     cally created by this function. The ID returned by this function is that of
     the Text widget.  Use this ID for all normal Text operations,  as  well  as
     those that are relevant for the ScrolledText widget.

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

     All arguments to either the Text or the ScrolledWindow widget can be speci-
     fied at creation time using 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.

     This  function  forces  the following initial values for ScrolledWindow re-
     sources:


       *  XmNscrollingPolicy is set to XmAPPLICATION_DEFINED.

       *  XmNvisualPolicy is set to XmVARIABLE.

       *  XmNscrollBarDisplayPolicy is set to XmSTATIC.

       *  XmNshadowThickness is set to 0.


     To obtain the ID of the ScrolledWindow widget associated with the Scrolled-
     Text, use the Xt Intrinsics XtParent function.  The name of  the  Scrolled-
     Window  created  by this function is formed by concatenating the letters SW
     onto the end of the name specified in the parameter list.


     parent Specifies the parent widget ID

     name   Specifies the name of the created widget

     arglistSpecifies 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 Xm-
     Text(3X).

RETURN VALUE
     Returns the Text widget ID.

RELATED INFORMATION
     XmScrolledWindow(3X) and XmText(3X).

                                                        XmCreateScrolledText(3X)