Museum

 XmCreateScrolledText(Xm)       6 January 1993       XmCreateScrolledText(Xm)


 Name

    XmCreateScrolledText - the TextScrolledText convenience creation function

 Syntax


    #include <Xm/Text.h>

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


 Description

    XmCreateScrolledText creates an instance of a Text widget that is con-
    tained within a ScrolledWindow. All ScrolledWindow subarea widgets are
    automatically 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
    XmMULTILINEEDIT to display the ScrollBars.  The results of placing a
    Text widget inside a ScrolledWindow when the Text's XmNeditMode is
    XmSINGLELINEEDIT are undefined.

    All arguments to either the Text or the ScrolledWindow widget can be
    specified at creation time using this function.  Changes to initial posi-
    tion and size are sent only to the ScrolledWindow widget.  Other
    resources are sent to the Text or the ScrolledWindow widget as appropri-
    ate.

    This function forces the following initial values for ScrolledWindow
    resources:

    +  XmNscrollingPolicy is set to XmAPPLICATIONDEFINED.

    +  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 Scrol-
    ledText, use the Xt Intrinsics XtParent function.  The name of the Scrol-
    ledWindow 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

    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(Xm).

 Return value

    Returns the Text widget ID.

 See also

    XmScrolledWindow(Xm) and XmText(Xm).