'\" t

...\" CreScE.sgm /main/8 1996/09/08 20:35:54 rws $

.de P!

.fl

\!!1 setgray

.fl

\\&.\"

.fl

\!!0 setgray

.fl			\" force out current output buffer

\!!save /psv exch def currentpoint translate 0 0 moveto

\!!/showpage{}def

.fl			\" prolog

.sy sed -e 's/^/!/' \\$1\" bring in postscript file

\!!psv restore

.

.de pF

.ie     ?\\*(f1?? .ds f1 \\n(.f

.el .ie ?\\*(f2?? .ds f2 \\n(.f

.el .ie ?\\*(f3?? .ds f3 \\n(.f

.el .ie ?\\*(f4?? .ds f4 \\n(.f

.el .tm ? font overflow

.ft \\$1

..

.de fP

.ie     !?\\*(f4?? \{\

.	ft \\*(f4

.	ds f4\"

'	br \}

.el .ie !?\\*(f3?? \{\

.	ft \\*(f3

.	ds f3\"

'	br \}

.el .ie !?\\*(f2?? \{\

.	ft \\*(f2

.	ds f2\"

'	br \}

.el .ie !?\\*(f1?? \{\

.	ft \\*(f1

.	ds f1\"

'	br \}

.el .tm ? font underflow

..

.ds f1\"

.ds f2\"

.ds f3\"

.ds f4\"

.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n 

.TH "XmCreateScrolledText" "library call"

.SH "NAME"

\fBXmCreateScrolledText\fP \(em The Text ScrolledText convenience creation function

.iX "XmCreateScrolledText"

.iX "creation functions" "XmCreateScrolledText"

.SH "SYNOPSIS"

.PP

.nf

#include <Xm/Text\&.h>

\fBWidget \fBXmCreateScrolledText\fP\fR(

\fBWidget \fBparent\fR\fR,

\fBString \fBname\fR\fR,

\fBArgList \fBarglist\fR\fR,

\fBCardinal \fBargcount\fR\fR);

.fi

.SH "DESCRIPTION"

.PP

\fBXmCreateScrolledText\fP 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 \fBXtParent\fP function\&.

The name of the ScrolledWindow created by this function is formed by

concatenating the letters \fBSW\fP

onto the end of the \fIname\fP specified in the parameter list\&.

.PP

The Text widget defaults to single-line text edit; therefore, no ScrollBars

are displayed\&. The Text resource \fBXmNeditMode\fP must be set to

\fBXmMULTI_LINE_EDIT\fP to display the ScrollBars\&.

The results of placing a Text widget inside a ScrolledWindow when the

Text\&'s \fBXmNeditMode\fP is \fBXmSINGLE_LINE_EDIT\fP are undefined\&.

.PP

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 \fBXmNdestroyCallback\fP

resource in the creation \fIarglist\fP is unspecified\&. The

application should use the \fBXtAddCallback\fP function to add

callbacks to the appropriate widget (Text or ScrolledWindow) after

creating it\&.

.PP

This function forces the following initial values for ScrolledWindow

resources:

.IP "   \(bu" 6

\fBXmNscrollingPolicy\fP is set to \fBXmAPPLICATION_DEFINED\fP\&.

.IP "   \(bu" 6

\fBXmNvisualPolicy\fP is set to \fBXmVARIABLE\fP\&.

.IP "   \(bu" 6

\fBXmNscrollBarDisplayPolicy\fP is set to \fBXmSTATIC\fP\&.

.IP "   \(bu" 6

\fBXmNshadowThickness\fP is set to 0 (zero)\&.

.IP "\fIparent\fP" 10

Specifies the parent widget ID

.IP "\fIname\fP" 10

Specifies the name of the created widget

.IP "\fIarglist\fP" 10

Specifies the argument list

.IP "\fIargcount\fP" 10

Specifies the number of attribute/value pairs in the argument list

(\fIarglist\fP)

.PP

For a complete definition of Text and its associated resources, see

\fBXmText\fP(3)\&.

.SH "RETURN"

.PP

Returns the Text widget ID\&.

.SH "RELATED"

.PP

\fBXmScrolledWindow\fP(3) and \fBXmText\fP(3)\&.

...\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:21