TmTCSext(3Tm)							 TmTCSext(3Tm)

NAME    [Toc]    [Back]

     TmCSText -	the CSText widget class

SYNOPSIS    [Toc]    [Back]

     xmCSText  pathName	[options]

DESCRIPTION    [Toc]    [Back]

     This is the tcl binding to	the Motif Compound String Text (CSText)
     widget.  This widget is only available from Motif 2.0 on.

CLASSES    [Toc]    [Back]

     The class name for	resource files is XmCSText. Resources are inherited
     from TmPrimitive, TmCore. Methods are inherited from TmCore.

     THE REST OF THIS REFERS TO	TEXT - UPDATE

RESOURCES    [Toc]    [Back]

     The new resources are

	  autoShowCursorPosition
	  cursorPosition
	  editable
	  editMode br marginHeight
	  marginWidth
	  maxLength
	  source
	  topCharacter
	  value
	  valueWCS
	  verifyBell

     editable
	  The values for this resource are
	       true
	       false
     editMode The values for this resource are
	       single_line_edit
	       multi_line_edit

METHODS    [Toc]    [Back]

     New methods for this class	are
	  activateCallback
	  focusCallback
	  gainPrimaryCallback
	  losePrimaryCallback
	  losingFocusCallback
	  modifyVerifyCallback
	  motionVerifyCallback



									Page 1






TmTCSext(3Tm)							 TmTCSext(3Tm)



	  valueChangedCallback
	  clearSelection
	  copy
	  cut
	  disableRedisplay
	  enableRedisplay
	  findString
	  getEditable
	  getInsertionPosition
	  getSelection
	  getSelectionPosition
	  getString
	  getSubstring
	  getTopCharacter
	  insert
	  paste
	  replace
	  remove
	  scroll
	  setAddMode
	  setEditable
	  setHighlight
	  setInsertionPosition
	  setSelection
	  setSource
	  setString
	  setTopCharacter
	  showPosition


     clearSelection
	  clears the primary selection


     copy copies the primary selection to the clipboard


     cut  copies the primary selection to the clipboard	and deletes the
	  selected text.


     findString	 start string direction	position
	  searches for the string in the specified direction starting from the
	  given	start. The possible values of direction	are  forward or
	  backward.  The method	returns	 true  or  false  if the string	is
	  found	or not found. If it is found, the location of the first
	  character of the string (counting from 0) is returned	in the tcl
	  variable position.







									Page 2






TmTCSext(3Tm)							 TmTCSext(3Tm)



     getEditable
	  returns  true	or  false indicating whether or	not the	widget can be
	  edited.


     getInsertionPosition
	  returns the location of the insertion	cursor.


     getLastPosition
	  returns the last position in the text.


     getSelection
	  returns the value of the primary selection.


     getSelectionPosition  left	right
	  returns  true	f the widget owns the primary selection, else returns
	  false.  The left and right positions of the primary selection	are
	  returned in the tcl variables
	   left	 and  right.


     getString
	  returns the value in the widget.


     getSubstring  start num_chars buffer
	  stores the substring in the tcl variable buffer. The method returns
	  succeded,  failed or	truncated.


     getTopCharacter
	  returns the position of the first character displayed.


     insert  position text
	  inserts the  text into the widget at	position.


     paste
	  insert the clipboard selection.


     replace  from to value
	  replaces the text with the new  value.


     scroll  lines
	  scroll the text widget. A negative number of lines scrolls downward.




									Page 3






TmTCSext(3Tm)							 TmTCSext(3Tm)



     setAddMode	 boolean
	  sets the add mode of the text	widget.


     setEditable  boolean
	  set the editable state of the	widget.


     setHighlight   left right mode
	  set the highlight mode for the text between the positions to one of
	  the  highlight values	of
	   normal selected secondary_selected.


     setInsertionPosition  position
	  set the location of the insertion cursor.


     setSelection  first last
	  set the primary selection of the text	to between the positions.


     setSource	widget top position
	  sets the source of the current text widget to	be the same as
	   widget and specifies	where the top display and where	the insertion
	  cursor are.


     setString	value
	  sets the text	value.


     setTopCharacter  top
	  sets the top position	of the text display.


     showPosition  position
	  force	the text at the	 position to be	displayed.

CALLBACK SUBSTITUTIONS    [Toc]    [Back]

     The substitutions supported for this class	are
	  %reason  - the additional values are
	       activate
	       focus
	       gain_primary
	       lose_primary
	       modifying_text_value
	       moving_insert_cursor
	       value_changed
	  %doit	- the tcl variable to set to true or false to allow changes
	  %currInsert -	current	position of the	insertion cursor



									Page 4






TmTCSext(3Tm)							 TmTCSext(3Tm)



	  %newInsert - position	to which cursor	move is	attempted
	  %startPos - itcl variable with starting position of text to modify
	  %endPos - tcl	variable with end position of text to modify
	  %ptr - tcl variable with text	to be inserted
	  %length - tcl	variable with length of	text to	be inserted

AUTHOR    [Toc]    [Back]

     Jan Newmarch, University of Canberra


									PPPPaaaaggggeeee 5555