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

FreeBSD Manual Pages

  
 
  

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

NAME
     XmCreateScrolledText -- The Text ScrolledText convenience creation function

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

DESCRIPTION
     XmCreateScrolledText 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  func-
     tion.  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 asso-
     ciated  with the Text widget, use the Xt Intrinsics XtParent function.  The
     name of the ScrolledWindow created by this function is formed  by	concate-
     nating  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   Xm-
     MULTI_LINE_EDIT  to  display the ScrollBars.  The results of placing a Text
     widget inside a  ScrolledWindow  when  the  Text's  XmNeditMode  is  XmSIN-
     GLE_LINE_EDIT are undefined.

     All arguments to either the Text or the ScrolledWindow widget can be speci-
     fied  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 re-
     sult  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 cre-
     ating it.

     This  function  forces  the following initial values for ScrolledWindow re-
     sources:

	*  XmNscrollingPolicy is set to XmAPPLICATION_DEFINED.

	*  XmNvisualPolicy is set to XmVARIABLE.

	*  XmNscrollBarDisplayPolicy is set to XmSTATIC.

	*  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-
     Text(3).

RETURN
     Returns the Text widget ID.

RELATED
     XmScrolledWindow(3) and XmText(3).

							 XmCreateScrolledText(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmCreateScrolledText&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help