XmCreateScrolledText(3X) SDK X11 R4.11MU05 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;
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.
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
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(3X).
RETURN VALUE
Returns the Text widget ID.
RELATED INFORMATION
XmScrolledWindow(3X) and XmText(3X).
Licensed material--property of copyright holder(s)