DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

DtEditor(3)




DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

NAME
     DtEditor -	the DtEditor widget class

SYNOPSIS
     #include <Dt/Editor.h>

DESCRIPTION
     The DtEditor  widget  supports  creating  and  editing  text
     files.    It  gives  applications	running	 in  the  desktop
     environment a consistent method for editing text data.   The
     widget consists of:

	o  A scrolled edit window for text

	o  Dialogs for finding and changing text

	o  Optional status line

	o  Spell checking option

	o  Formatting options

	o  Convenience functions for programmatically controlling
	   the widget

     The DtEditor widget supports  the	following  set	of  basic
     editing operations:

	o  Finding and changing	text

	o  Simple formatting

	o  Spell checking

	o  Undoing the previous	edit operation

     All operations, except for	spell checking,	 support  locales
     with single- and multi-byte characters.

     The DtEditor widget also supports input and output	of  ASCII
     text,  multi-byte	text  and  buffers  of data.  Data can be
     passed between the	application and	the DtEditor widget, or	a
     file and the widget.

     The DtEditor widget  provides  separate  callback	lists  to
     track  when text is selected or deselected.  In addition, it
     extends the standard help callback	to report  help	 requests
     from any of its components.

     Widget subclassing	is not supported for the DtEditor  widget
     class.

Unix System LaboratoLast change: 1 August 1995			1

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

  Edit Window
     The edit window supports basic editing  operations	 such  as
     cut  and paste, find and change, simple formatting	and spell
     checking.

  Mouse	and Keyboard
     The user can use the mouse	to move	the edit  cursor  and  to
     select  portions  of  a  document	for  editing  operations.
     Selection is based	on the	model  specified  in  the  Inter-
     Client Communication Conventions Manual (ICCCM).  The DtEdi-
     tor widget	supports primary and secondary selection.

     The user can cut, copy and	paste text using  the  clipboard,
     primary transfer or secondary transfer.  The DtEditor widget
     accepts drops of text, text files or buffers of data.   Text
     drops  are	 inserted  where  the mouse button is released to
     complete the drop.	 Dropped files and buffers  of	data  are
     placed  at	 the  insertion	cursor.	 The DtEditor widget sup-
     ports dragging of text within the edit window or to  a  dif-
     ferent widget.

     The DtEditor widget provides a set	of translations	 for  the
     edit  window.  The	default	translations provide key bindings
     for moving	the insertion cursor, and deleting, inserting and
     selecting	text.	The  insertion cursor, displayed as an I-
     beam, shows where input is	inserted.  Input is inserted just
     before the	insertion cursor.

  Status Line
     The status	line, which can	be shown or hidden, displays  the
     current line number, total	line count and whether the DtEdi-
     tor widget	is in overstrike mode.	The  current  line-number
     display  shows  the  line	number of the line containing the
     insertion cursor.	The user can go	directly to any	 line  in
     the  document  by	entering the number into the current line
     number display.  The status line also provides a text  field
     for  displaying application-supplied messages.  For informa-
     tion on localizing	the status  line,  see	the  Localization
     Resources section.

  Dialogs
     The DtEditor widget includes dialogs to provide a	graphical
     user interface to its functionality:

	o  Find/Change dialog

	o  Spell dialog.

	o  Format Settings dialog

     The titles	of all dialogs are  controlled	with  the  DtNdi-
     alogTitle	 resource.    All   dialogs   are   posted  using

Unix System LaboratoLast change: 1 August 1995			2

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

     corresponding convenience functions and remain posted  until
     dismissed	by the user.  Each dialog includes Close and Help
     buttons in	addition to buttons described  in  the	following
     lists.  For information on	localizing these dialogs, see the
     Localization Resources section.

     The Find/Change dialog for	the DtEditor widget enables users
     to	 search	for, and optionally replace, a string in the edit
     window.  The dialog includes fields for specifying	the  find
     string  and  the  replacement  string.  Buttons initiate the
     find or change either the next occurrence or all occurrences
     of	the find string	to the replacement string.  When the user
     selects the Find button, the next occurrence of  the  speci-
     fied  string  (regular  expressions  are  not  supported) is
     highlighted in the	DtEditor widget, if found; otherwise, the
     DtEditor widget displays a	message	dialog stating the string
     was not found.  If	the string was found, the  user	 has  the
     option   to   change   the	 highlighted  occurrence  or  all
     occurrences.

     The DtEditorFind(3) and DtEditorChange(3) functions  provide
     a	programmatic interface to the find and change functional-
     ity of the	DtEditor widget.

     The Spell dialog is used to check the contents of	the  edit
     window  for  spelling  errors.   It  consists  of	a list of
     misspelled	words, replacement string field	and the	same  set
     of	 buttons  as  the  Find	dialog.	 Choosing a word from the
     list automatically	selects	it as the find	string.	  Double-
     clicking  on a word searches for the next occurrence of that
     word.  The	list of	misspelled words  is  automatically  gen-
     erated using the filter specified by DtNspellFilter when the
     dialog is displayed.  The actions for find,  change  to  and
     change all	are the	same as	the Find dialog.

     The Format	Settings dialog	for the	DtEditor  widget  enables
     users to format the contents of the edit window, format just
     the paragraph containing the insertion  cursor,  or  specify
     the  arguments  used  when	 formatting  text.  The	arguments
     include margin settings and text alignment.   The	user  has
     the choice	of aligning the	text flush with	the left or right
     margin, centering each line of text between the margins,  or
     aligning  it  flush  with	both margins.  The user	enter the
     left and right margin values into text fields and choose  an
     alignment	option	from  a	 set of	toggle buttons.	 Two push
     buttons allow them	to format the current paragraph	or format
     the complete document.

     The margin	values used for	formatting do not have to be  the
     same  as  the  width  of the edit window.	It is possible to
     format the	text with margin  values  that	are  narrower  or
     wider  than  the  displayed edit window.  By default, values

Unix System LaboratoLast change: 1 August 1995			3

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

     for the format margins are	the current size of the	edit win-
     dow.   If	text  is formatted wider than the edit window and
     the DtNwordWrap resource is True, text wraps  at  the  right
     edge   of	 the   edit   window  (see  the	 description  for
     DtNwordWrap), regardless of the right  margin  setting.   To
     format  text  wider than the edit window, DtNwordWrap should
     be	False.

     The  DtEditorFormat(3)  function  provides	 a   programmatic
     interface	to  the	 format	 functionality	of  the	 DtEditor
     widget.

  Word Wrap and	Formatting
     Word wrap and text	formatting  are	 essentially  independent
     operations.   Word	 wrap  pertains	to the dynamic display of
     lines, as delimited by <newline>  characters,  which  exceed
     the width of the Text Editor window and is	based on the left
     and right window boundaries.  When	word  wrap  mode  is  off
     (the  default),  each  line of text is displayed on a single
     line on the display and text entered  at  the  right  window
     boundary  causes  the  window to scroll automatically to the
     right to accommodate the new text until an	actual	<newline>
     character is entered (normally, by	pressing the Return key).
     When word wrap mode is on,	 lines	longer	than  the  window
     width  are	 automatically wrapped at the right window margin
     to	one or more display lines, and text entered at the  right
     window  boundary  is automatically	broken on a word boundary
     to	the first column of the	next display line.  Word wrap  is
     dynamic   in   that  word-wrapped	lines  are  automatically
     adjusted when text	is inserted or deleted or when the window
     is	resized.  Word wrap only affects the display of	lines; it
     does not actually insert <newline>	characters in the text.

     Text formatting is	a static operation  that  inserts  actual
     <newline>	(and/or	 <space>) characters directly in the text
     to	match it to the	left and right margins (and justification
     mode)  specified in the Format Settings dialog.  Format set-
     tings affect text only when explicitly applied and	 have  no
     affect  on	 word  wrap  or	 previously formatted text.  Ini-
     tially, and whenever the window is	resized, the right format
     margin is automatically set to the	window width to	match the
     word wrap boundary.

  Classes
     The DtEditor widget inherits  behavior  and  resources  from
     Core,  Composite, Constraint, XmManager, XmBulletinBoard and
     XmForm classes.

     The class pointer is dtEditorWidgetClass.

     The class name is DtEditorWidget.

Unix System LaboratoLast change: 1 August 1995			4

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

  New Resources
     The following table defines a set of  widget  resources  the
     application  uses to specify data.	 The application 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,  the	application  must
     remove  the DtN or	DtC prefix and use the remaining letters.
     To	specify	one of the defined values for  a  resource  in	a
     .Xdefaults	 file,	the application	must remove the	Dt prefix
     and use the remaining letters (in either lower case or upper
     case,  but	 including  any	 underscores between words).  The
     codes in the access 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  appli-
     cable (N/A).

				       DtEditor	Resource Set
     _________________________________________________________________________________________
     Name		       Class			 Type		Default		Access
     _________________________________________________________________________________________
     DtNautoShowCursorPosition DtCAutoShowCursorPosition Boolean	True		CSG
     DtNblinkRate	       DtCBlinkRate		 int		500		CSG
     DtNbuttonFontList	       DtCFontList		 XmFontList	dynamic		CSG
     DtNcolumns		       DtCColumns		 XmNcolumns	dynamic		CSG
     DtNcursorPosition	       DtCCursorPosition	 XmTextPosition	0		CSG
     DtNcursorPositionVisible  DtCCursorPositionVisible	 Boolean	True		CSG
     DtNdialogTitle	       DtCDialogTitle		 XmString	NULL		CSG
     DtNeditable	       DtCEditable		 Boolean	True		CSG
     DtNlabelFontList	       DtCFontList		 XmFontList	dynamic		CSG
     DtNmaxLength	       DtCMaxLength		 int		largest	integer	CSG
     DtNoverstrike	       DtCOverstrike		 Boolean	False		CSG
     DtNrows		       DtCRows			 XmNrows	dynamic		CSG
     DtNscrollHorizontal       DtCScroll		 Boolean	True		CG
     DtNscrollLeftSide	       DtCScrollSide		 Boolean	dynamic		CG
     DtNscrollTopSide	       DtCScrollSide		 Boolean	False		CG
     DtNscrollVertical	       DtCScroll		 Boolean	True		CG
     DtNshowStatusLine	       DtCShowStatusLine	 Boolean	False		CSG
     DtNspellFilter	       DtCspellFilter		 char *		spell		CSG
     DtNtextBackground	       DtCBackground		 Pixel		dynamic		CSG
     DtNtextDeselectCallback   DtCCallback		 XtCallbackList	NULL		C
     DtNtextFontList	       DtCFontList		 XmFontList	dynamic		CSG
     DtNtextForeground	       DtCForeground		 Pixel		dynamic		CSG
     DtNtextSelectCallback     DtCCallback		 XtCallbackList	NULL		C
     DtNtextTranslations       DtCTranslations		 XtTranslations	NULL		CS
     DtNtopCharacter	       DtCTextPosition		 XmTextPosition	0		CSG
     DtNwordWrap	       DtCWordWrap		 Boolean	False		CSG
     _________________________________________________________________________________________

	DtNautoShowCursorPosition
	      Ensures that the text visible in the scrolled  edit
	      window contains the insert cursor	when set to True.
	      If the insert cursor changes, the	contents  of  the

Unix System LaboratoLast change: 1 August 1995			5

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

	      DtEditor	widget	may  scroll in order to	bring the
	      insertion	point into the window.

	DtNblinkRate
	      Specifies	the blink rate of the text cursor in mil-
	      liseconds.   The	time  indicated	in the blink rate
	      relates to the time the cursor is	visible	 and  the
	      time  the	cursor is invisible (that is, the time it
	      takes to blink the insertion cursor on and  off  is
	      twice  the  blink	rate).	The cursor does	not blink
	      when the blink rate is set to zero.  The value can-
	      not be negative.

	DtNbuttonFontList
	      Specifies	the font list used for the DtEditor  but-
	      tons  (the  buttons  appearing in	the DtEditor dia-
	      logs).  If this value is NULL at initialization, it
	      is  initialized  by looking up the parent	hierarchy
	      of the widget for	an ancestor that is a subclass of
	      the  XmBulletinBoard,  VendorShell  or  XmMenuShell
	      widget class.  If	such an	ancestor  is  found,  the
	      font list	is initialized to the appropriate default
	      font  list  of  the  ancestor  widget  (XmNdefault-
	      FontList	 for  VendorShell  and	XmMenuShell,  and
	      XmNbuttonFontList	for XmBulletinBoard).  If no such
	      ancestor	is  found,  the	default	is implementation
	      dependent.  Refer	to XmFontList(3X) for more infor-
	      mation  on  the  creation	 and  structure	of a font
	      list.

	DtNcolumns
	      Specifies	the initial width of the edit  window  of
	      the  DtEditor widget as an integral number of char-
	      acters.  The width equals	the number of  characters
	      this  resource  specifies	multiplied by the maximum
	      character	width of the associated	font.	For  pro-
	      portionate  fonts,  the actual number of characters
	      that fit on a given line may be  greater	than  the
	      value  specified.	  The  value must be greater than
	      zero.  The default value depends on  the	value  of
	      the DtNwidth resource.

	DtNcursorPosition
	      Indicates	the position in	the DtEditor widget where
	      the  current  insert cursor is located.  This posi-
	      tion is determined by the	number of characters from
	      the  beginning  of  the  text.  The first	character
	      position is zero.

	DtNcursorPositionVisible
	      When set to True,	this resource specifies	that  the
	      insert cursor position is	marked by a blinking text

Unix System LaboratoLast change: 1 August 1995			6

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

	      cursor.

	DtNdialogTitle
	      Specifies	an XmString that appears as part  of  the
	      titles  for  the	dialogs	displayed by the DtEditor
	      widget.  If this resource	is non-NULL, it	 is  used
	      as  the  prefix  of the titles for the Find/Change,
	      Spell and	Format Settings	dialogs.

	DtNeditable
	      When set to True,	this resource indicates	that  the
	      user can edit the	text; otherwise, it prohibits the
	      user from	editing	the text.

	DtNlabelFontList
	      Specifies	the font list used  for	 the  labels  for
	      DtEditor	(the labels appear in the status line and
	      the DtEditor dialogs).  If this value  is	 NULL  at
	      initialization, it is initialized	by looking up the
	      parent hierarchy of the widget for an ancestor that
	      is  a  subclass of the XmBulletinBoard, VendorShell
	      or XmMenuShell widget class.  If such  an	 ancestor
	      is  found,  the  font  list  is  initialized to the
	      XmNlabelFontList of the  ancestor	 widget.   If  no
	      such  ancestor is	found, the default is implementa-
	      tion dependent.  Refer to	XmFontList(3X)	for  more
	      information on the creation and structure	of a font
	      list.

	DtNmaxLength
	      Specifies	the maximum length  of	the  text  string
	      that  can	 be entered into the DtEditor widget from
	      the keyboard.  This  value  must	be  non-negative.
	      Strings entered using the	DtEditorSetContents(3) or
	      DtEditorSetContentsFromFile(3)   functions   ignore
	      this resource.

	DtNoverstrike
	      When set to False, characters typed into the DtEdi-
	      tor  widget  are	inserted  at  the position of the
	      insertion	cursor.	 This is  the  default	behavior.
	      If  set to True, characters typed	into the DtEditor
	      widget replace the characters that directly  follow
	      the  insertion cursor.  When the end of the line is
	      reached, characters are appended to the end of  the
	      line.   If  the  status  line  is	visible, DtNover-
	      strikeIndicatorLabel appears  in	the  status  line
	      whenever DtNoverstrike is	True.

	DtNrows
	      Specifies	the initial height of the edit window  of
	      the  DtEditor widget measured in character heights.

Unix System LaboratoLast change: 1 August 1995			7

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

	      The value	must be	greater	than zero.

	DtNscrollHorizontal
	      When set to True,	this resource  adds  a	ScrollBar
	      that allows the user to scroll horizontally through
	      text.

	DtNscrollLeftSide
	      When set to True,	this resource indicates	that  the
	      vertical	ScrollBar  should  be  placed on the left
	      side of the scrolled edit	window.	  This	attribute
	      is  ignored  if  DtNscrollVertical  is  False.  The
	      default value  may  depend  on  the  value  of  the
	      XmNstringDirection resource.

	DtNscrollTopSide
	      When set to True,	this resource indicates	that  the
	      horizontal  ScrollBar  should  be	placed on the top
	      side of the scrolled edit	window.	  This	attribute
	      is ignored if DtNscrollHorizontal	is False.

	DtNscrollVertical
	      When set to True,	this resource  adds  a	ScrollBar
	      that  allows  the	user to	scroll vertically through
	      text.

	DtNshowStatusLine
	      When set to True,	the DtEditor  widget  displays	a
	      status line below	the edit window.  The status line
	      contains a field that  displays  the  current  line
	      number  of the insert cursor, total number of lines
	      in the document, and whether the DtEditor	widget is
	      in  overstrike  mode.   The  user	 can enter a line
	      number in	the line number	display	to go directly to
	      that line.

	      The status line also includes a  Motif  Text  Field
	      widget  (XmTextField)  for  displaying  application
	      supplied messages.  This field is	a convenient  way
	      for  an  application to display status and feedback
	      about the	document being edited.	The Text Field ID
	      is   retrieved   using  DtEditorGetMessageTextFiel-
	      dID(3).  A message  is  displayed	 by  setting  the
	      XmNvalue	or  XmNvalueWcs	 resource of this widget.
	      If  the  Text  field  is	not  needed,  it  can  be
	      unmanaged	 by calling XtUnmanageWidget(3X) with its
	      ID.

	DtNspellFilter
	      Specifies	the  filter  used  to  identify	 spelling
	      errors.	The DtEditorInvokeSpellDialog(3) function
	      filters the contents of a	DtEditor  widget  through

Unix System LaboratoLast change: 1 August 1995			8

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

	      the filter specified by DtNspellFilter.  The filter
	      specified	should accept a	file name and  produce	a
	      list  of	misspelled and unrecognized words in this
	      file  on	standard  out.	 The  default  filter  is
	      spell(1).

	DtNtextBackground
	      Specifies	the background of the edit window and the
	      text fields for DtEditor (the text fields	appear in
	      the status line and DtEditor dialogs).

	DtNtextDeselectCallback
	      Specifies	a function called whenever the	selection
	      becomes  NULL  (that is, no text is selected within
	      the edit area).  The reason sent by the callback is
	      DtEDITOR_TEXT_DESELECT.

	DtNtextFontList
	      Specifies	the font list used for	the  edit  window
	      and  the	text fields for	DtEditor (the text fields
	      appear in	the status line	 and  DtEditor	dialogs).
	      If this value is NULL at initialization, it is ini-
	      tialized by looking up the parent	hierarchy of  the
	      widget  for  an  ancestor	that is	a subclass of the
	      XmBulletinBoard or VendorShell  widget  class.   If
	      such  an	ancestor  is found, the	font list is ini-
	      tialized to the  XmNtextFontList	of  the	 ancestor
	      widget.	If no such ancestor is found, the default
	      is    implementation    dependent.     Refer     to
	      XmFontList(3X) for more information on the creation
	      and structure of a font list.

	DtNtextForeground
	      Specifies	the foreground of the edit window and the
	      text fields for DtEditor (the text fields	appear in
	      the status line and DtEditor dialogs).

	DtNtextSelectCallback
	      Specifies	a function called whenever the	selection
	      becomes  non-NULL	 (that	is, some text is selected
	      within the edit area).   The  reason  sent  by  the
	      callback is DtEDITOR_TEXT_SELECT.

	DtNtextTranslations
	      Adds translations	to the edit window.  Translations
	      specified	 with  DtNtextTranslations  override  any
	      duplicate	translations defined for the edit window.

	DtNtopCharacter
	      Displays the line	that  contains	the  position  of
	      text  at	the top	of the scrolled	edit window.  The
	      line is displayed	at the top of the DtEditor widget

Unix System LaboratoLast change: 1 August 1995			9

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

	      without shifting the text	left or	right.	The posi-
	      tion is determined by the	number of characters from
	      the  beginning  of  the  text.  The first	character
	      position is zero.

	      XtGetValues(3X)  for  DtNtopCharacter  returns  the
	      position of the first character in the line that is
	      displayed	at the top of the DtEditor widget.

	DtNwordWrap
	      Indicates	that text not go off the  right	 edge  of
	      the  window,  but	 that  lines  are  broken at word
	      breaks with soft line feeds  when	 they  reach  the
	      right edge of the	window.

	      Word wrap	affects	only the visual	appearance of the
	      contents	of  a  DtEditor	 widget.  The line breaks
	      (soft line feeds)	are not	physically inserted  into
	      the  text.  The DtEditor widget supports substitut-
	      ing <newline>s when the contents of the widget  are
	      retrieved	 or  saved to a	file (see DtEditorGetCon-
	      tents(3) and DtEditorSaveContentsToFile(3)).

  Localization Resources
     The following  table  defines  a  set  of	widget	resources
     designed  for  localization  of  the DtEditor widget and its
     dialogs.  Default values for these	resources depends on  the
     locale.
		       DtEditor	Localization Resource Set
_________________________________________________________________________________
Name			     Class			  Type	   Default Access
_________________________________________________________________________________
DtNcenterToggleLabel	     DtCCenterToggleLabel	  XmString Dynamic CSG
DtNchangeAllButtonLabel	     DtCChangeAllButtonLabel	  XmString Dynamic CSG
DtNchangeButtonLabel	     DtCChangeButtonLabel	  XmString Dynamic CSG
DtNchangeFieldLabel	     DtCChangeFieldLabel	  XmString Dynamic CSG
DtNcurrentLineLabel	     DtCCurrentLineLabel	  XmString Dynamic CSG
DtNfindButtonLabel	     DtCFindButtonLabel		  XmString Dynamic CSG
DtNfindChangeDialogTitle     DtCFindChangeDialogTitle	  XmString Dynamic CSG
DtNfindFieldLabel	     DtCFindFieldLabel		  XmString Dynamic CSG
DtNformatAllButtonLabel	     DtCFormatAllButtonLabel	  XmString Dynamic CSG
DtNformatParagraphButton-    DtCFormatParagraphButton-	  XmString Dynamic CSG
   Label			Label
DtNformatSettingsDialogTitle DtCFormatSettingsDialogTitle XmString Dynamic CSG
DtNinformationDialogTitle    DtCInformationDialogTitle	  XmString Dynamic CSG
DtNjustifyToggleLabel	     DtCJustifyToggleLabel	  XmString Dynamic CSG
DtNleftAlignToggleLabel	     DtCLeftAlignToggleLabel	  XmString Dynamic CSG
DtNleftMarginFieldLabel	     DtCLeftMarginFieldLabel	  XmString Dynamic CSG
DtNmisspelledListLabel	     DtCMisspelledListLabel	  XmString Dynamic CSG
DtNoverstrikeLabel	     DtCOverstrikeLabel		  XmString Dynamic CSG
DtNrightAlignToggleLabel     DtCRightAlignToggleLabel	  XmString Dynamic CSG
DtNrightMarginFieldLabel     DtCRightMarginFieldLabel	  XmString Dynamic CSG

Unix System LaboratoLast change: 1 August 1995		       10

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

DtNspellDialogTitle	     DtCSpellDialogTitle	  XmString Dynamic CSG
DtNtotalLineCountLabel	     DtCTotalLineCountLabel	  XmString Dynamic CSG
_________________________________________________________________________________

	DtNcenterToggleLabel
	      Specifies	the label for the center alignment toggle
	      button  in the Format Settings dialog.  The default
	      value in the C locale is Center.

	DtNchangeAllButtonLabel
	      Specifies	 the  label  for  the	button	 in   the
	      Find/Change  and	Spell  dialogs	that  change  all
	      occurrences of the Find  string  in  the	document.
	      The default value	in the C locale	is Change All.

	DtNchangeButtonLabel
	      Specifies	 the  label  for  the	button	 in   the
	      Find/Change  and Spell dialogs that change the next
	      occurrence of the	Find string in the document.  The
	      default value in the C locale is Change.

	DtNchangeFieldLabel
	      Specifies	 the  label  for   the	 field	 in   the
	      Find/Change  dialog  where  the  user specifies the
	      replacement string.  The default	value  in  the	C
	      locale is	Change To:.

	DtNcurrentLineLabel
	      Specifies	the label for  the  current  line  number
	      field in the status line.	 The default value in the
	      C	locale is Line:.

	DtNfindButtonLabel
	      Specifies	 the  label  for  the	button	 in   the
	      Find/Change  dialog  that	finds the next occurrence
	      of the Find string in the	 document.   The  default
	      value in the C locale is Find.

	DtNfindChangeDialogTitle
	      Specifies	the title for the Find/Change dialog.  If
	      DtNdialogTitle is	non-NULL, it is	added as a prefix
	      to this resource to form the  title.   The  default
	      value in the C locale is Find/Change.

	DtNfindFieldLabel
	      Specifies	 the  label  for   the	 field	 in   the
	      Find/Change  dialog  where  the  user specifies the
	      search string.  The default value	in the	C  locale
	      is Find:.

	DtNformatAllButtonLabel
	      Specifies	the label for the button  in  the  Format

Unix System LaboratoLast change: 1 August 1995		       11

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

	      Settings dialog that formats the complete	document.
	      The default value	in the C locale	is All.

	DtNformatParagraphButtonLabel
	      Specifies	the label for the button  in  the  Format
	      Settings dialog that formats the paragraph contain-
	      ing the insertion	cursor.	 The default value in the
	      C	locale is Paragraph.

	DtNformatSettingsDialogTitle
	      Specifies	the title for the Format Settings dialog.
	      If  DtNdialogTitle  is  non-NULL,	 it is added as	a
	      prefix to	this resource to  form	the  title.   The
	      default value in the C locale is Format Settings.

	DtNinformationDialogTitle
	      Specifies	the title for the Information dialog used
	      to  present feedback and general information to the
	      user.  If	DtNdialogTitle is non-NULL, it	is  added
	      as  a  prefix  to	 this resource to form the title.
	      The default value	in the C locale	is Information.

	DtNjustifyToggleLabel
	      Specifies	the label for the justify alignment  tog-
	      gle  button  in  the  Format  Settings dialog.  The
	      default value in the C locale is Justify.

	DtNleftAlignToggleLabel
	      Specifies	the label for the left	alignment  toggle
	      button  in the Format Settings dialog.  The default
	      value in the C locale is Left Align.

	DtNleftMarginFieldLabel
	      Specifies	the label for the left margin value field
	      in  the  Format Settings dialog.	The default value
	      in the C locale is Left Margin:.

	DtNmisspelledListLabel
	      Specifies	the label for the  list	 of  unrecognized
	      and  misspelled  words  in  the  Spell dialog.  The
	      default value in the C locale is Misspelled Words:.

	DtNoverstrikeLabel
	      Specifies	the label in the status	line  that  indi-
	      cates  that  the	DtEditor  widget is in overstrike
	      mode.  The default value in the C	locale	is  Over-
	      strike.

	DtNrightAlignToggleLabel
	      Specifies	the label for the right	alignment  toggle
	      button  in the Format Settings dialog.  The default
	      value in the C locale is Right Align.

Unix System LaboratoLast change: 1 August 1995		       12

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

	DtNrightMarginFieldLabel
	      Specifies	the label  for	the  right  margin  value
	      field  in	 the Format Settings dialog.  The default
	      value in the C locale is Right Margin:.

	DtNspellDialogTitle
	      Specifies	the  title  for	 the  Spell  dialog.   If
	      DtNdialogTitle is	non-NULL, it is	added as a prefix
	      to this resource to form the  title.   The  default
	      value in the C locale is Spell.

	DtNtotalLineCountLabel
	      Specifies	the label for  the  display  showing  the
	      total  number  of	lines in the document.	The total
	      number of	lines displayed	is  part  of  the  status
	      line.  The default value in the C	locale is Total:.

  Inherited Resources
     The DtEditor widget inherits behavior and resources from the
     following named superclasses.  For	a complete description of
     each resource, see	the man	page for that superclass.

			    XmForm Resource Set
     __________________________________________________________________
     Name		  Class		       Type	 Default Access
     __________________________________________________________________
     XmNfractionBase	  XmCMaxValue	       int	 100	 CSG
     XmNhorizontalSpacing XmCSpacing	       Dimension 0	 CSG
     XmNrubberPositioning XmCRubberPositioning Boolean	 False	 CSG
     XmNverticalSpacing	  XmCSpacing	       Dimension 0	 CSG
     __________________________________________________________________

			   XmBulletinBoard Resource Set
     _________________________________________________________________________
     Name		 Class		    Type	   Default	Access
     _________________________________________________________________________
     XmNallowOverlap	 XmCAllowOverlap    Boolean	   True		CSG
     XmNautoUnmanage	 XmCAutoUnmanage    Boolean	   True		CG
     XmNbuttonFontList	 XmCButtonFontList  XmFontList	   dynamic	CSG
     XmNcancelButton	 XmCWidget	    Window	   NULL		SG
     XmNdefaultButton	 XmCWidget	    Window	   SG
     XmNdefaultPosition	 XmCDefaultPosition Boolean	   True		CSG
     XmNdialogStyle	 XmCDialogStyle	    unsigned char  dynamic	CSG
     XmNdialogTitle	 XmCDialogTitle	    XmString	   NULL		CSG
     XmNfocusCallback	 XmCCallback	    XtCallbackList NULL		C
     XmNlabelFontList	 XmCLabelFontListk  XmFontList	   dynamic	CSG
     XmNmapCallback	 XmCCallback	    XtCallbackList NULL		C
     XmNmarginHeight	 XmCMarginHeight    Dimension	   10		CSG
     XmNmarginWidth	 XmCMarginWidth	    Dimension	   10		CSG
     XmNnoResize	 XmCNoResize	    Boolean	   False	CSG
     XmNresizePolicy	 XmCResizePolicy    unsigned char  XmRESIZE_ANY	CSG
     XmNshadowType	 XmCShadowType	    unsigned char  XmSHADOW_OUT	CSG

Unix System LaboratoLast change: 1 August 1995		       13

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

     XmNtextFontList	 XmCTextFontList    XmFontList	   dynamic	CSG
     XmNtextTranslations XmCTranslations    XtTranslations NULL		C
     XmNunmapCallback	 XmCCallback	    XtCallbackList NULL		C
     _________________________________________________________________________

				 XmManager Resource Set
     ______________________________________________________________________________
     Name		  Class		       Type	      Default	     Access
     ______________________________________________________________________________
     XmNbottomShadowColor XmCBottomShadowColor Pixel	      dynamic	     CSG
     XmNbottomShadow-	  XmCBottomShadow-     Pixmap	      XmUNSPECIFIED- CSG
     Pixmap		  Pixmap			      _PIXMAP
     XmNforeground	  XmCForeground	       Pixel	      dynamic	     CSG
     XmNhelpCallback	  XmCCallback	       XtCallbackList NULL	     C
     XmNhighlightColor	  XmCHighlightColor    Pixel	      dynamic	     CSG
     XmNhighlightPixmap	  XmCHighlightPixmap   Pixmap	      dynamic	     CSG
     XmNinitialFocus	  XmCInitialFocus      Widget	      NULL	     CSG
     XmNnavigationType	  XmCNavigationType    XmNavigation-  dynamic	     CSG
					       Type
     XmNshadowThickness	  XmCShadowThickness   Dimension      dynamic	     CSG
     XmNstringDirection	  XmCStringDirection   XmString-      dynamic	     CG
					       Dynamic
     XmNtopShadowColor	  XmCTopShadowColor    Pixel	      dynamic	     CSG
     XmNtopShadowPixmap	  XmCTopShadowPixmap   Pixmap	      dynamic	     CSG
     XmNtraversalOn	  XmCTraversalOn       Boolean	      dynamic	     CSG
     XmNunitType	  XmCUnitType	       unsigned	char  dynamic	     CSG
     XmNuserData	  XmCUserData	       XtPointer      NULL	     CSG
     ______________________________________________________________________________

			      Composite	Resource Set
     ________________________________________________________________________
     Name	       Class		 Type	     Default	       Access
     ________________________________________________________________________
     XmNchildren       XmCReadOnly	 WidgetList  NULL	       G
     XmNinsertPosition XmCInsertPosition XtOrderProc default procedure CSG
     XmNnumChildren    XmCReadOnly	 Cardinal    0		       G
     ________________________________________________________________________

					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-      CSG
								     _PIXMAP
     XmNborderColor	    XmCBorderColor	   Pixel	  XtDefaultForeground CSG
     XmNborderPixmap	    XmCPixmap		   Pixmap	  XmUNSPECIFIED-      CSG
								     _PIXMAP
     XmNborderWidth	    XmCBorderWidth	   Dimension	  0		      CSG
     XmNcolormap	    XmCColormap		   Colormap	  dynamic	      CG

Unix System LaboratoLast change: 1 August 1995		       14

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

     XmNdepth		    XmCDepth		   int		  dynamic	      CG
     XmNdestroyCallback	    XmCCallback		   XtCallbackList NULL		      C
     XmNheight		    XmCHeight		   Dimension	  dynamic	      CSG
     XmNinitial-	    XmCInitial-		   Boolean	  True		      C
	ResourcesPersistent    ResourcesPersistent
     XmNmappedWhen-	    XmCMappedWhen-	   Boolean	  True		      CSG
	Managed		       Managed
     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
     The  DtEditor  widget  has	 three	callback   functions   of
     interest:

	DtNtextSelectCallback and DtNtextDeselectCallback
	      The DtNtextSelectCallback	and  DtNtextDeselectCall-
	      back  resources  allow an	application to enable and
	      disable certain commands or  menu	 items	based  on
	      whether  there  is a selection.  DtNtextSelectCall-
	      back  specifies  a  function  called  whenever  the
	      selection	 becomes  non-NULL (that is, some text is
	      selected	 within	  the	edit	window),    while
	      DtNtextDeselectCallback specifies	a function called
	      whenever the selection becomes NULL  (that  is,  no
	      text is selected within the edit window).	 The rea-
	      sons sent	by the callbacks are DtEDITOR_TEXT_SELECT
	      and DtEDITOR_TEXT_DESELECT.

	XmNhelpCallback
	      An application that wishes to present help informa-
	      tion  to	the  user  on the DtEditor widget and its
	      dialogs should set the XmNhelpCallback resource and
	      use  the	Reason	field  passed  as  part	of DtEdi-
	      torHelpCallbackStruct to set the	contents  of  its
	      Help  dialog.  A pointer to the following	structure
	      is passed	to the XmNHelpCallback callback.

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

	reason
	      Indicates	why the	callback was invoked.  The possi-
	      ble reasons are:

Unix System LaboratoLast change: 1 August 1995		       15

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

		 DtEDITOR_HELP_EDIT_WINDOW
		       The help	request	originated  in	the  edit
		       window.

		 DtEDITOR_HELP_STATUS_LINE
		       The help	request	originated in the  status
		       line.

		 DtEDITOR_HELP_STATUS_CURRENT_LINE
		       The help	request	originated in the Current
		       Line number display in the status line.

		 DtEDITOR_HELP_STATUS_TOTAL_LINES
		       The help	request	originated in  the  Total
		       Lines display in	the status line.

		 DtEDITOR_HELP_STATUS_MESSAGE
		       The help	request	originated in the Message
		       field in	the status line.

		 DtEDITOR_HELP_STATUS_OVERSTRIKE
		       The help	request	originated in  the  Over-
		       strike Indicator	in the status line.

		 DtEDITOR_HELP_FORMAT_DIALOG
		       The help	request	originated  in	the  Help
		       button in the Format dialog.

		 DtEDITOR_HELP_FORMAT_LEFT_MARGIN
		       The help	request	originated  in	the  Left
		       Margin field in the Format dialog.

		 DtEDITOR_HELP_FORMAT_RIGHT_MARGIN
		       The help	request	originated in  the  Right
		       Margin field in the Format dialog.

		 DtEDITOR_HELP_FORMAT_ALIGNMENT
		       The help	request	originated in the  Align-
		       ment buttons in the Format dialog.

		 DtEDITOR_HELP_CHANGE_DIALOG
		       The help	request	originated  in	the  Help
		       button in the Find/Change dialog.

		 DtEDITOR_HELP_CHANGE_FIND
		       The help	request	originated  in	the  Find
		       field in	the Find/Change	dialog.

		 DtEDITOR_HELP_CHANGE_CHANGE
		       The help	request	originated in the  Change
		       To field	in the Find/Change dialog.

Unix System LaboratoLast change: 1 August 1995		       16

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

		 DtEDITOR_HELP_SPELL_DIALOG
		       The help	request	originated  in	the  help
		       button in the Spell dialog.

		 DtEDITOR_HELP_SPELL_MISSPELLED_WORDS
		       The help	request	originated in the List of
		       Misspelled Words	in the Spell dialog.

		 DtEDITOR_HELP_SPELL_CHANGE
		       The help	request	originated in the  Change
		       To field	in the Spell dialog.

	event
	      A	pointer	to the XEvent that caused  this	 callback
	      to be invoked.  It may be	NULL.

  Translations
     The DtEditor widget translations for  the	edit  window  are
     described	in  the	 following list.  The DtNtextTranslations
     resource can be used to modify these translations.

	KLeft
	      backward-character()

	MShift KLeft
	      key-select (left)

	MCtrl KLeft
	      backward-word()

	MShift MCtrl KLeft
	      backward-word (extend)

	KRight
	      forward-character()

	MShift KRight
	      key-select (right)

	MCtrl KRight
	      forward-word()

	MShift MCtrl KRight
	      forward-word (extend)

	KUp
	      process-up()

	MShift KUp
	      process-shift-up()

	MCtrl KUp

Unix System LaboratoLast change: 1 August 1995		       17

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

	      backward-paragraph()

	MShift MCtrl KUp
	      backward-paragraph (extend)

	KDown
	      process-down()

	MShift KDown
	      process-shift-down()

	MCtrl KDown
	      forward-paragraph()

	MShift MCtrl KDown
	      forward-paragraph	(extend)

	KBeginLine
	      beginning-of-line()

	MShift KBeginLine
	      beginning-of-line	(extend)

	KEndLine
	      end-of-line()

	MShift KEndLine
	      end-of-line (extend)

	KPageUp
	      previous-page()

	MShift KPageUp
	      previous-page (extend)

	KPageLeft
	      page-left()

	KPageDown
	      next-page()

	MShift KPageDown
	      next-page	(extend)

	KPageRight
	      page-right()

	KBeginData
	      beginning-of-file()

	MShift KBeginData
	      beginning-of-file	(extend)

Unix System LaboratoLast change: 1 August 1995		       18

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

	KEndData
	      end-of-file()

	MShift KEndData
	      end-of-file (extend)

	KDelete
	      delete-next-character()

	MCtrl KDelete
	      delete-to-end-of-line()

	KBackSpace
	      delete-previous-character()

	MCtrl KBackSpace
	      delete-previous-word()

	MShift KBackSpace
	      delete-to-start-of-line()

	MAlt KBackSpace
	      undo-edit()

	MCtrl Kz
	      undo-edit()

	MCtrl K/
	      select-all()

	MCtrl K\
	      deselect-all()

	MCtrl Kg
	      go-to-line()

	MCtrl Kq
	      quote-next-character()

	MCtrl Kx
	      cut-clipboard()

	MCtrl Kc
	      copy-clipboard()

	MCtrl Kv
	      paste-clipboard()

	KHelp
	      Help()

	KInsert

Unix System LaboratoLast change: 1 August 1995		       19

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

	      toggle-insert-mode()

	KEnter
	      new-line-and-indent()

	MAnyKCancel
	      process-cancel()

  Action Routines
     The DtEditor widget action	routines are described here:

	backward-character()
	      This action moves	the insertion cursor one  charac-
	      ter  to  the  left.  This	action may have	different
	      behavior in a right-to-left language environment.

	backward-paragraph(extend)
	      If this action is	called with no argument, it moves
	      the  insertion  cursor  to the first non-whitespace
	      character	following the first previous  blank  line
	      or  beginning of the text.  If the insertion cursor
	      is already at the	beginning  of  a  paragraph,  the
	      action  moves the	insertion cursor to the	beginning
	      of the previous paragraph.

	      If this  action  is  called  with	 an  argument  of
	      extend,  it  moves  the insertion	cursor,	as in the
	      case of no argument, and extends the current selec-
	      tion.

	backward-word(extend)
	      If this action is	called with no argument, it 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,	this action 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 this  action  is  called  with	 an  argument  of
	      extend,  it  moves  the insertion	cursor,	as in the
	      case of no argument, and extends the current selec-
	      tion.

	beginning-of-file(extend)
	      If this action is	called with no argument, it moves
	      the insertion cursor to the beginning of the text.

	      If this  action  is  called  with	 an  argument  of
	      extend,  it  moves  the insertion	cursor,	as in the

Unix System LaboratoLast change: 1 August 1995		       20

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

	      case of no argument, and extends the current selec-
	      tion.

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

	      If this  action  is  called  with	 an  argument  of
	      extend,  it  moves  the insertion	cursor,	as in the
	      case of no argument, and extends the current selec-
	      tion.

	clear-selection()
	      This action clears the current selection by replac-
	      ing  each	character except <carriage-return> with	a
	      <space> character.

	copy-clipboard()
	      This action copies the  current  selection  to  the
	      clipboard.

	cut-clipboard()
	      This action cuts the current selection to	the clip-
	      board.

	delete-next-character()
	      If there	is  a  non-NULL	 selection,  this  action
	      deletes  the  selection;	otherwise, it deletes the
	      character	following the insertion	cursor.

	delete-next-word()
	      If there	is  a  non-NULL	 selection,  this  action
	      deletes  the  selection;	otherwise, it deletes the
	      characters following the insertion  cursor  to  the
	      next space, tab or end of	line character.

	delete-previous-character()
	      If there	is  a  non-NULL	 selection,  this  action
	      deletes  the  selection;	otherwise, it deletes the
	      character	of text	immediately preceding the  inser-
	      tion cursor.

	delete-previous-word()
	      If there	is  a  non-NULL	 selection,  this  action
	      deletes  the  selection;	otherwise, it deletes the
	      characters preceding the insertion  cursor  to  the
	      next space, tab or beginning of the line character.
	      This action may have different behavior in a locale
	      other than the C locale.

	delete-to-end-of-line()
	      If there	is  a  non-NULL	 selection,  this  action

Unix System LaboratoLast change: 1 August 1995		       21

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

	      deletes  the  selection;	otherwise, it deletes the
	      characters following the insertion  cursor  to  the
	      next end-of-line character.

	delete-to-start-of-line()
	      If there	is  a  non-NULL	 selection,  this  action
	      deletes  the  selection;	otherwise, it deletes the
	      characters preceding the insertion  cursor  to  the
	      previous beginning-of-line character.

	deselect-all()
	      This action deselects the	current	selection.

	end-of-file(extend)
	      If this action is	called with no argument, it moves
	      the insertion cursor to the end of the text.

	      If this  action  is  called  with	 an  argument  of
	      extend,  it  moves  the insertion	cursor,	as in the
	      case of no argument, and extends the current selec-
	      tion.

	end-of-line(extend)
	      If this action is	called with no argument, it moves
	      the insertion cursor to the end of the line.

	      If this  action  is  called  with	 an  argument  of
	      extend,  it  moves  the insertion	cursor,	as in the
	      case of no argument, and extends the current selec-
	      tion.

	forward-character()
	      This action moves	the insertion cursor one  charac-
	      ter  to  the right.  This	action may have	different
	      behavior in a right-to-left language environment.

	forward-paragraph(extend)
	      If this action is	called with no argument, it moves
	      the  insertion  cursor  to the first non-whitespace
	      character	following the next blank  line.	  If  the
	      insertion	 cursor	 is already at the beginning of	a
	      paragraph, this action moves the	insertion  cursor
	      to the beginning of the next paragraph.

	      If this  action  is  called  with	 an  argument  of
	      extend,  it  moves  the insertion	cursor,	as in the
	      case of no argument, and extends the current selec-
	      tion.

	forward-word(extend)
	      If this action is	called with no argument, it moves
	      the   insertion  cursor  to  the	first  whitespace

Unix System LaboratoLast change: 1 August 1995		       22

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

	      character	or end-of-line following  the  next  non-
	      whitespace  character.   If the insertion	cursor is
	      already at the end of a word, this action	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,  this  action
	      moves  the  insertion  cursor, as	in the case of no
	      argument,	and extends the	current	selection.

	go-to-line()
	      This action moves	the keyboard focus to the Current
	      Line  text  field	 to  allow  the	 user to move the
	      insertion	cursor to a new	 line.	 This  action  is
	      only  valid  if  DtNshowStatusLine  has  a value of
	      True.  For a description of the  status  line,  see
	      the Editor Status	Line heading in	this manual page.

	Help()
	      This action 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.

	insert-string(string)
	      This action deletes the entire selection	if  there
	      is  a non-NULL selection and the cursor is not dis-
	      joint from it.  It inserts string	before the inser-
	      tion cursor.

	key-select(direction)
	      If this action is	called with an argument	of right,
	      it  moves	the insertion cursor one character to the
	      right and	extends	the current selection.	 If  this
	      action is	called with an argument	of left, it moves
	      the insertion cursor one character to the	left  and
	      extends  the  current selection.	If this	action is
	      called with no argument,	it  extends  the  current
	      selection.

	newline-and-backup()
	      If there is a non-NULL selection and the cursor  is
	      not  disjoint  from  it,	this  action  deletes the
	      entire selection,	inserts	a newline just before the
	      insertion	cursor and repositions the insertion cur-
	      sor to the end of	the line before	the newline.

	newline-and-indent()
	      If there is a non-NULL selection and the cursor  is
	      not  disjoint  from  it,	this  action  deletes the
	      entire selection,	inserts	a newline  and	then  the

Unix System LaboratoLast change: 1 August 1995		       23

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

	      same  number  of	whitespace  characters	as at the
	      beginning	of the previous	line.

	next-page(extend)
	      If this action is	called with no argument, it moves
	      the insertion cursor forward one page.

	      If this  action  is  called  with	 an  argument  of
	      extend,  it  moves  the insertion	cursor,	as in the
	      case of no argument, and extends the current selec-
	      tion.

	page-left()
	      This action scrolls the  viewing	window	left  one
	      page of text.

	page-right()
	      This action scrolls the viewing  window  right  one
	      page of text.

	paste-clipboard()
	      This action pastes the contents  of  the	clipboard
	      before the insertion cursor.

	previous-page(extend)
	      If this action is	called with no argument, it moves
	      the insertion cursor back	one page.

	      If this  action  is  called  with	 an  argument  of
	      extend,  it  moves  the insertion	cursor,	as in the
	      case of no argument, and extends the current selec-
	      tion.

	process-cancel()
	      This action cancels the current extend-adjust()  or
	      secondary-adjust()  operation and	leaves the selec-
	      tion state as it was before the  operation;  other-
	      wise,  (and  if  the parent is a manager)	it passes
	      the event	to the parent.

	process-down()
	      This action moves	the  insertion	cursor	down  one
	      line.

	process-shift-down()
	      This action moves	the  insertion	cursor	down  one
	      line, extending the current selection.

	process-shift-up()
	      This action moves	the insertion cursor up	one line,
	      extending	the current selection.

Unix System LaboratoLast change: 1 August 1995		       24

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

	process-up()
	      This action moves	the insertion cursor up	one line.

	select-all()
	      Selects all text.

	toggle-insert-mode()
	      This action toggles the state of the text	insertion
	      mode.  By	default, characters typed into the DtEdi-
	      tor widget are inserted  at  the	position  of  the
	      insertion	 cursor.   In overstrike mode, characters
	      entered into the DtEditor	widget replace the  char-
	      acters  that  directly follow the	insertion cursor.
	      In overstrike mode, characters are appended to  the
	      end of the line when the end of a	line is	reached.

	quote-next-character()
	      This action treats the next typed	 character  as	a
	      special  character  and  inserts	it  into the text
	      without interpreting it.	Enables	the insertion  of
	      special	instructional	characters   or	  special
	      language characters, such	as the character  marking
	      a	form feed or the umlaut	used in	German text.

	undo-edit()
	      This action undoes the  last  change  (deletion  or
	      insertion)  made to the text.  A change consists of
	      either a set of consecutive insertions, or a set of
	      consecutive  deletions followed by up to one set of
	      consecutive insertions.  An insertion  is	 consecu-
	      tive  if	there have been	no intervening deletions,
	      and it is	continuing forward from	the  same  point.
	      A	 deletion  is  consecutive  if there have been no
	      intervening insertions, and its start or end  posi-
	      tion  is	coincidental with the last deletion (that
	      is, the deletion is continuing from the same point,
	      either  forward or backward).  Undoing an	edit once
	      restores the original text.  Undoing an edit  twice
	      restores the last	change.

  Convenience Functions
     The Widget	Library	contains a number of functions that apply
     to	the DtEditor widget.  The following lists summarize these
     functions.

  DtEditor Life	Cycle Functions
	DtCreateEditor()
	      Creates a	new instance of	a DtEditor widget.

	DtEditorReset()
	      Restores a DtEditor widget to its	initial	state.

Unix System LaboratoLast change: 1 August 1995		       25

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

  DtEditor Input/Output	Functions
	DtEditorAppend()
	      Appends content data  to	the  end  of  a	 DtEditor
	      widget.

	DtEditorAppendFromFile()
	      Appends the contents of a	file  to  the  end  of	a
	      DtEditor widget.

	DtEditorGetContents()
	      Retrieves	the entire contents of a DtEditor widget.

	DtEditorInsert()
	      Inserts content data at the  current  insert  posi-
	      tion.

	DtEditorInsertFromFile()
	      Inserts the contents  of	a  file	 at  the  current
	      insert position.

	DtEditorReplace()
	      Replaces a portion of text with the supplied data.

	DtEditorReplaceFromFile()
	      Replaces a portion of text with the contents  of	a
	      file.

	DtEditorSaveContentsToFile()
	      Saves the	entire contents	to a file.

	DtEditorSetContents()
	      Loads content data into a	DtEditor widget,  replac-
	      ing the entire contents of the widget.

	DtEditorSetContentsFromFile()
	      Loads the	 contents  of  a  file	into  a	 DtEditor
	      widget,	replacing  the	entire	contents  of  the
	      widget.

  DtEditor Selection Functions
	DtEditorClearSelection()
	      Replaces	the  currently	selected  contents   with
	      blanks.

	DtEditorCopyToClipboard()
	      Copies the currently selected contents to	the clip-
	      board.

	DtEditorCutToClipboard()
	      Removes the currently selected contents, placing it
	      on the clipboard.

Unix System LaboratoLast change: 1 August 1995		       26

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

	DtEditorDeleteSelection()
	      Removes the currently selected contents.

	DtEditorDeselect()
	      Deselects	any selected contents.

	DtEditorPasteFromClipboard()
	      Pastes the contents of the clipboard into	a  DtEdi-
	      tor  widget,  replacing any currently selected con-
	      tents.

	DtEditorSelectAll()
	      Selects the entire contents of a DtEditor	widget.

  DtEditor Format Functions
	DtEditorFormat()
	      Formats the contents of all or part of  a	 DtEditor
	      widget.

	DtEditorInvokeFormatDialog()
	      Displays the format dialog that enables the user to
	      specify  format settings for margins and justifica-
	      tion style and to	perform	formatting operations.

  DtEditor Find	and Change Text	Functions
	DtEditorChange()
	      Changes one or all occurrences of	a string.

	DtEditorFind()
	      Finds the	next occurrence	of a string.

	DtEditorInvokeFindChangeDialog()
	      Displays the dialog that enables the user	to search
	      for, and optionally change, a string.

	DtEditorInvokeSpellDialog()
	      Displays a dialog	with a list of	misspelled  words
	      in the current contents.

  DtEditor Auxiliary Functions
	DtEditorDisableRedisplay()
	      Temporarily prevents visual update  of  a	 DtEditor
	      widget.

	DtEditorEnableRedisplay()
	      Forces the visual	update of a DtEditor widget.

	DtEditorCheckForUnsavedChanges()
	      Reports whether the contents of a	 DtEditor  widget
	      have been	altered	since they were	last retrieved or
	      saved.

Unix System LaboratoLast change: 1 August 1995		       27

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

	DtEditorGetInsertionPosition()
	      Returns the insertion cursor position of a DtEditor
	      widget.

	DtEditorGetLastPosition()
	      Returns the position of the last character  in  the
	      edit window.

	DtEditorGetMessageTextFieldID()
	      Retrieves	the widget ID of the  Text  Field  widget
	      used to display application messages.

	DtEditorGetSizeHints()
	      Retrieves	 sizing	 information  from   a	 DtEditor
	      widget.

	DtEditorGoToLine()
	      Moves the	insert cursor to the specified line.

	DtEditorSetInsertionPosition()
	      Sets the position	of the insertion cursor.

	DtEditorTraverseToEditor()
	      Sets keyboard traversal to the  edit  window  of	a
	      DtEditor widget.

	DtEditorUndoEdit()
	      Undoes the last edit made	by a user.

FILES
	/usr/dt/lib/nls/msg/$LANG/DtWidget.cat()
	      Message catalog for DtWidget library.

SEE ALSO
     DtEditor(5), DtCreateEditor(3), DtEditorAppend(3),	DtEdi-
     torAppendFromFile(3), DtEditorChange(3), DtEditorCheckForUn-
     savedChanges(3), DtEditorClearSelection(3), DtEditorCopyTo-
     Clipboard(3), DtEditorCutToClipboard(3), DtEditor-
     DeleteSelection(3), DtEditorDeselect(3), DtEditorDisa-
     bleRedisplay(3), DtEditorEnableRedisplay(3), DtEditor-
     Find(3), DtEditorFormat(3), DtEditorGetContents(3), DtEdi-
     torGetInsertionPosition(3), DtEditorGetLastPosition(3),
     DtEditorGetMessageTextFieldID(3), DtEditorGetSizeHints(3),
     DtEditorGoToLine(3), DtEditorInsert(3), DtEditorInsertFrom-
     File(3), DtEditorInvokeFindChangeDialog(3), DtEditorIn-
     vokeFormatDialog(3), DtEditorInvokeSpellDialog(3),	DtEditor-
     PasteFromClipboard(3), DtEditorReplace(3),	DtEditorRepla-
     ceFromFile(3), DtEditorReset(3), DtEditorSaveContentsTo-
     File(3), DtEditorSelectAll(3), DtEditorSetContents(3),
     DtEditorSetContentsFromFile(3), DtEditorSetInsertionPosi-
     tion(3), DtEditorTraverseToEditor(3), DtEditorUndoEdit(3);
     Composite(3X), Constraint(3X), Core(3X),

Unix System LaboratoLast change: 1 August 1995		       28

DtEditor(3)	       C LIBRARY FUNCTIONS	      DtEditor(3)

     XmBulletinBoard(3X), XmFontList(3X), XmForm(3X),
     XmManager(3X), XmTextField(3X).

Unix System LaboratoLast change: 1 August 1995		       29


Man(1) output converted with man2html