XmCreateScrolledText(library call)       XmCreateScrolledText(library call)




 NAME    [Toc]    [Back]
      XmCreateScrolledText - The Text ScrolledText convenience creation
      function

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

 DESCRIPTION    [Toc]    [Back]
      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.  Since the results of
      placing a Text widget inside a ScrolledWindow when the Text's
      XmNeditMode is XmSINGLE_LINE_EDIT are undefined, XmCreateScrolledText
      sets XmNeditMode to XmMULTI_LINE_EDIT. Note that Motif1.2 version of
      XmCreateScrolledText does not set XmNeditMode.

      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.




                                    - 1 -       Formatted:  January 24, 2005






 XmCreateScrolledText(library call)       XmCreateScrolledText(library call)




         +  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    [Toc]    [Back]
      Returns the Text widget ID.

 RELATED    [Toc]    [Back]
      XmScrolledWindow(3) and XmText(3).


                                    - 2 -       Formatted:  January 24, 2005