Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
XmCreateScrolledText(3)	   Library Functions Manual    XmCreateScrolledText(3)

       XmCreateScrolledText  --	 The  Text  ScrolledText  convenience creation

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

       XmCreateScrolledText creates an instance	of a Text widget that is  con-
       tained  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 op-
       erations	 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.  The results of placing  a
       Text widget inside a ScrolledWindow when	the Text's XmNeditMode is XmS-
       INGLE_LINE_EDIT are undefined.

       All arguments to	either the Text	or the ScrolledWindow  widget  can  be
       specified  at creation time with	this function.	Changes	to initial po-
       sition and size are sent	only to	the ScrolledWindow widget.  Other  re-
       sources	are sent to the	Text or	the ScrolledWindow widget as appropri-
       ate.  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

	  o  XmNscrollingPolicy	is set to XmAPPLICATION_DEFINED.

	  o  XmNvisualPolicy is	set to XmVARIABLE.

	  o  XmNscrollBarDisplayPolicy is set to XmSTATIC.

	  o  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 Xm-

       Returns the Text	widget ID.

       XmScrolledWindow(3) and XmText(3).



Want to link to this manual page? Use this URL:

home | help