RedHat 9 (Linux i386) - man page for xmtextfield (redhat section 3)

Linux & Unix Commands - Search Man Pages

Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


XmTextField(library call)						XmTextField(library call)

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 pro-
       grammatic interfaces. It is used for single-line string entry, and forms entry with  veri-
       fication procedures.  It provides an application with a consistent editing system for tex-
       tual data.

       TextField provides separate callback lists to verify movement of the insert cursor,  modi-
       fication  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  structure specific to the verification type. From this information, the function can
       verify if the application considers this to be a legitimate 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 selection of text.

       TextField allows the user to select regions of text.  Selection	is  based  on  the  model
       specified  in  the  Inter-Client Communication Conventions Manual (ICCCM).  TextField sup-
       ports primary and secondary selection.

       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 XmQTaccessTextual, then
       XmTextField will call XmTextFieldSetString to set the string value.

   Data Transfer Behavior
       TextField supports transfer of the primary, secondary, and clipboard selections and  drag-
       ging of selected text from the widget.  TextField can also be the destination for the pri-
       mary, 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 XmCon-
       vertCallbackStruct 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  associated  conversions
       of data to these targets:

       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 encoding 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 clipboard immediately.	These include the
		 following targets:

		    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, BACKGROUND, 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 procedures.

		    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 indicate that the widget is no longer the
		       destination.

       As a source of data, TextField also supports the following standard Motif 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 win-
		 dow 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, and TEXT.

       TIMESTAMP The  widget  transfers the timestamp used to acquire the selection as type INTE-
		 GER.

       _MOTIF_RENDER_TABLE
		 The widget transfers XmNrenderTable if it exists, or else the default text  ren-
		 der 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  symbol-
		 izes  the  transfer target for the Motif Segment Encoding Registry.  Widgets and
		 applications can use this Registry to register text encoding formats for  speci-
		 fied  render  table tags.  Applications access this Registry by calling XmRegis-
		 terSegmentEncoding and XmMapSegmentEncoding.

       As a destination for data, TextField chooses a  target  and  requests  conversion  of  the
       selection  to that target.  If the encoding of the locale is present in the list of avail-
       able targets, TextField chooses a requested target from the available targets in the  fol-
       lowing order of preference:

	  1. TEXT

	  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 targets in the following  order  of  prefer-
       ence:

	  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 programmer to specify
       data. The programmer can also set the resource values 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 access column indicate if the given resource can be set at cre-
       ation 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 invisible (that is, the time it will take to blink the inser-
		 tion  cursor  on  and off will be two times the blink rate). The cursor 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  charac-
		 ters.	The width equals the number of characters specified by this resource mul-
		 tiplied 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  ancestors  (that  is,  the
		 widget  was  created  on  a  print  server connection) 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 structure whose address is passed to these
		 callbacks is XmDestinationCallbackStruct.  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 XmAnyCallback-
		 Struct. 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  compatibility  with  earlier  releases  of
		 Motif. Use the render table (XmNrenderTable) instead of font lists wherever pos-
		 sible. 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  default  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 ownership	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 call-
		 back reason for this callback is XmCR_LOSE_PRIMARY.

       XmNlosingFocusCallback
		 Specifies  the  list  of callbacks that are called before TextField widget loses
		 input focus.  The type of the structure whose address is passed to this callback
		 is  XmTextVerifyCallbackStruct.   The	reason	sent by the callback is XmCR_LOS-
		 ING_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 nonnegative.  Strings that are entered
		 using the XmNvalue resource or the  XmTextFieldSetString  function  ignore  this
		 resource.

       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 XmTextVerifyCallbackStruct.  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 XmN-
		 modifyVerifyCallback.

		 If both XmNmodifyVerifyCallback and  XmNmodifyVerifyCallbackWcs  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
		 XmTextVerifyCallbackStructWcs.  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 XmNmodifyVerifyCall-
		 backWcs.

		 If both XmNmodifyVerifyCallback and  XmNmodifyVerifyCallbackWcs  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 insert cursor is moved
		 to a new position.  The type of the structure whose address is  passed  to  this
		 callback  is  XmTextVerifyCallbackStruct.   The  reason  sent by the callback is
		 XmCR_MOVING_INSERT_CURSOR.  It is possible for more  than  one  XmNmotionVerify-
		 Callbacks to be generated from a single action.

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

       XmNrenderTable
		 Specifies the render table to be used in deriving a font set or  font	for  dis-
		 playing  text.  If both a render table and a font list are specified, the render
		 table will take precedence. If the value of XmNrenderTable is NULL  at  initial-
		 ization,  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 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 table 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 accommo-
		 date 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 defined action for that index. (This "multi-click" time is spec-
		 ified	by the operating environment, and varies among different systems. In gen-
		 eral, it is usually set to some fraction 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	XmNselectionArray
		 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 negative.  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 sup-
		 plied	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 XtSetValues 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 XmAnyCallbackStruct.	 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 XmNmodifyVerifyCallback 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  explic-
		 itly supplied in the argument list.

		 This resource cannot be specified in a resource file.

		 If  XmNvalue  and  XmNvalueWcs are both defined, the value of XmNvalueWcs super-
		 sedes 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 reversed during a  verifi-
		 cation 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 resources, 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 Set 	       |		      |        |
       |Name			      | 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 verification 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  particular	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  XmNlosingFocusCall-
       back, XmNmodifyVerifyCallback, and XmNmotionVerifyCallback.

       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 programmatically do not have an event	that  can
		 be passed to the associated callback.

       doit	 Indicates  whether the action that invoked the callback will be performed.  Set-
		 ting 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 callback, 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 XmNmodifyVerifyCallback-
       Wcs.

       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 programmatically do not have an event that can
		 be passed to the associated 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_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, the value is the same as startPos. If the callback is not a modify ver-
		 ification 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 verification callback
       structure fields are valid. Note that the event field will never be  valid  for	XmCR_MOV-
       ING_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 XmNdestinationCallback pro-
       cedures:

       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 requested.  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 further information from the XmDropProcCallbackStruct in the des-
		       tination_data member.

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

		 XmCONVERTING_NONE
			   The	destination  widget  is  not  the source of the data to be trans-
			   ferred.

		 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 selection is  _MOTIF_DROP,
		 the  callback procedures are called by the drop site's XmNdropProc, and destina-
		 tion_data is a pointer to the XmDropProcCallbackStruct passed to the XmNdropProc
		 procedure.   When the selection is SECONDARY, destination_data is an Atom repre-
		 senting 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 coordinates at the loca-
		 tion  where  the data is to be transferred. Once XmTransferDone procedures start
		 to be called, location_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 translation  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  description  of the format, please refer to the X Toolkit Instrinsics Documenta-
       tion.

       ~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  XmNenableBtn1Transfer
       resource  does  not have a value of XmOFF (in other words, it is either XmBUTTON2_TRANSFER
       or XmBUTTON2_ADJUST). This option 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 XmBUTTON2_ADJUST, the follow-
       ing 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 dif-
		 ferent behavior in a right-to-left language 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 XmNmotionVerifyCallback
		 procedures with reason value  XmCR_MOVING_INSERT_CURSOR.   If	called	with  the
		 extend  argument,  the backward-character() action may produce calls to the XmN-
		 gainPrimaryCallback procedures.  See callback description for more information.

       backward-word(extend):
		 If this action is called with no argument, moves the  insertion  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
		 beginning of a word, moves the insertion cursor to the beginning 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 XmNmotionVerifyCallback  proce-
		 dures	with  reason  value XmCR_MOVING_INSERT_CURSOR.	If called with the extend
		 argument, the backward-word() action may  produce  calls  to  the  XmNgainPrima-
		 ryCallback procedures.  See callback description for more information.

       beginning-of-line(extend):
		 If  this  action  is  called with no argument, moves the insertion 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 XmNmotionVerifyCallback
		 with reason value XmCR_MOVING_INSERT_CURSOR.  If called with  the  extend  argu-
		 ment,	the  beginning-of-line()  action  may  produce calls to the XmNgainPrima-
		 ryCallback procedures.  See callback description for more information.

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

		 The  clear-selection() action produces calls to the XmNmodifyVerifyCallback pro-
		 cedures with reason value XmCR_MODIFYING_TEXT_VALUE and the XmNvalueChangedCall-
		 back 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	XmNconvertCallback  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 procedures 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  XmNmodifyVerify-
		 Callback  procedures  with  reason  value XmCR_MODIFYING_TEXT_VALUE, the XmNval-
		 ueChangedCallback with reason value XmCR_VALUE_CHANGED, and the XmNmotionVerify-
		 Callback  procedures with reason value XmCR_MOVING_INSERT_CURSOR.  The copy-pri-
		 mary() action may produce calls to the XmNgainPrimaryCallback	procedures.   See
		 callback description for more information.

       copy-to():
		 If  a	secondary selection exists, this action copies the secondary 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 operation.	The destination's XmNdestination-
		 Callback procedures or the destination component itself  invokes  the	selection
		 owner's  XmNconvertCallback  procedures,  possibly  multiple times, for the SEC-
		 ONDARY selection.

		 If no secondary selection exists, this action copies the  primary  selection  to
		 the  pointer  position.  This action calls the XmNdestinationCallback procedures
		 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-to() action produces calls to the  XmNmodifyVerifyCallback
		 procedures with reason value XmCR_MODIFYING_TEXT_VALUE, the XmNvalueChangedCall-
		 back procedures with reason value XmCR_VALUE_CHANGED, and  the  XmNmotionVerify-
		 Callback procedures with reason value XmCR_MOVING_INSERT_CURSOR.  If there is no
		 secondary selection, the copy-to() action may produce calls to the XmNgainPrima-
		 ryCallback 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 XmNconvertCallback procedures, possibly multi-
		 ple  times,  for  the	CLIPBOARD selection.  If the transfer is successful, this
		 action then calls the XmNconvertCallback procedures for the CLIPBOARD	selection
		 and the DELETE target.

		 In  addition,	the cut-clipboard() action produces calls to the XmNmodifyVerify-
		 Callback procedures with reason value XmCR_MODIFYING_TEXT_VALUE, and the XmNval-
		 ueChangedCallback procedures with reason value XmCR_VALUE_CHANGED.

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

		 In addition, the cut-primary() action produces calls to the XmNmotionVerifyCall-
		 back  procedures with reason value XmCR_MOVING_INSERT_CURSOR, the XmNmodifyVeri-
		 fyCallback procedures with reason value XmCR_MODIFYING_TEXT_VALUE, and the  XmN-
		 valueChangedCallback procedures with reason value XmCR_VALUE_CHANGED.

       delete-next-character():
		 In  normal  mode, if there is a nonnull selection, deletes the selection; other-
		 wise, deletes the character following 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 following the insertion cursor.  This may impact the selection.

		 The delete-next-character() action produces calls to the XmNmodifyVerifyCallback
		 procedures with reason value XmCR_MODIFYING_TEXT_VALUE, and the XmNvalueChanged-
		 Callback procedures with reason value XmCR_VALUE_CHANGED.

       delete-next-word():
		 In  normal  mode, if there is a nonnull selection, deletes the selection; other-
		 wise, deletes the characters following the insertion cursor to the  next  space,
		 tab or end-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 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 XmNmodifyVerifyCallback pro-
		 cedures  with	reason	value XmCR_MODIFYING_TEXT_VALUE, and the XmNvalueChanged-
		 Callback procedures with reason value XmCR_VALUE_CHANGED.

       delete-previous-character():
		 In normal mode, if there is a nonnull selection, deletes the  selection;  other-
		 wise,	deletes the character of text immediately 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; other-
		 wise, deletes the character of text immediately preceding the insertion  cursor.
		 This may impact the selection.

		 The  delete-previous-character()  action  produces calls to the XmNmodifyVerify-
		 Callback procedures with reason  value  XmCR_MODIFYING_TEXT_VALUE,  the  XmNval-
		 ueChangedCallback  procedures with reason value XmCR_VALUE_CHANGED, and the XmN-
		 motionVerifyCallback procedures with reason value XmCR_MOVING_INSERT_CURSOR.

       delete-previous-word():
		 In normal mode, if there is a nonnull selection, deletes the  selection;  other-
		 wise,	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  selec-
		 tion,	the cursor is not disjoint from the selection and XmNpendingDelete 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 impact 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 XmNmodifyVerifyCallback
		 procedures with reason value XmCR_MODIFYING_TEXT_VALUE, the XmNvalueChangedCall-
		 back  procedures  with reason value XmCR_VALUE_CHANGED, and the XmNmotionVerify-
		 Callback procedures with reason value XmCR_MOVING_INSERT_CURSOR.

       delete-selection():
		 Deletes the current selection.

		 The delete-selection() action produces calls to the XmNmodifyVerifyCallback pro-
		 cedures with reason value XmCR_MODIFYING_TEXT_VALUE, the XmNvalueChangedCallback
		 procedures with reason value XmCR_VALUE_CHANGED, and the XmNmotionVerifyCallback
		 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; other-
		 wise, 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
		 disjoint from the selection and XmNpendingDelete is set  to  True,  deletes  the
		 selection;  otherwise,  deletes the characters following the insertion cursor to
		 the next end of line character.  This may impact the selection.

		 The delete-to-end-of-line() action produces calls to the XmNmodifyVerifyCallback
		 procedures with reason value XmCR_MODIFYING_TEXT_VALUE, and the XmNvalueChanged-
		 Callback procedures with reason value XmCR_VALUE_CHANGED.

       delete-to-start-of-line():
		 In normal mode, if there is a nonnull selection, deletes the  selection;  other-
		 wise,	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 characters preceding the insertion
		 cursor  to the previous beginning-of-line character.  This may impact the selec-
		 tion.

		 The delete-to-start-of-line() action produces calls to the  XmNmodifyVerifyCall-
		 back	procedures  with  reason  value  XmCR_MODIFYING_TEXT_VALUE,  the  XmNval-
		 ueChangedCallback procedures with reason value XmCR_VALUE_CHANGED, and the  XmN-
		 motionVerifyCallback procedures with reason value XmCR_MOVING_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 insertion cursor to the end
		 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  end-of-line()  action  produces calls to the XmNmotionVerifyCallback proce-
		 dures with reason value XmCR_MOVING_INSERT_CURSOR.  If called	with  the  extend
		 argument,  the end-of-line() action may produce calls to the XmNgainPrimaryCall-
		 back procedures.  See callback description for more information.

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

		 The  extend-adjust() action produces calls to the XmNmotionVerifyCallback proce-
		 dures with reason value XmCR_MOVING_INSERT_CURSOR.  The  extend-adjust()  action
		 may  produce  calls  to  the  XmNgainPrimaryCallback  procedures.   See callback
		 description 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.	After  this action has been done,
		 process-cancel() will no longer cancel the selection.

		 The extend-end() action produces calls to the XmNmotionVerifyCallback procedures
		 with  reason  value XmCR_MOVING_INSERT_CURSOR.  The extend-end() action may pro-
		 duce calls to the XmNgainPrimaryCallback procedures.  See  callback  description
		 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 XmNmotionVerifyCallback 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 language 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  XmNmotionVerifyCallback
		 procedures  with  reason  value  XmCR_MOVING_INSERT_CURSOR.   If called with the
		 extend argument, the forward-character() action may produce calls  to	the  XmN-
		 gainPrimaryCallback procedures.  See callback description for more information.

       forward-word(extend):
		 If  this  action  is  called with no argument, moves the insertion cursor to the
		 first whitespace character or	end-of-line  following	the  next  non-whitespace
		 character.   If  the insertion cursor is already at the end of a word, moves the
		 insertion 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  XmNmotionVerifyCallback  proce-
		 dures	with  reason  value XmCR_MOVING_INSERT_CURSOR.	If called with the extend
		 argument, the forward-word() action may produce calls to the XmNgainPrimaryCall-
		 back procedures.  See callback description for more information.

       grab-focus():
		 This key binding performs the action defined in the XmNselectionArray, 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
		 select 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 different behavior in a locale other than the C locale.

		 The grab-focus() action produces calls to the XmNmotionVerifyCallback procedures
		 with reason value XmCR_MOVING_INSERT_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 cursor one character to
		 the right and extends the current selection.  If  called  with  an  argument  of
		 left,	moves the insertion cursor one character to the left and extends the cur-
		 rent selection.  If called with no argument, extends the current selection.

		 Note that after a key-select action, the selection will still begin at the orig-
		 inal  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  pre-
		 vious selection boundary, the original selection will be deselected.

		 The key-select() action produces calls to the XmNmotionVerifyCallback procedures
		 with reason value XmCR_MOVING_INSERT_CURSOR.  The key-select() action	may  also
		 produce  calls  to the XmNgainPrimaryCallback procedures.  See callback descrip-
		 tion for more information.

       link-primary():
		 Places a link to the primary selection just before the insertion  cursor.   This
		 action calls the XmNdestinationCallback procedures for the PRIMARY selection and
		 the XmLINK operation.	The TextField widget itself performs  no  transfers;  the
		 XmNdestinationCallback  procedures are responsible for inserting the link to the
		 primary selection and for taking any related actions.

       link-to():
		 If a secondary selection exists, this action places  a  link  to  the	secondary
		 selection  at	the insertion position of the destination component.  This action
		 calls the destination's  XmNdestinationCallback  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 action calls the XmNdestinationCallback
		 procedures for the PRIMARY selection and the XmLINK operation.

		 The  TextField  widget  itself performs no transfers; the XmNdestinationCallback
		 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 current selection, sets the widget as the des-
		 tination  widget.   This also moves the widget focus to match the insertion cur-
		 sor.

		 The move-destination() action produces calls to the XmNmotionVerifyCallback pro-
		 cedures with reason value XmCR_MOVING_INSERT_CURSOR.

       move-to():
		 If  a	secondary  selection exists, this action moves the secondary 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 selec-
		 tion overlap, the result is undefined.  This action calls the destination's XmN-
		 destinationCallback 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 the transfer  is  suc-
		 cessful,  this action then calls the selection owner's XmNconvertCallback proce-
		 dures for the SECONDARY selection and the DELETE target.

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

		 In addition, the move-to() action produces calls to the  XmNmodifyVerifyCallback
		 procedures with reason value XmCR_MODIFYING_TEXT_VALUE, the XmNvalueChangedCall-
		 back procedures with reason value XmCR_VALUE_CHANGED, and  the  XmNmotionVerify-
		 Callback procedures with reason value XmCR_MOVING_INSERT_CURSOR. This action may
		 also produce calls to the XmNgainPrimaryCallback procedures.

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

		 The next-tab-group() action produces no callbacks, unless it results in the wid-
		 get  losing  focus,  in  which  case,	the XmNlosingFocusCallback 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 procedures for the CLIPBOARD selection and the
		 XmCOPY operation.

		 The paste-clipboard() action produces calls to the XmNmodifyVerifyCallback  pro-
		 cedures with reason value XmCR_MODIFYING_TEXT_VALUE, the XmNvalueChangedCallback
		 procedures with reason value XmCR_VALUE_CHANGED, and the XmNmotionVerifyCallback
		 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 wid-
		 get losing focus, in  which  case,  the  XmNlosingFocusCallback  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 XmNconvertProc  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 selection, this action pre-
		 pares to start a secondary selection at the pointer position.

       process-cancel():
		 Cancels the current extend-adjust(), secondary-adjust() or process-bdrag() oper-
		 ation 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 XmNmotionVerifyCallback procedures.	See call-
		 back 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 XmNmodifyVerifyCallback proce-
		 dures with reason value XmCR_MODIFYING_TEXT_VALUE,  the  XmNvalueChangedCallback
		 procedures with reason value XmCR_VALUE_CHANGED, and the XmNmotionVerifyCallback
		 procedures with reason value XmCR_MOVING_INSERT_CURSOR.

       set-anchor():
		 Resets the anchor point for extended selections.  Resets the destination of sec-
		 ondary 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 before 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, characters 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  produce  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),  XmTextFieldCopyLink(3),  XmTextField-
       Cut(3), XmTextFieldGetBaseline(3), XmTextFieldGetEditable(3), XmTextFieldGetInsertionPosi-
       tion(3),  XmTextFieldGetLastPosition(3),  XmTextFieldGetMaxLength(3), XmTextFieldGetSelec-
       tion(3), XmTextFieldGetSelectionPosition(3),  XmTextFieldGetSelectionWcs(3),  XmTextField-
       GetString(3),  XmTextFieldGetStringWcs(3),  XmTextFieldGetSubstring(3), XmTextFieldGetSub-
       stringWcs(3),	XmTextFieldInsert(3),	 XmTextFieldInsertWcs(3),    XmTextFieldPaste(3),
       XmTextFieldPasteLink(3),    XmTextFieldPosToXY(3),    XmTextFieldRemove(3),   XmTextField-
       Replace(3), XmTextFieldReplaceWcs(3), XmTextFieldSetAddMode(3), XmTextFieldSetEditable(3),
       XmTextFieldSetHighlight(3),	 XmTextFieldSetInsertionPosition(3),	  XmTextFieldSet-
       MaxLength(3), XmTextFieldSetSelection(3),  XmTextFieldSetString(3),  XmTextFieldSetString-
       Wcs(3), XmTextFieldShowPosition(3), and XmTextFieldXYToPos(3).

									XmTextField(library call)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 01:49 AM.

Unix & Linux Forums Content Copyright©1993-2018. All Rights Reserved.
×
UNIX.COM Login
Username:
Password:  
Show Password





Not a Forum Member?
Forgot Password?