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

FreeBSD Manual Pages

  
 
  

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

NAME
       XmTextField -- The TextField class

SYNOPSIS
       #include	<Xm/Xm.h>

DESCRIPTION
       The TextField widget provides a single line text	editor for customizing
       both user and programmatic  interfaces.	It  is	used  for  single-line
       string  entry,  and  forms entry	with verification procedures.  It pro-
       vides an	application with a consistent editing system for textual data.

       TextField provides separate callback lists to verify  movement  of  the
       insert  cursor,	modification  of the text, and changes in input	focus.
       Each of these callbacks provides	the  verification  function  with  the
       widget  instance, the event that	caused the callback, and a data	struc-
       ture specific to	the verification  type.	 From  this  information,  the
       function	 can  verify if	the application	considers this to be a legiti-
       mate state change and can signal	the widget whether  to	continue  with
       the action.

       The user	interface tailors a new	set of actions.	 The key bindings have
       been added for insert cursor movement, deletion,	insertion, and	selec-
       tion of text.

       TextField  allows  the  user  to	 select	regions	of text.  Selection is
       based on	the model specified in the Inter-Client	Communication  Conven-
       tions  Manual (ICCCM).  TextField supports primary and secondary	selec-
       tion.

       TextField   uses	  the	XmQTnavigator,	 XmQTspecifyRenderTable,   and
       XmQTscrollFrame	traits,	 and  holds the	XmQTaccessTextual XmQTtransfer
       traits.

       If an application or widget calls the setValue trait method of  XmQTac-
       cessTextual, then XmTextField will call XmTextFieldSetString to set the
       string value.

   Data	Transfer Behavior
       TextField supports transfer of the primary,  secondary,	and  clipboard
       selections  and	dragging  of selected text from	the widget.  TextField
       can also	be the destination for the primary, secondary,	and  clipboard
       selections,  and	 it  supports  dropping	of data	being dragged onto the
       widget.

       When the	XmNconvertCallback procedures are  called,  the	 location_data
       member  of  the	XmConvertCallbackStruct	member is NULL if the selected
       text is being transferred.  If the entire text, not the selected	 text,
       is  being transferred, the value	of this	member is the widget ID	of the
       TextField widget.

       As a source of data, TextField supports the following targets and asso-
       ciated conversions of data to these targets:

       UTF8_STRING
		 The widget transfers the selected text	as type	UTF8_STRING.

       locale	 If  the locale	target matches the widget's locale, the	widget
		 transfers the selected	text in	the encoding of	the locale.

       COMPOUND_TEXT
		 The widget transfers the selected text	as type	COMPOUND_TEXT.

       STRING	 The widget transfers the selected text	as type	STRING.

       TEXT	 If the	selected text is fully convertible to the encoding  of
		 the locale, the widget	transfers the selected text in the en-
		 coding	of the locale.	Otherwise, the	widget	transfers  the
		 selected text as type COMPOUND_TEXT.

       DELETE	 The widget deletes the	selected text.

       _MOTIF_CLIPBOARD_TARGETS
		 The  widget transfers,	as type	ATOM, a	list of	the targets to
		 which the widget can convert data to be placed	on  the	 clip-
		 board immediately.  These include the following targets:

		    o  UTF8_STRING

		    o  COMPOUND_TEXT

		    o  The  encoding  of  the  locale, if the selected text is
		       fully convertible to the	encoding of the	locale

		    o  STRING, if the selected text is	fully  convertible  to
		       STRING

       _MOTIF_EXPORT_TARGETS
		 The  widget transfers,	as type	ATOM, a	list of	the targets to
		 be used as the	value of the DragContext's XmNexportTargets in
		 a  drag-and-drop  transfer.  These include COMPOUND_TEXT, the
		 encoding of the  locale,  STRING,  TEXT,  UTF8_STRING,	 BACK-
		 GROUND, and FOREGROUND.

       _MOTIF_LOSE_SELECTION
		 The widget takes the following	actions:

		    o  When  losing the	PRIMARY	selection, it unhighlights the
		       selected	text and calls the XmNlosePrimaryCallback pro-
		       cedures.

		    o  When  losing  the  SECONDARY  selection,	it removes the
		       secondary selection highlight.

		    o  When losing the _MOTIF_DESTINATION  selection,  if  the
		       widget does not have focus it changes the cursor	to in-
		       dicate that the widget is no longer the destination.

       As a source of data, TextField also supports the	following standard Mo-
       tif targets:

       BACKGROUND
		 The widget transfers XmNbackground as type PIXEL.

       CLASS	 The widget finds the first shell in the widget	hierarchy that
		 has a WM_CLASS	property and transfers the contents as text in
		 the current locale.

       CLIENT_WINDOW
		 The  widget finds the first shell in the widget hierarchy and
		 transfers its window as type WINDOW.

       COLORMAP	 The widget transfers XmNcolormap as type COLORMAP.

       FOREGROUND
		 The widget transfers XmNforeground as type PIXEL.

       NAME	 The widget finds the first shell in the widget	hierarchy that
		 has  a	WM_NAME	property and transfers the contents as text in
		 the current locale.

       TARGETS	 The widget transfers, as type ATOM, a list of the targets  it
		 supports.   These  include the	standard targets in this list.
		 These also include COMPOUND_TEXT, the encoding	of the locale,
		 STRING, TEXT and UTF8_STRING.

       TIMESTAMP The widget transfers the timestamp used to acquire the	selec-
		 tion as type INTEGER.

       _MOTIF_RENDER_TABLE
		 The widget transfers XmNrenderTable if	it exists, or else the
		 default text render table, as type STRING.

       _MOTIF_ENCODING_REGISTRY
		 The  widget  transfers	 its encoding registry as type STRING.
		 The value is a	list of	NULL separated items in	 the  form  of
		 tag encoding pairs.  This target symbolizes the transfer tar-
		 get for the Motif Segment Encoding Registry.  Widgets and ap-
		 plications  can  use  this Registry to	register text encoding
		 formats for specified render table tags.  Applications	access
		 this	Registry   by  calling	XmRegisterSegmentEncoding  and
		 XmMapSegmentEncoding.

       As a destination	for data, TextField chooses a target and requests con-
       version of the selection	to that	target.	 If the	encoding of the	locale
       is present in the list of available targets, TextField  chooses	a  re-
       quested	target	from  the  available targets in	the following order of
       preference:

	  1. TEXT

	  1. UTF8_STRING

	  2. COMPOUND_TEXT

	  3. The encoding of the locale

	  4. STRING

       If the encoding of the locale is	not present in the list	 of  available
       targets,	 TextField  chooses a requested	target from the	available tar-
       gets in the following order of preference:

	  1. UTF8_STRING

	  1. COMPOUND_TEXT

	  2. STRING

   Classes
       TextField widget	inherits behavior, resources, and traits from Core and
       Primitive.

       The class pointer is xmTextFieldWidgetClass.

       The class name is XmTextField.

   New Resources
       The  following table defines a set of widget resources used by the pro-
       grammer to specify data.	The programmer can also	set the	resource  val-
       ues  for	 the  inherited	 classes to set	attributes for this widget. To
       reference a resource by name or by class	in a .Xdefaults	 file,	remove
       the  XmN	or XmC prefix and use the remaining letters. To	specify	one of
       the defined values for a	resource in a .Xdefaults file, remove  the  Xm
       prefix  and  use	 the  remaining	letters	(in either lower case or upper
       case, but include any underscores between words).  The codes in the ac-
       cess  column indicate if	the given resource can be set at creation time
       (C), set	by using XtSetValues (S), retrieved by using XtGetValues  (G),
       or is not applicable (N/A).

       +--------------------------------------------------------------------------------------------------+
       |			   |	     XmTextFieldResource Set	       |		 |	  |
       |Name			   | Class		      |	Type	       | Default	 | Access |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNactivateCallback	   | XmCCallback	      |	XtCallbackList | NULL		 | C	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNblinkRate		   | XmCBlinkRate	      |	int	       | 500		 | CSG	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNcolumns		   | XmCColumns		      |	short	       | dynamic	 | CSG	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNcursorPosition	   | XmCCursorPosition	      |	XmTextPosition | 0		 | CSG	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNcursorPositionVisible   | XmCCursorPositionVisible |	Boolean	       | dynamic	 | CSG	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNdestinationCallback	   | XmCCallback	      |	XtCallbackList | NULL		 | C	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNeditable		   | XmCEditable	      |	Boolean	       | True		 | CSG	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNfocusCallback	   | XmCCallback	      |	XtCallbackList | NULL		 | C	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNfontList		   | XmCFontList	      |	XmFontList     | dynamic	 | CSG	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNgainPrimaryCallback	   | XmCCallback	      |	XtCallbackList | NULL		 | C	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNlosePrimaryCallback	   | XmCCallback	      |	XtCallbackList | NULL		 | C	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNlosingFocusCallback	   | XmCCallback	      |	XtCallbackList | NULL		 | C	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNmarginHeight		   | XmCMarginHeight	      |	Dimension      | 5		 | CSG	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNmarginWidth		   | XmCMarginWidth	      |	Dimension      | 5		 | CSG	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNmaxLength		   | XmCMaxLength	      |	int	       | largest integer | CSG	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNmodifyVerifyCallback	   | XmCCallback	      |	XtCallbackList | NULL		 | C	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNmodifyVerifyCallbackWcs | XmCCallback	      |	XtCallbackList | NULL		 | C	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNmotionVerifyCallback	   | XmCCallback	      |	XtCallbackList | NULL		 | C	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNpendingDelete	   | XmCPendingDelete	      |	Boolean	       | True		 | CSG	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNrenderTable		   | XmCRenderTable	      |	XmRenderTable  | dynamic	 | CSG	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNresizeWidth		   | XmCResizeWidth	      |	Boolean	       | False		 | CSG	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNselectionArray	   | XmCSelectionArray	      |	XtPointer      | default array	 | CSG	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNselectionArrayCount	   | XmCSelectionArrayCount   |	int	       | 3		 | CSG	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNselectThreshold	   | XmCSelectThreshold	      |	int	       | 5		 | CSG	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNvalue		   | XmCValue		      |	String	       | ""		 | CSG	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNvalueChangedCallback	   | XmCCallback	      |	XtCallbackList | NULL		 | C	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNvalueWcs		   | XmCValueWcs	      |	wchar_t	*      | (wchar_t *)""	 | CSG1	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       |XmNverifyBell		   | XmCVerifyBell	      |	Boolean	       | dynamic	 | CSG	  |
       +---------------------------+--------------------------+----------------+-----------------+--------+
       +---------------------------+--------------------------+----------------+-----------------+--------+
       1 This resource cannot be specified in a	resource file.

       XmNactivateCallback
		 Specifies  the	list of	callbacks that is called when the user
		 invokes an event that calls the activate() action.  The  type
		 of  the structure whose address is passed to this callback is
		 XmAnyCallbackStruct.  The reason  sent	 by  the  callback  is
		 XmCR_ACTIVATE.

       XmNblinkRate
		 Specifies  the	blink rate of the text cursor in milliseconds.
		 The time indicated in the blink rate relates to the length of
		 time the cursor is visible and	the time the cursor is invisi-
		 ble (that is, the time	it will	take to	 blink	the  insertion
		 cursor	on and off will	be two times the blink rate). The cur-
		 sor will not blink when the blink rate	is set	to  0  (zero).
		 The value must	not be negative.

       XmNcolumns
		 Specifies  the	initial	width of the text window as an integer
		 number	of characters. The width equals	the number of  charac-
		 ters  specified  by  this resource multiplied by the width as
		 derived from the specified font. If  the  em-space  value  is
		 available,  it	 is used. If not, the width of the numeral "0"
		 is used. If this is not available, the	maximum	width is used.
		 For proportionate fonts, the actual number of characters that
		 fit on	a given	line may be greater than the value specified.

       XmNcursorPosition
		 Indicates the position	in the text where the  current	insert
		 cursor	is to be located. Position is determined by the	number
		 of characters from the	beginning of the text.

       XmNcursorPositionVisible
		 If the	text widget has	an XmPrintShell	as one of  its	ances-
		 tors  (that is, the widget was	created	on a print server con-
		 nection) then the default value is False;  otherwise,	it  is
		 True.

       XmNdestinationCallback
		 Specifies  a  list of callbacks called	when the widget	is the
		 destination of	a transfer operation.  The type	of the	struc-
		 ture whose address is passed to these callbacks is XmDestina-
		 tionCallbackStruct.  The reason is XmCR_OK.

       XmNeditable
		 When set to True, indicates that the user can edit  the  text
		 string.   A  false  value will	prohibit the user from editing
		 the text.

		 When XmNeditable is used on a widget it sets the dropsite  to
		 XmDROP_SITE_ACTIVE.

       XmNfocusCallback
		 Specifies the list of callbacks called	when TextField accepts
		 input focus. The type	of  the	 structure  whose  address  is
		 passed	 to  this  callback is XmAnyCallbackStruct. The	reason
		 sent by the callback is XmCR_FOCUS.

       XmNfontList
		 Specifies the font list to be used for	 TextField.  The  font
		 list  is an obsolete structure, and is	retained only for com-
		 patibility with earlier releases of Motif. Use	the render ta-
		 ble (XmNrenderTable) instead of font lists wherever possible.
		 If both are specified,	the render table will take precedence.
		 If this value is NULL at initialization, the parent hierarchy
		 of the	widget is searched for	an  ancestor  that  holds  the
		 XmQTspecifyRenderTable	 trait.	 If such an ancestor is	found,
		 the font list is initialized to the XmTEXT_RENDER_TABLE value
		 of the	ancestor widget. If no such ancestor is	found, the de-
		 fault is implementation dependent.

		 TextField searches the	font list for the first	occurrence  of
		 a  font  set that has an XmFONTLIST_DEFAULT_TAG. If a default
		 element is not	found, the first font set in the font list  is
		 used.	If  the	 list contains no font sets, the first font in
		 the font list will be used.  Refer to XmFontList(3) for  more
		 information on	a font list structure.

       XmNgainPrimaryCallback
		 Specifies the list of callbacks that are called when the user
		 invokes an event that causes the text widget to  gain	owner-
		 ship  of  the primary selection. The callback reason for this
		 callback is XmCR_GAIN_PRIMARY.

       XmNlosePrimaryCallback
		 Specifies the list of callbacks that are called when the user
		 invokes an event that cause the text widget to	lose ownership
		 of the	primary	selection. The callback	reason for this	 call-
		 back is XmCR_LOSE_PRIMARY.

       XmNlosingFocusCallback
		 Specifies  the	 list  of  callbacks  that  are	 called	before
		 TextField widget loses	input focus.  The type of  the	struc-
		 ture  whose address is	passed to this callback	is XmTextVeri-
		 fyCallbackStruct.   The  reason  sent	by  the	 callback   is
		 XmCR_LOSING_FOCUS.

       XmNmarginHeight
		 Specifies  the	 distance  between  the	top edge of the	widget
		 window	and the	text, and the bottom edge of the widget	window
		 and the text.

       XmNmarginWidth
		 Specifies  the	 distance  between the left edge of the	widget
		 window	and the	text, and the right edge of the	widget	window
		 and the text.

       XmNmaxLength
		 Specifies  the	 maximum length	of the text string that	can be
		 entered into text from	the keyboard.  This value must be non-
		 negative.   Strings  that  are	entered	using the XmNvalue re-
		 source	or the XmTextFieldSetString function ignore  this  re-
		 source.

       XmNmodifyVerifyCallback
		 Specifies the list of callbacks that is called	before text is
		 deleted from or inserted into TextField.   The	 type  of  the
		 structure  whose  address  is	passed to this callback	is Xm-
		 TextVerifyCallbackStruct.  The	reason sent by the callback is
		 XmCR_MODIFYING_TEXT_VALUE.   When  multiple TextField widgets
		 share the same	source,	only the  widget  that	initiates  the
		 source	change will generate the XmNmodifyVerifyCallback.

		 If  both XmNmodifyVerifyCallback and XmNmodifyVerifyCallback-
		 Wcs are registered callback lists, the	 procedure(s)  in  the
		 XmNmodifyVerifyCallback  list	is  always executed first; and
		 the resulting data, which may have been modified,  is	passed
		 to the	XmNmodifyVerifyCallbackWcs callback routines.

       XmNmodifyVerifyCallbackWcs
		 Specifies the list of callbacks called	before text is deleted
		 from or inserted into Text. The type of the  structure	 whose
		 address  is  passed to	this callback is XmTextVerifyCallback-
		 StructWcs. The	reason sent by the  callback  is  XmCR_MODIFY-
		 ING_TEXT_VALUE.   When	 multiple  TextField widgets share the
		 same source, only the widget that initiates the source	change
		 will generate the XmNmodifyVerifyCallbackWcs.

		 If  both XmNmodifyVerifyCallback and XmNmodifyVerifyCallback-
		 Wcs are registered callback lists, the	 procedure(s)  in  the
		 XmNmodifyVerifyCallback  list	is  always executed first; and
		 the resulting data, which may have been modified,  is	passed
		 to the	XmNmodifyVerifyCallbackWcs callback routines.

       XmNmotionVerifyCallback
		 Specifies the list of callbacks that is called	before the in-
		 sert cursor is	moved to a new	position.   The	 type  of  the
		 structure  whose  address  is	passed to this callback	is Xm-
		 TextVerifyCallbackStruct.  The	reason sent by the callback is
		 XmCR_MOVING_INSERT_CURSOR.   It is possible for more than one
		 XmNmotionVerifyCallbacks to be	generated from	a  single  ac-
		 tion.

       XmNpendingDelete
		 Indicates  that pending delete	mode is	on when	the Boolean is
		 True.	Pending	deletion is defined as	deletion  of  the  se-
		 lected	text when an insertion is made.

       XmNrenderTable
		 Specifies  the	render table to	be used	in deriving a font set
		 or font for displaying	text. If both a	 render	 table	and  a
		 font  list  are  specified, the render	table will take	prece-
		 dence.	If the value of	XmNrenderTable is NULL at  initializa-
		 tion,	the  parent hierarchy of the widget is searched	for an
		 ancestor that holds the XmQTspecifyRenderTable	trait. If such
		 an ancestor is	found, the font	list is	initialized to the Xm-
		 TEXT_RENDER_TABLE value of the	ancestor widget.  If  no  such
		 ancestor is found, the	default	is implementation dependent.

		 TextField  searches the render	table for the first occurrence
		 of a rendition	that has the tag _MOTIF_DEFAULT_LOCALE.	 If  a
		 default  element is not found,	the first rendition in the ta-
		 ble is	used. Refer to XmRenderTable(3)	for  more  information
		 on the	render table structure.

       XmNresizeWidth
		 Indicates  that  the  TextField widget	will attempt to	resize
		 its width to accommodate all the text contained in the	widget
		 when Boolean is True.

       XmNselectionArray
		 Defines  the  actions	for  multiple mouse clicks. Each mouse
		 click performed within	some time of the previous mouse	 click
		 will  increment the index into	this array and perform the de-
		 fined action for that	index.	(This  "multi-click"  time  is
		 specified by the operating environment, and varies among dif-
		 ferent	systems. In general, it	is usually set to  some	 frac-
		 tion of a second.)  The possible actions are

		 XmSELECT_POSITION
			   Resets the insert cursor position

		 XmSELECT_WORD
			   Selects a word

		 XmSELECT_LINE
			   Selects a line of text

       XmNselectionArrayCount
		 Specifies the number of actions that are defined in the XmNs-
		 electionArray resource.  The value must not be	negative.

       XmNselectThreshold
		 Specifies the number of pixels	of motion that is required  to
		 select	 the  next character when selection is performed using
		 the click-drag	mode of	selection.  The	value must not be neg-
		 ative.	 This resource also specifies whether a	drag should be
		 started and the  number  of  pixels  to  start	 a  drag  when
		 Btn2Down and Btn1Down are integrated.

       XmNvalue	 Specifies the string value of the TextField widget as a char*
		 data value.  Moves the	cursor to position 0 unless a value of
		 XmNcursorPosition  was	 explicitly  supplied  in the argument
		 list.	If XmNvalue and	 XmNvalueWcs  are  both	 defined,  the
		 value of XmNvalueWcs supersedes that of XmNvalue. XtGetValues
		 returns a copy	of the value of	the internal buffer and	XtSet-
		 Values	copies the string values into the internal buffer.

       XmNvalueChangedCallback
		 Specifies  the	list of	callbacks that is called after text is
		 deleted from or inserted into TextField.   The	 type  of  the
		 structure  whose address is passed to this callback is	XmAny-
		 CallbackStruct.   The	reason	sent  by   the	 callback   is
		 XmCR_VALUE_CHANGED.  The XmNvalueChangedCallback should occur
		 only in pairs with a XmNmodifyVerifyCallback,	assuming  that
		 the doit flag in the callback structure of the	XmNmodifyVeri-
		 fyCallback is not set to False.

       XmNvalueWcs
		 Specifies the string value  of	 the  TextField	 widget	 as  a
		 wchar_t* data value.  Moves the cursor	to position 0 unless a
		 value of XmNcursorPosition was	explicitly supplied in the ar-
		 gument	list.

		 This resource cannot be specified in a	resource file.

		 If  XmNvalue  and  XmNvalueWcs	are both defined, the value of
		 XmNvalueWcs supersedes	that of	XmNvalue.  XtGetValues returns
		 a  copy of the	value of the internal buffer encoded as	a wide
		 character string. XtSetValues copies the value	 of  the  wide
		 character string into the internal buffer.

       XmNverifyBell
		 Specifies  whether  a	bell  will sound when an action	is re-
		 versed	during a verification callback.	 The  default  depends
		 on  the value of the ancestor VendorShell's XmNaudibleWarning
		 resource.

   Inherited Resources
       TextField widget	inherits behavior and resources	from the  superclasses
       in  the	following  tables.   For  a  complete description of these re-
       sources,	refer to the reference page for	that superclass.

       +---------------------------------------------------------------------------------------------------+
       |			|	     XmPrimitive|Resource Set	   |			  |	   |
       |Name			| Class			| Type		   | Default		  | Access |
       +------------------------+-----------------------+------------------+----------------------+--------+
       |XmNbottomShadowColor	| XmCBottomShadowColor	| Pixel		   | dynamic		  | CSG	   |
       +------------------------+-----------------------+------------------+----------------------+--------+
       |XmNbottomShadowPixmap	| XmCBottomShadowPixmap	| Pixmap	   | XmUNSPECIFIED_PIXMAP | CSG	   |
       +------------------------+-----------------------+------------------+----------------------+--------+
       |XmNconvertCallback	| XmCCallback		| XtCallbackList   | NULL		  | C	   |
       +------------------------+-----------------------+------------------+----------------------+--------+
       |XmNforeground		| XmCForeground		| Pixel		   | dynamic		  | CSG	   |
       +------------------------+-----------------------+------------------+----------------------+--------+
       |XmNhelpCallback		| XmCCallback		| XtCallbackList   | NULL		  | C	   |
       +------------------------+-----------------------+------------------+----------------------+--------+
       |XmNhighlightColor	| XmCHighlightColor	| Pixel		   | dynamic		  | CSG	   |
       +------------------------+-----------------------+------------------+----------------------+--------+
       |XmNhighlightOnEnter	| XmCHighlightOnEnter	| Boolean	   | False		  | CSG	   |
       +------------------------+-----------------------+------------------+----------------------+--------+
       |XmNhighlightPixmap	| XmCHighlightPixmap	| Pixmap	   | dynamic		  | CSG	   |
       +------------------------+-----------------------+------------------+----------------------+--------+
       |XmNhighlightThickness	| XmCHighlightThickness	| Dimension	   | 2			  | CSG	   |
       +------------------------+-----------------------+------------------+----------------------+--------+
       |XmNlayoutDirection	| XmCLayoutDirection	| XmDirection	   | dynamic		  | CG	   |
       +------------------------+-----------------------+------------------+----------------------+--------+
       |XmNnavigationType	| XmCNavigationType	| XmNavigationType | XmTAB_GROUP	  | CSG	   |
       +------------------------+-----------------------+------------------+----------------------+--------+
       |XmNpopupHandlerCallback	| XmCCallback		| XtCallbackList   | NULL		  | C	   |
       +------------------------+-----------------------+------------------+----------------------+--------+
       |XmNshadowThickness	| XmCShadowThickness	| Dimension	   | 2			  | CSG	   |
       +------------------------+-----------------------+------------------+----------------------+--------+
       |XmNtopShadowColor	| XmCTopShadowColor	| Pixel		   | dynamic		  | CSG	   |
       +------------------------+-----------------------+------------------+----------------------+--------+
       |XmNtopShadowPixmap	| XmCTopShadowPixmap	| Pixmap	   | dynamic		  | CSG	   |
       +------------------------+-----------------------+------------------+----------------------+--------+
       |XmNtraversalOn		| XmCTraversalOn	| Boolean	   | True		  | CSG	   |
       +------------------------+-----------------------+------------------+----------------------+--------+
       |XmNunitType		| XmCUnitType		| unsigned char	   | dynamic		  | CSG	   |
       +------------------------+-----------------------+------------------+----------------------+--------+
       |XmNuserData		| XmCUserData		| XtPointer	   | NULL		  | CSG	   |
       +------------------------+-----------------------+------------------+----------------------+--------+
       +------------------------+-----------------------+------------------+----------------------+--------+
       +---------------------------------------------------------------------------------------------------------------+
       |			      |		      Core Resource SetName			      |	Class			      |	Type	       | Default	      |	Access |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNaccelerators		      |	XmCAccelerators		      |	XtAccelerators | dynamic	      |	CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNancestorSensitive	      |	XmCSensitive		      |	Boolean	       | dynamic	      |	G      |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNbackground		      |	XmCBackground		      |	Pixel	       | dynamic	      |	CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNbackgroundPixmap	      |	XmCPixmap		      |	Pixmap	       | XmUNSPECIFIED_PIXMAP |	CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNborderColor		      |	XmCBorderColor		      |	Pixel	       | XtDefaultForeground  |	CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNborderPixmap		      |	XmCPixmap		      |	Pixmap	       | XmUNSPECIFIED_PIXMAP |	CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNborderWidth		      |	XmCBorderWidth		      |	Dimension      | 0		      |	CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNcolormap		      |	XmCColormap		      |	Colormap       | dynamic	      |	CG     |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNdepth		      |	XmCDepth		      |	int	       | dynamic	      |	CG     |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNdestroyCallback	      |	XmCCallback		      |	XtCallbackList | NULL		      |	C      |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNheight		      |	XmCHeight		      |	Dimension      | dynamic	      |	CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNinitialResourcesPersistent |	XmCInitialResourcesPersistent |	Boolean	       | True		      |	C      |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNmappedWhenManaged	      |	XmCMappedWhenManaged	      |	Boolean	       | True		      |	CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNscreen		      |	XmCScreen		      |	Screen *       | dynamic	      |	CG     |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNsensitive		      |	XmCSensitive		      |	Boolean	       | True		      |	CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNtranslations		      |	XmCTranslations		      |	XtTranslations | dynamic	      |	CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNwidth		      |	XmCWidth		      |	Dimension      | dynamic	      |	CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNx			      |	XmCPosition		      |	Position       | 0		      |	CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNy			      |	XmCPosition		      |	Position       | 0		      |	CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       +------------------------------+-------------------------------+----------------+----------------------+--------+
   Callback Information
       A pointer to the	following structure is passed to each callback:

       typedef struct
       {
	       int reason;
	       XEvent *	event;
       } XmAnyCallbackStruct;

       reason	 Indicates why the callback was	invoked

       event	 Points	to the XEvent that triggered the callback

       The TextField widget defines a new callback structure for use with ver-
       ification  callbacks.  Note that	not all	of the fields are relevant for
       every callback reason. The application must first look  at  the	reason
       field and use only the structure	members	that are valid for the partic-
       ular reason.  The values	startPos, endPos, and  text  in	 the  callback
       structure XmTextVerifyCallbackStruct may	be modified upon receiving the
       callback, and these changes will	be reflected as	the change made	to the
       source  of  the	TextField  widget. (For	example, all keystrokes	can be
       converted to spaces or NULL characters when a password is entered  into
       a  TextField  widget.)  The application programmer should not overwrite
       the text	field, but should attach data to that pointer.

       A pointer to the	following structure is passed  to  the	callbacks  for
       XmNlosingFocusCallback,	XmNmodifyVerifyCallback,  and XmNmotionVerify-
       Callback.

       typedef struct
       {
	       int reason;
	       XEvent *event;
	       Boolean doit;
	       XmTextPosition currInsert, newInsert;
	       XmTextPosition startPos,	endPos;
	       XmTextBlock text;
       } XmTextVerifyCallbackStruct, *XmTextVerifyPtr;

       reason	 Indicates why the callback was	invoked.

       event	 Points	to the XEvent the triggered the	callback.  It  can  be
		 NULL.	For  example, changes made to the Text widget program-
		 matically do not have an event	that can be passed to the  as-
		 sociated callback.

       doit	 Indicates  whether  the action	that invoked the callback will
		 be performed.	Setting	doit  to  False	 negates  the  action.
		 Note  that  not  all  actions	may  be	 negated. For example,
		 XmCR_LOSING_FOCUS callbacks may be beyond the control of  the
		 widget	if they	are produced by	mouse clicks.

       currInsert
		 Indicates the current position	of the insert cursor.

       newInsert Indicates the position	at which the user attempts to position
		 the insert cursor.

       startPos	 Indicates the starting	position of the	text to	modify.	If the
		 callback is not a modify verification callback, this value is
		 the same as currInsert.

       endPos	 Indicates the ending position of the text to  modify.	If  no
		 text  is  replaced  or	deleted, then the value	is the same as
		 startPos. If the callback is not a modify verification	 call-
		 back, this value is the same as currInsert.

       text	 Points	 to  the  following  structure of type XmTextBlockRec.
		 This structure	holds the textual information to be inserted.

       typedef struct
       {
	       char *ptr;
	       int length;
	       XmTextFormat format
       } XmTextBlockRec, *XmTextBlock;

	      ptr	The text to be inserted. ptr  points  to  a  temporary
			storage	 space	that  is  reused after the callback is
			finished. Therefore, if	an application needs  to  save
			the  text to be	inserted, it should copy the text into
			its own	data space.

	      length	Specifies the length of	the text to be inserted.

	      format	Specifies the format of	the text,  either  XmFMT_8_BIT
			or XmFMT_16_BIT.

       A pointer to the	following structure is passed to callbacks for XmNmod-
       ifyVerifyCallbackWcs.

       typedef struct
       {
	       int reason;
	       XEvent *event;
	       Boolean doit;
	       XmTextPosition currInsert, newInsert;
	       XmTextPosition startPos,	endPos;
	       XmWcsTextBlock text;
       } XmTextVerifyCallbackStructWcs,	*XmTextVerifyPtrWcs;

       reason	 Indicates why the callback was	invoked.

       event	 Points	to the XEvent that triggered the callback.  It can  be
		 NULL.	For  example, changes made to the Text widget program-
		 matically do not have an event	that can be passed to the  as-
		 sociated callback.

       doit	 Indicates  whether  the  action  that invoked the callback is
		 performed.  Setting doit to False negates the	action.	  Note
		 that  not  all	actions	may be negated.	For example, XmCR_LOS-
		 ING_FOCUS callbacks may be beyond the control of  the	widget
		 if they are produced by mouse clicks.

       currInsert
		 Indicates the current position	of the insert cursor.

       newInsert Indicates the position	at which the user attempts to position
		 the insert cursor.

       startPos	 Indicates the starting	position of the	text to	modify.	If the
		 callback is not a modify verification callback, this value is
		 the same as currInsert.

       endPos	 Indicates the ending position of the text to  modify.	If  no
		 text  is replaced or deleted, the value is the	same as	start-
		 Pos. If the callback is not a modify  verification  callback,
		 this value is the same	as currInsert.

       text	 Points	 to the	following structure of type XmTextBlockRecWcs.
		 This structure	holds the textual information to be inserted.

       typedef struct
       {
	       wchar_t *wcsptr;
	       int length;
       } XmTextBlockRecWcs, *XmTextBlockWcs;

	      wcsptr	Points to the wide character text to be	inserted

	      length	Specifies the number of	characters to be inserted

       The following table describes the reasons for which the individual ver-
       ification  callback  structure  fields  are  valid. Note	that the event
       field will never	be valid for XmCR_MOVING_INSERT_CURSOR.

       +--------------------------+-------------------------------------+
       |Reason			  | Valid Fields			|
       +--------------------------+-------------------------------------+
       |XmCR_LOSING_FOCUS	  | reason, event, doit			|
       +--------------------------+-------------------------------------+
       |XmCR_MODIFYING_TEXT_VALUE | reason,  event,  doit,  currInsert,	|
       |			  | newInsert, startPos, endPos, text	|
       +--------------------------+-------------------------------------+
       |XmCR_MOVING_INSERT_CURSOR | reason, doit, currInsert, newInsert	|
       +--------------------------+-------------------------------------+
       +--------------------------+-------------------------------------+
       A  pointer to the following callback structure is passed	to the XmNdes-
       tinationCallback	procedures:

       typedef struct
       {
	       int reason;
	       XEvent *event;
	       Atom selection;
	       XtEnum operation;
	       int flags;
	       XtPointer transfer_id;
	       XtPointer destination_data;
	       XtPointer location_data;
	       Time time;
       } XmDestinationCallbackStruct;

       reason	 Indicates why the callback was	invoked.

       event	 Points	to the XEvent that triggered the callback.  It can  be
		 NULL.

       selection Indicates  the	selection for which data transfer is being re-
		 quested.  Possible values are CLIPBOARD, PRIMARY,  SECONDARY,
		 and _MOTIF_DROP.

       operation Indicates the type of transfer	operation requested.

		    o  When  the  selection  is	PRIMARY	or SECONDARY, possible
		       values are XmMOVE, XmCOPY, and XmLINK.

		    o  When the	selection is CLIPBOARD,	 possible  values  are
		       XmCOPY and XmLINK.

		    o  When  the selection is _MOTIF_DROP, possible values are
		       XmMOVE,	XmCOPY,	 XmLINK,  and  XmOTHER.	  A  value  of
		       XmOTHER means that the callback procedure must get fur-
		       ther information	from the  XmDropProcCallbackStruct  in
		       the destination_data member.

       flags	 Indicates  whether  or	not the	destination widget is also the
		 source	of the data to be transferred.	Following are the pos-
		 sible values:

		 XmCONVERTING_NONE
			   The	destination  widget  is	 not the source	of the
			   data	to be transferred.

		 XmCONVERTING_SAME
			   The destination widget is the source	of the data to
			   be transferred.

       transfer_id
		 Serves	as a unique ID to identify the transfer	transaction.

       destination_data
		 Contains  information about the destination.  When the	selec-
		 tion is _MOTIF_DROP, the callback procedures  are  called  by
		 the  drop  site's  XmNdropProc,  and  destination_data	 is  a
		 pointer to the	XmDropProcCallbackStruct passed	 to  the  XmN-
		 dropProc  procedure.  When the	selection is SECONDARY,	desti-
		 nation_data is	an Atom	representing a target recommmended  by
		 the  selection	 owner	for  use  in converting	the selection.
		 Otherwise, destination_data is	NULL.

       location_data
		 Contains information about the	location where data is	to  be
		 transferred.	The value is always NULL when the selection is
		 CLIPBOARD.  If	the value is NULL, the data is to be  inserted
		 at  the  widget's cursor position.  Otherwise,	the value is a
		 pointer to an XPoint structure	containing the x and y coordi-
		 nates	at  the	 location where	the data is to be transferred.
		 Once XmTransferDone procedures	 start	to  be	called,	 loca-
		 tion_data will	no longer be stable.

       time	 Indicates the time when the transfer operation	began.

   Translations
       The  XmTextField	translations are described in the following list.  The
       actions represent the effective behavior	of the associated events,  and
       they may	differ in a right-to-left language environment.

       The following key names are listed in the X standard key	event transla-
       tion table syntax.  This	format is the one used by Motif	to specify the
       widget  actions	corresponding to a given key.  A brief overview	of the
       format is provided under	VirtualBindings(3).  For a  complete  descrip-
       tion  of	the format, please refer to the	X Toolkit Instrinsics Documen-
       tation.

       ~c s ~m ~a <Btn1Down>:
		 extend-start()

       c ~s ~m ~a <Btn1Down>:
		 move-destination()

       ~c ~s ~m	~a <Btn1Down>:
		 grab-focus()

       ~c ~m ~a	<Btn1Motion>:
		 extend-adjust()

       ~c ~m ~a	<Btn1Up>:
		 extend-end()

       <Btn2Down>:
		 process-bdrag()

       m ~a <Btn2Motion>:
		 secondary-adjust()

       ~m a <Btn2Motion>:
		 secondary-adjust()

       s c <Btn2Up>:
		 link-to()

       ~s <Btn2Up>:
		 copy-to()

       ~c <Btn2Up>:
		 move-to()

       :m <Key><osfPrimaryPaste>:
		 cut-primary()

       :a <Key><osfPrimaryPaste>:
		 cut-primary()

       :<Key><osfPrimaryPaste>:
		 copy-primary()

       :m <Key><osfCut>:
		 cut-primary()

       :a <Key><osfCut>:
		 cut-primary()

       :<Key><osfCut>:
		 cut-clipboard()

       :<Key><osfPaste>:
		 paste-clipboard()

       :m <Key><osfCopy>:
		 copy-primary()

       :a <Key><osfCopy>:
		 copy-primary()

       :<Key><osfCopy>:
		 copy-clipboard()

       :s <Key><osfBeginLine>:
		 beginning-of-line(extend)

       :<Key><osfBeginLine>:
		 beginning-of-line()

       :s <Key><osfEndLine>:
		 end-of-line(extend)

       :<Key><osfEndLine>:
		 end-of-line()

       :s <Key><osfPageLeft>:
		 page-left(extend)

       :<Key><osfPageLeft>:
		 page-left()

       :s c<Key><osfPageUp>:
		 page-left(extend)

       :c <Key><osfPageUp>:
		 page-left()

       :s <Key><osfPageRight>:
		 page-right(extend)

       :<Key><osfPageRight>:
		 page-right()

       s c <Key><osfPageDown>:
		 page-right(extend)

       :c <Key><osfPageDown>:
		 page-right()

       :<Key><osfClear>:
		 clear-selection()

       :<Key><osfBackSpace>:
		 delete-previous-character()

       :s m <Key><osfDelete>:
		 cut-primary()

       :s a <Key><osfDelete>:
		 cut-primary()

       :s <Key><osfDelete>:
		 cut-clipboard()

       :c <Key><osfDelete>:
		 delete-to-end-of-line()

       :<Key><osfDelete>:
		 delete-next-character()

       :c m <Key><osfInsert>:
		 copy-primary()

       :c a <Key><osfInsert>:
		 copy-primary()

       :s <Key><osfInsert>:
		 paste-clipboard()

       :c <Key><osfInsert>:
		 copy-clipboard()

       :<Key><osfInsert>:
		 toggle-overstrike()

       :s <Key><osfSelect>:
		 key-select()

       :<Key><osfSelect>:
		 set-anchor()

       :<Key><osfSelectAll>:
		 select-all()

       :<Key><osfDeselectAll>:
		 deselect-all()

       :<Key><osfActivate>:
		 activate()

       :<Key><osfAddMode>:
		 toggle-add-mode()

       :<Key><osfHelp>:
		 Help()

       :<Key><osfCancel>:
		 process-cancel()

       :s c <Key><osfLeft>:
		 backward-word(extend)

       :c <Key><osfLeft>:
		 backward-word()

       :s <Key><osfLeft>:
		 key-select(left)

       :<Key><osfLeft>:
		 backward-character()

       :s c <Key><osfRight>:
		 forward-word(extend)

       :c <Key><osfRight>:
		 forward-word()

       :s <Key><osfRight>:
		 key-select(right)

       :<Key><osfRight>:
		 forward-character()

       :<Key><osfUp>:
		 traverse-prev()

       :<Key><osfDown>:
		 traverse-next()

       c ~m ~a <Key>slash:
		 select-all()

       c ~m ~a <Key>backslash:
		 deselect-all()

       s ~m ~a <Key>Tab:
		 prev-tab-group()

       ~m ~a <Key>Tab:
		 next-tab-group()

       ~s ~m ~a	<Key>Return:
		 activate()

       c ~s ~m ~a <Key>space:
		 set-anchor()

       c s ~m ~a <Key>space:
		 key-select()

       s ~c ~m ~a <Key>space:
		 self-insert()

       <Key>:	 self-insert()

       The TextField button event translations are modified when Display's Xm-
       NenableBtn1Transfer  resource  does not have a value of XmOFF (in other
       words, it is either XmBUTTON2_TRANSFER or XmBUTTON2_ADJUST).  This  op-
       tion  allows the	actions	for selection and transfer to be integrated on
       <Btn1>.	The actions for	<Btn1> that are	defined	above still apply when
       the  <Btn1>  event occurs over text that	is not selected. The following
       actions apply when the <Btn1> event occurs over text that is selected:

       <Btn1Down>:
		 process-bdrag().

       <Shift><Btn1Down>:
		 process-bdrag().

       <Btn1Down><Shift><Btn1Up>:
		 grab-focus(), extend-end.

       <Shift><Btn1Down><Shift><Btn1Up>:
		 extend-start(), extend-end().

       <Ctrl><Btn1Down><Shift><Btn1Up>:
		 move-destination().

       <Ctrl><Btn1Down>:
		 process-bdrag().

       When Display's XmNenableBtn1Transfer resource has  a  value  of	XmBUT-
       TON2_ADJUST, the	following actions apply:

       <Btn2Down>:
		 extend-start().

       <Btn2Motion>:
		 extend-adjust().

       <Btn2Up>: extend-end().

   Action Routines
       The XmTextField action routines are

       activate():
		 Calls	the  callbacks for XmNactivateCallback.	 If the	parent
		 is a manager, passes the event	to the parent.

       backward-character(extend):
		 Moves the insertion cursor one	character to the  left.	  This
		 action	 may  have  different behavior in a right-to-left lan-
		 guage environment.

		 If called with	an argument of	extend,	 moves	the  insertion
		 cursor	 as in the case	of no argument and extends the current
		 selection.

		 The backward-character() action produces calls	to the	XmNmo-
		 tionVerifyCallback  procedures	 with  reason  value XmCR_MOV-
		 ING_INSERT_CURSOR.  If	called with the	extend	argument,  the
		 backward-character() action may produce calls to the XmNgain-
		 PrimaryCallback procedures.   See  callback  description  for
		 more information.

       backward-word(extend):
		 If  this  action is called with no argument, moves the	inser-
		 tion cursor to	the first non-whitespace character  after  the
		 first whitespace character to the left	or after the beginning
		 of the	line.  If the insertion	cursor is already at  the  be-
		 ginning  of  a	word, moves the	insertion cursor to the	begin-
		 ning of the previous word.  This action  may  have  different
		 behavior in a locale other than the C locale.

		 If  called  with  an  argument	of extend, moves the insertion
		 cursor	as in the case of no argument and extends the  current
		 selection.

		 The  backward-word()  action produces calls to	the XmNmotion-
		 VerifyCallback	procedures with	reason	value  XmCR_MOVING_IN-
		 SERT_CURSOR.	If  called with	the extend argument, the back-
		 ward-word() action may	produce	 calls	to  the	 XmNgainPrima-
		 ryCallback procedures.	 See callback description for more in-
		 formation.

       beginning-of-line(extend):
		 If this action	is called with no argument, moves  the	inser-
		 tion cursor to	the beginning of the line.

		 If  called  with  an  argument	of extend, moves the insertion
		 cursor	as in the case of no argument and extends the  current
		 selection.

		 The  beginning-of-line()  action produces calls to the	XmNmo-
		 tionVerifyCallback with reason	value  XmCR_MOVING_INSERT_CUR-
		 SOR.	If  called with	the extend argument, the beginning-of-
		 line()	action may produce calls to the	XmNgainPrimaryCallback
		 procedures.  See callback description for more	information.

       clear-selection():
		 Clears	 the current selection by replacing each character ex-
		 cept <Return> with a <space> character.

		 The clear-selection() action produces calls to	 the  XmNmodi-
		 fyVerifyCallback  procedures  with  reason value XmCR_MODIFY-
		 ING_TEXT_VALUE	 and  the  XmNvalueChangedCallback  procedures
		 with reason value XmCR_VALUE_CHANGED.

       copy-clipboard():
		 If this widget	owns the primary selection, this action	copies
		 the selection to the clipboard.  This action calls  the  XmN-
		 convertCallback  procedures, possibly multiple	times, for the
		 CLIPBOARD selection.

       copy-primary():
		 Copies	the primary selection to  just	before	the  insertion
		 cursor.   This	action calls the XmNdestinationCallback	proce-
		 dures for the PRIMARY selection and the XmCOPY	operation.  It
		 calls	the  selection	owner's	XmNconvertCallback procedures,
		 possibly multiple times, for the PRIMARY selection.

		 In addition, the copy-primary() action	produces calls to  the
		 XmNmodifyVerifyCallback    procedures	 with	reason	 value
		 XmCR_MODIFYING_TEXT_VALUE, the	 XmNvalueChangedCallback  with
		 reason	value XmCR_VALUE_CHANGED, and the XmNmotionVerifyCall-
		 back procedures with reason value  XmCR_MOVING_INSERT_CURSOR.
		 The  copy-primary()  action may produce calls to the XmNgain-
		 PrimaryCallback procedures.   See  callback  description  for
		 more information.

       copy-to():
		 If  a secondary selection exists, this	action copies the sec-
		 ondary	selection to the insertion position of the destination
		 component.   If  the  primary selection is in the destination
		 widget, it will be deselected.	Otherwise, there is no	effect
		 on the	primary	selection.

		 This  action  calls  the destination's	XmNdestinationCallback
		 procedures for	the SECONDARY selection	and the	XmCOPY	opera-
		 tion.	The destination's XmNdestinationCallback procedures or
		 the  destination  component  itself  invokes  the   selection
		 owner's   XmNconvertCallback  procedures,  possibly  multiple
		 times,	for the	SECONDARY selection.

		 If no secondary selection exists, this	action copies the pri-
		 mary  selection  to  the pointer position.  This action calls
		 the XmNdestinationCallback procedures for the PRIMARY	selec-
		 tion  and  the	 XmCOPY	 operation.   It  calls	 the selection
		 owner's  XmNconvertCallback  procedures,  possibly   multiple
		 times,	for the	PRIMARY	selection.

		 In  addition, the copy-to() action produces calls to the XmN-
		 modifyVerifyCallback procedures with reason value  XmCR_MODI-
		 FYING_TEXT_VALUE, the XmNvalueChangedCallback procedures with
		 reason	value XmCR_VALUE_CHANGED, and the XmNmotionVerifyCall-
		 back  procedures with reason value XmCR_MOVING_INSERT_CURSOR.
		 If there is no	secondary selection, the copy-to() action  may
		 produce  calls	to the XmNgainPrimaryCallback procedures.  See
		 callback description for more information.

       cut-clipboard():
		 If this widget	owns the primary selection, this  action  cuts
		 the  selection	 to the	clipboard.  This action	calls the XmN-
		 convertCallback procedures, possibly multiple times, for  the
		 CLIPBOARD selection.  If the transfer is successful, this ac-
		 tion then calls the  XmNconvertCallback  procedures  for  the
		 CLIPBOARD selection and the DELETE target.

		 In addition, the cut-clipboard() action produces calls	to the
		 XmNmodifyVerifyCallback   procedures	with   reason	 value
		 XmCR_MODIFYING_TEXT_VALUE,  and  the  XmNvalueChangedCallback
		 procedures with reason	value XmCR_VALUE_CHANGED.

       cut-primary():
		 Cuts the primary selection and	pastes it just before the  in-
		 sertion cursor.  This action calls the	XmNdestinationCallback
		 procedures for	the PRIMARY selection and  the	XmMOVE	opera-
		 tion.	It calls the selection owner's XmNconvertCallback pro-
		 cedures, possibly multiple times, for the PRIMARY  selection.
		 If the	transfer is successful,	this action then calls the se-
		 lection owner's XmNconvertCallback procedures for the PRIMARY
		 selection and the DELETE target.

		 In  addition,	the cut-primary() action produces calls	to the
		 XmNmotionVerifyCallback   procedures	with   reason	 value
		 XmCR_MOVING_INSERT_CURSOR, the	XmNmodifyVerifyCallback	proce-
		 dures with reason value  XmCR_MODIFYING_TEXT_VALUE,  and  the
		 XmNvalueChangedCallback    procedures	 with	reason	 value
		 XmCR_VALUE_CHANGED.

       delete-next-character():
		 In normal mode, if there is a nonnull selection, deletes  the
		 selection; otherwise, deletes the character following the in-
		 sertion cursor.  In add mode, if there	is  a  nonnull	selec-
		 tion,	the cursor is not disjoint from	the selection and XmN-
		 pendingDelete is set to True, deletes the  selection;	other-
		 wise,	deletes	 the character following the insertion cursor.
		 This may impact the selection.

		 The delete-next-character() action produces calls to the XmN-
		 modifyVerifyCallback  procedures with reason value XmCR_MODI-
		 FYING_TEXT_VALUE, and the XmNvalueChangedCallback  procedures
		 with reason value XmCR_VALUE_CHANGED.

       delete-next-word():
		 In  normal mode, if there is a	nonnull	selection, deletes the
		 selection; otherwise, deletes the  characters	following  the
		 insertion  cursor to the next space, tab or end-of-line char-
		 acter.	 In add	mode, if there is  a  nonnull  selection,  the
		 cursor	 is  not  disjoint  from  the  selection  and XmNpend-
		 ingDelete is set to True, deletes the	selection;  otherwise,
		 deletes  the characters following the insertion cursor	to the
		 next space, tab or end-of-line	character.   This  may	impact
		 the  selection.  This action may have different behavior in a
		 locale	other than the C locale.

		 The delete-next-word()	action produces	calls to the  XmNmodi-
		 fyVerifyCallback  procedures  with  reason value XmCR_MODIFY-
		 ING_TEXT_VALUE, and  the  XmNvalueChangedCallback  procedures
		 with reason value XmCR_VALUE_CHANGED.

       delete-previous-character():
		 In  normal mode, if there is a	nonnull	selection, deletes the
		 selection; otherwise, deletes the character of	 text  immedi-
		 ately	preceding the insertion	cursor.	 In add	mode, if there
		 is a nonnull selection, the cursor is not disjoint  from  the
		 selection  and	 XmNpendingDelete  is set to True, deletes the
		 selection; otherwise, deletes the character of	 text  immedi-
		 ately	preceding  the	insertion cursor.  This	may impact the
		 selection.

		 The delete-previous-character() action	produces calls to  the
		 XmNmodifyVerifyCallback    procedures	 with	reason	 value
		 XmCR_MODIFYING_TEXT_VALUE, the	XmNvalueChangedCallback	proce-
		 dures	with  reason  value XmCR_VALUE_CHANGED,	and the	XmNmo-
		 tionVerifyCallback procedures	with  reason  value  XmCR_MOV-
		 ING_INSERT_CURSOR.

       delete-previous-word():
		 In  normal mode, if there is a	nonnull	selection, deletes the
		 selection; otherwise, deletes the  characters	preceding  the
		 insertion  cursor to the next space, tab or beginning-of-line
		 character.  In	add mode, if there is a	nonnull	selection, the
		 cursor	 is  not  disjoint  from  the  selection  and XmNpend-
		 ingDelete is set to True, deletes the	selection;  otherwise,
		 deletes  the characters preceding the insertion cursor	to the
		 next space, tab or beginning-of-line character.  This may im-
		 pact  the selection.  This action may have different behavior
		 in a locale other than	the C locale.

		 The delete-previous-word() action produces calls to the  XmN-
		 modifyVerifyCallback  procedures with reason value XmCR_MODI-
		 FYING_TEXT_VALUE, the XmNvalueChangedCallback procedures with
		 reason	value XmCR_VALUE_CHANGED, and the XmNmotionVerifyCall-
		 back procedures with reason value XmCR_MOVING_INSERT_CURSOR.

       delete-selection():
		 Deletes the current selection.

		 The delete-selection()	action produces	calls to the  XmNmodi-
		 fyVerifyCallback  procedures  with  reason value XmCR_MODIFY-
		 ING_TEXT_VALUE, the XmNvalueChangedCallback  procedures  with
		 reason	value XmCR_VALUE_CHANGED, and the XmNmotionVerifyCall-
		 back procedures with reason value XmCR_MOVING_INSERT_CURSOR.

       delete-to-end-of-line():
		 In normal mode, if there is a nonnull selection, deletes  the
		 selection;  otherwise,	 deletes  the characters following the
		 insertion cursor to the next end of line character.   In  add
		 mode, if there	is a nonnull selection,	the cursor is not dis-
		 joint from the	selection and XmNpendingDelete is set to True,
		 deletes the selection;	otherwise, deletes the characters fol-
		 lowing	the insertion cursor to	the next end of	 line  charac-
		 ter.  This may	impact the selection.

		 The delete-to-end-of-line() action produces calls to the XmN-
		 modifyVerifyCallback procedures with reason value  XmCR_MODI-
		 FYING_TEXT_VALUE,  and	the XmNvalueChangedCallback procedures
		 with reason value XmCR_VALUE_CHANGED.

       delete-to-start-of-line():
		 In normal mode, if there is a nonnull selection, deletes  the
		 selection;  otherwise,	 deletes  the characters preceding the
		 insertion cursor to the previous beginning-of-line character.
		 In  add  mode,	if there is a nonnull selection, the cursor is
		 not disjoint from the selection and XmNpendingDelete  is  set
		 to  True, deletes the selection; otherwise, deletes the char-
		 acters	preceding the insertion	cursor to the previous	begin-
		 ning-of-line character.  This may impact the selection.

		 The  delete-to-start-of-line()	 action	 produces calls	to the
		 XmNmodifyVerifyCallback   procedures	with   reason	 value
		 XmCR_MODIFYING_TEXT_VALUE, the	XmNvalueChangedCallback	proce-
		 dures with reason value XmCR_VALUE_CHANGED,  and  the	XmNmo-
		 tionVerifyCallback  procedures	 with  reason  value XmCR_MOV-
		 ING_INSERT_CURSOR.

       deselect-all():
		 Deselects the current selection.

		 The deselect-all() action produces no callbacks.

       end-of-line(extend):
		 If this action	is called with no argument, moves  the	inser-
		 tion  cursor to the end of the	line.  If called with an argu-
		 ment of extend, moves the insertion cursor as in the case  of
		 no argument and extends the current selection.

		 The end-of-line() action produces calls to the	XmNmotionVeri-
		 fyCallback  procedures	 with  reason  value   XmCR_MOVING_IN-
		 SERT_CURSOR.  If called with the extend argument, the end-of-
		 line()	action may produce calls to the	XmNgainPrimaryCallback
		 procedures.  See callback description for more	information.

       extend-adjust():
		 Selects text from the anchor to the pointer position and des-
		 elects	text outside that range.

		 The extend-adjust() action produces calls to  the  XmNmotion-
		 VerifyCallback	 procedures  with reason value XmCR_MOVING_IN-
		 SERT_CURSOR.  The extend-adjust() action may produce calls to
		 the XmNgainPrimaryCallback procedures.	 See callback descrip-
		 tion for more information.

       extend-end():
		 Moves the insertion cursor to the position  of	 the  pointer.
		 The  extend-end() action is used to commit the	selection. Af-
		 ter this action  has  been  done,  process-cancel()  will  no
		 longer	cancel the selection.

		 The  extend-end() action produces calls to the	XmNmotionVeri-
		 fyCallback  procedures	 with  reason  value   XmCR_MOVING_IN-
		 SERT_CURSOR.	The  extend-end()  action may produce calls to
		 the XmNgainPrimaryCallback procedures.	 See callback descrip-
		 tion for more information.

       extend-start():
		 Adjusts  the  anchor  using the balance-beam method.  Selects
		 text from the anchor to the pointer  position	and  deselects
		 text outside that range.

		 The  extend-start() action can	produce	no callbacks, however,
		 it may	produce	calls to the XmNgainPrimaryCallback and	XmNmo-
		 tionVerifyCallback  procedures.  See callback description for
		 more information.

       forward-character(extend):
		 Moves the insertion cursor one	character to the right.	  This
		 action	 may  have  different behavior in a right-to-left lan-
		 guage environment.

		 If called with	an argument of	extend,	 moves	the  insertion
		 cursor	 as in the case	of no argument and extends the current
		 selection.

		 The forward-character() action	produces calls to  the	XmNmo-
		 tionVerifyCallback  procedures	 with  reason  value XmCR_MOV-
		 ING_INSERT_CURSOR.  If	called with the	extend	argument,  the
		 forward-character()  action may produce calls to the XmNgain-
		 PrimaryCallback procedures.   See  callback  description  for
		 more information.

       forward-word(extend):
		 If  this  action is called with no argument, moves the	inser-
		 tion cursor to	the first whitespace character or  end-of-line
		 following  the	 next non-whitespace character.	 If the	inser-
		 tion cursor is	already	at the end of a	word, moves the	inser-
		 tion  cursor  to  the	end of the next	word.  This action may
		 have different	behavior in a locale other than	the C locale.

		 If called with	an argument of	extend,	 moves	the  insertion
		 cursor	 as in the case	of no argument and extends the current
		 selection.

		 The forward-word() action produces calls to the XmNmotionVer-
		 ifyCallback  procedures  with	reason	value  XmCR_MOVING_IN-
		 SERT_CURSOR.  If called with the extend  argument,  the  for-
		 ward-word()  action  may  produce  calls to the XmNgainPrima-
		 ryCallback procedures.	 See callback description for more in-
		 formation.

       grab-focus():
		 This key binding performs the action defined in the XmNselec-
		 tionArray, depending on the number of multiple	mouse  clicks.
		 The default selection array ordering is one click to move the
		 insertion cursor to the pointer position, two clicks  to  se-
		 lect  a  word,	 and three clicks to select a line of text.  A
		 single	click also deselects any selected text	and  sets  the
		 anchor	at the pointer position.  This action may have differ-
		 ent behavior in a locale other	than the C locale.

		 The grab-focus() action produces calls	to the	XmNmotionVeri-
		 fyCallback   procedures  with	reason	value  XmCR_MOVING_IN-
		 SERT_CURSOR.

       Help():	 Calls the callbacks for XmNhelpCallback  if  any  exist.   If
		 there	are  no	 help  callbacks  for this widget, this	action
		 calls the help	callbacks for the nearest  ancestor  that  has
		 them.

       key-select(right|left):
		 If called with	an argument of right, moves the	insertion cur-
		 sor one character to the right	and extends the	current	selec-
		 tion.	 If  called with an argument of	left, moves the	inser-
		 tion cursor one character to the left and extends the current
		 selection.   If  called with no argument, extends the current
		 selection.

		 Note that after a key-select action, the selection will still
		 begin at the original anchor, and will	extend to the position
		 indicated in the action call. If this new position is on  the
		 opposite  side	 of the	selection anchor from the previous se-
		 lection boundary, the original	selection will be deselected.

		 The key-select() action produces calls	to the	XmNmotionVeri-
		 fyCallback   procedures  with	reason	value  XmCR_MOVING_IN-
		 SERT_CURSOR.  The key-select()	action may also	produce	 calls
		 to  the  XmNgainPrimaryCallback procedures.  See callback de-
		 scription for more information.

       link-primary():
		 Places	a link to the primary selection	just before the	inser-
		 tion  cursor.	 This  action calls the	XmNdestinationCallback
		 procedures for	the PRIMARY selection and  the	XmLINK	opera-
		 tion.	The TextField widget itself performs no	transfers; the
		 XmNdestinationCallback	procedures are responsible for insert-
		 ing  the link to the primary selection	and for	taking any re-
		 lated actions.

       link-to():
		 If a secondary	selection exists, this action places a link to
		 the secondary selection at the	insertion position of the des-
		 tination component.  This action calls	the destination's XmN-
		 destinationCallback  procedures  for  the SECONDARY selection
		 and the XmLINK	operation.

		 If no secondary selection exists, this	action places  a  link
		 to  the  primary selection at the pointer position.  This ac-
		 tion calls the	XmNdestinationCallback procedures for the PRI-
		 MARY selection	and the	XmLINK operation.

		 The  TextField	 widget	itself performs	no transfers; the XmN-
		 destinationCallback procedures	are responsible	for  inserting
		 the link to the primary or secondary selection	and for	taking
		 any related actions.

       move-destination():
		 Moves the insertion cursor to the  pointer  position  without
		 changing  any existing	current	selection.  If there is	a cur-
		 rent selection, sets the widget as  the  destination  widget.
		 This  also moves the widget focus to match the	insertion cur-
		 sor.

		 The move-destination()	action produces	calls  to  the	XmNmo-
		 tionVerifyCallback  procedures	 with  reason  value XmCR_MOV-
		 ING_INSERT_CURSOR.

       move-to():
		 If a secondary	selection exists, this action moves  the  sec-
		 ondary	selection to the insertion position of the destination
		 component.  If	the secondary selection	is in the  destination
		 widget, and the secondary selection and the primary selection
		 overlap, the result is	undefined.  This action	calls the des-
		 tination's  XmNdestinationCallback  procedures	 for  the SEC-
		 ONDARY	selection and the XmCOPY operation.  The destination's
		 XmNdestinationCallback	 procedures  or	the destination	compo-
		 nent itself invokes the selection owner's  XmNconvertCallback
		 procedures, possibly multiple times, for the SECONDARY	selec-
		 tion.	If the transfer	is successful, this action then	 calls
		 the  selection	 owner's XmNconvertCallback procedures for the
		 SECONDARY selection and the DELETE target.

		 If no secondary selection exists, this	action moves the  pri-
		 mary  selection  to  the pointer position.  This action calls
		 the XmNdestinationCallback procedures for the PRIMARY	selec-
		 tion  and  the	 XmMOVE	 operation.   It  calls	 the selection
		 owner's  XmNconvertCallback  procedures,  possibly   multiple
		 times,	 for  the  PRIMARY selection.  If the transfer is suc-
		 cessful, this action then calls the selection owner's XmNcon-
		 vertCallback  procedures  for	the  PRIMARY selection and the
		 DELETE	target.

		 In addition, the move-to() action produces calls to the  XmN-
		 modifyVerifyCallback  procedures with reason value XmCR_MODI-
		 FYING_TEXT_VALUE, the XmNvalueChangedCallback procedures with
		 reason	value XmCR_VALUE_CHANGED, and the XmNmotionVerifyCall-
		 back procedures with reason value  XmCR_MOVING_INSERT_CURSOR.
		 This action may also produce calls to the XmNgainPrimaryCall-
		 back procedures.

       next-tab-group():
		 Traverses to the next tab group.

		 The next-tab-group() action produces no callbacks, unless  it
		 results  in  the widget losing	focus, in which	case, the XmN-
		 losingFocusCallback procedures	are called with	 reason	 value
		 XmCR_LOSING_FOCUS.

       page-left():
		 Scrolls the viewing window left one page of text.

		 The page-left() action	produces no callbacks.

       page-right():
		 Scrolls the viewing window right one page of text.

		 The page-right() action produces no callbacks.

       paste-clipboard():
		 Pastes	 the  contents	of  the	clipboard before the insertion
		 cursor.  This action calls the	XmNdestinationCallback	proce-
		 dures for the CLIPBOARD selection and the XmCOPY operation.

		 The  paste-clipboard()	 action	produces calls to the XmNmodi-
		 fyVerifyCallback procedures with  reason  value  XmCR_MODIFY-
		 ING_TEXT_VALUE,  the  XmNvalueChangedCallback procedures with
		 reason	value XmCR_VALUE_CHANGED, and the XmNmotionVerifyCall-
		 back procedures with reason value XmCR_MOVING_INSERT_CURSOR.

       prev-tab-group():
		 Traverses to the previous tab group.

		 The  prev-tab-group() action produces no callbacks, unless it
		 results in the	widget losing focus, in	which case,  the  XmN-
		 losingFocusCallback  procedures  are called with reason value
		 XmCR_LOSING_FOCUS.

       process-bdrag()
		 If the	pointer	is within the selection, this action starts  a
		 drag  operation for the selection.  This action sets the XmN-
		 convertProc of	the DragContext	to a function that  calls  the
		 XmNconvertCallback  procedures,  possibly multiple times, for
		 the _MOTIF_DROP selection.

		 If no selection exists	or the pointer is outside  the	selec-
		 tion,	this action prepares to	start a	secondary selection at
		 the pointer position.

       process-cancel():
		 Cancels the current  extend-adjust(),	secondary-adjust()  or
		 process-bdrag()  operation  and leaves	the selection state as
		 it was	before the operation; otherwise, and if	the parent  is
		 a manager, it passes the event	to the parent.

       secondary-adjust():
		 Extends the secondary selection to the	pointer	position.

		 The secondary-adjust()	action produces	no callbacks.

       secondary-start():
		 Marks the beginning of	a secondary selection.

		 The secondary-start() action produces no callbacks.

       select-all():
		 Selects all text.

		 The select-all() action can produce no	callbacks, however, it
		 may produce calls to the  XmNgainPrimaryCallback  and	XmNmo-
		 tionVerifyCallback  procedures.  See callback description for
		 more information.

       self-insert():
		 If XmNpendingDelete is	True and the cursor  is	 not  disjoint
		 from  the  current  selection,	 deletes the entire selection.
		 Inserts the character associated with the key pressed	before
		 the insertion cursor.

		 The self-insert() action produces calls to the	XmNmodifyVeri-
		 fyCallback  procedures	  with	 reason	  value	  XmCR_MODIFY-
		 ING_TEXT_VALUE,  the  XmNvalueChangedCallback procedures with
		 reason	value XmCR_VALUE_CHANGED, and the XmNmotionVerifyCall-
		 back procedures with reason value XmCR_MOVING_INSERT_CURSOR.

       set-anchor():
		 Resets	 the anchor point for extended selections.  Resets the
		 destination of	secondary selection actions.

		 The set-anchor() action produces no callbacks.

       toggle-add-mode():
		 Toggles the state of Add Mode.

		 The toggle-add-mode() action produces no callbacks.

       toggle-overstrike():
		 Toggles the state of the text	insertion  mode.  By  default,
		 characters  typed  into the TextField widget are inserted be-
		 fore the position of  the  insertion  cursor.	In  overstrike
		 mode,	characters  entered  into the TextField	widget replace
		 the characters	that directly follow the insertion cursor.  In
		 overstrike  mode,  when the end of a line is reached, charac-
		 ters are appended to the end of the line.

		 The following traversal actions generate no callbacks	unless
		 they  result  in the loss of focus by the widget in question,
		 as when XmNnavigationType is XmNONE. In this case, they  pro-
		 duce  calls  to  the  XmNlosingFocusCallback procedures, with
		 reason	value XmCR_FOCUS_MOVED.

       traverse-home():
		 Traverses to the first	widget in the tab group.

       traverse-next():
		 Traverses to the next widget in the tab group.

       traverse-prev():
		 Traverses to the previous widget in the tab group.

   Additional Behavior
       This widget has the following additional	behavior:

       <FocusIn>:
		 Draws the insertion cursor as solid and starts	 blinking  the
		 cursor.

       <FocusOut>:
		 Displays  the insertion cursor	as a stippled I-beam unless it
		 is the	destination widget.

   Virtual Bindings
       The bindings for	virtual	keys are  vendor  specific.   For  information
       about bindings for virtual buttons and keys, see	VirtualBindings(3).

RELATED
       Core(3),	XmCreateTextField(3), XmFontList(3), XmFontListAppendEntry(3),
       XmPrimitive(3), XmTextFieldClearSelection(3),  XmTextFieldCopy(3),  Xm-
       TextFieldCopyLink(3), XmTextFieldCut(3),	XmTextFieldGetBaseline(3), Xm-
       TextFieldGetEditable(3),	   XmTextFieldGetInsertionPosition(3),	   Xm-
       TextFieldGetLastPosition(3),  XmTextFieldGetMaxLength(3),  XmTextField-
       GetSelection(3),	XmTextFieldGetSelectionPosition(3),  XmTextFieldGetSe-
       lectionWcs(3), XmTextFieldGetString(3), XmTextFieldGetStringWcs(3), Xm-
       TextFieldGetSubstring(3), XmTextFieldGetSubstringWcs(3),	XmTextFieldIn-
       sert(3),	  XmTextFieldInsertWcs(3),  XmTextFieldPaste(3),  XmTextField-
       PasteLink(3), XmTextFieldPosToXY(3), XmTextFieldRemove(3), XmTextField-
       Replace(3),   XmTextFieldReplaceWcs(3),	XmTextFieldSetAddMode(3),  Xm-
       TextFieldSetEditable(3),	   XmTextFieldSetHighlight(3),	  XmTextField-
       SetInsertionPosition(3),	 XmTextFieldSetMaxLength(3), XmTextFieldSetSe-
       lection(3),  XmTextFieldSetString(3),  XmTextFieldSetStringWcs(3),  Xm-
       TextFieldShowPosition(3),       XmTextFieldXYToPos(3),	   XmVaCreate-
       TextField(3), and XmVaCreateManagedTextField(3).

								XmTextField(3)

NAME | SYNOPSIS | DESCRIPTION | RELATED

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=XmTextField&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help