XmCreateScrolledText(3X) UNIX System V 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 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 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 resources:
⊕ XmNscrollingPolicy is set to XmAPPLICATIONDEFINED.
⊕ XmNvisualPolicy is set to XmVARIABLE.
⊕ XmNscrollBarDisplayPolicy is set to XmSTATIC.
⊕ XmNshadowThickness is set to 0.
Page 1 (printed 4/30/98)
XmCreateScrolledText(3X) UNIX System V XmCreateScrolledText(3X)
To obtain the ID of the ScrolledWindow widget associated
with the ScrolledText, 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.
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 XmText(3X).
RETURN VALUE
Returns the Text widget ID.
RELATED INFORMATION
XmScrolledWindow(3X) and XmText(3X).
Page 2 (printed 4/30/98)