Table C-5 DXmCSText Widget Action Routines
  
    | Action Routine  | 
    Description  | 
  
  
    | 
      activate():
     | 
    
      Calls the callbacks for XmNactivateCallback.
     | 
  
  
    | 
      backward-character():
     | 
    
       Moves the insertion cursor one character to the left.
     | 
  
  
    | 
      backward-paragraph(extend):
     | 
    
       If XmNeditMode is XmMULTI_LINE_EDIT and this action is called with no
       argument, moves the insertion cursor to the first nonwhitespace
       character following the first previous blank line or beginning of the
       text.
     | 
  
  
    | 
       
     | 
    
      If the insertion cursor is already at the beginning of a paragraph,
      moves the insertion cursor to the beginning of the previous paragraph.
     | 
  
  
    | 
       
     | 
    
      If XmNeditMode is XmMULTI_LINE_EDIT and this action is called with
      extend, moves the insertion cursor as in the case of
      no argument and extends the selection.
     | 
  
  
    | 
      backward-word(extend):
     | 
    
      If this action is called with no argument, moves the insertion cursor
      to the first nonwhitespace character after the first whitespace
      character to the left or 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.
     | 
  
  
    | 
       
     | 
    
      If called with
      extend, moves the insertion cursor as in the case of
      no argument and extends the selection.
     | 
  
  
    | 
      beep():
     | 
    
       Causes the terminal to beep.
     | 
  
  
    | 
      beginning-of-file(extend):
     | 
    
       If this action is called with no argument, moves the insertion cursor
       to the beginning of the text.
     | 
  
  
    | 
       
     | 
    
      If called with
      extend, moves the insertion cursor as in the case of
      no argument and extends the selection.
     | 
  
  
    | 
      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
      extend, moves the insertion cursor as in the case of
      no argument and extends the selection.
     | 
  
  
    | 
      clear-selection():
     | 
    
       Clears the current selection by replacing each character, except
       <Return>, with a <space> character.
     | 
  
  
    | 
      copy-clipboard():
     | 
    
       Copies the current selection to the clipboard.
     | 
  
  
    | 
      copy-primary():
     | 
    
       Copies the primary selection to the insertion cursor.
     | 
  
  
    | 
      copy-to():
     | 
    
       If a secondary selection exists, copies the secondary selection to the
       insertion cursor.
     | 
  
  
    | 
       
     | 
    
      If no secondary selection exists, copies the primary selection to the
      pointer location.
     | 
  
  
    | 
       cut-clipboard():
     | 
    
       Cuts the current selection to the clipboard.
     | 
  
  
    | 
      cut-primary():
     | 
    
       Cuts the primary selection to the insertion cursor.
     | 
  
  
    | 
      delete-next-character():
     | 
    
       If XmNpendingDelete is TRUE and the cursor is inside the selection,
       deletes the entire selection; otherwise, deletes the character
       following the insert cursor.
     | 
  
  
    | 
      delete-next-word():
     | 
    
       If XmNpendingDelete is TRUE and the cursor is inside the selection,
       deletes the entire selection; otherwise, deletes the characters
       following the insertion cursor to the next space, tab, or end of line
       character.
     | 
  
  
    | 
      delete-previous-character():
     | 
    
       If XmNpendingDelete is TRUE and the cursor is inside the selection,
       deletes the entire selection; otherwise, deletes the character of text
       immediately preceding the insertion cursor.
     | 
  
  
    | 
      delete-previous-word():
     | 
    
       If XmNpendingDelete is TRUE and the cursor is inside the selection,
       deletes the entire selection; otherwise, deletes the characters
       preceding the insertion cursor to the next space, tab, or beginning of
       line character.
     | 
  
  
    | 
      delete-selection():
     | 
    
       Deletes the current selection.
     | 
  
  
    | 
      delete-to-end-of-line():
     | 
    
       Deletes the characters following the insertion cursor to the next end
       of line character.
     | 
  
  
    | 
      delete-to-start-of-line():
     | 
    
       Deletes the characters preceding the insertion cursor to the previous
       beginning of line character.
     | 
  
  
    | 
      deselect-all():
     | 
    
       Deselects the current selection.
     | 
  
  
    | 
      do-quick-action():
     | 
    
       Marks the end of a secondary selection. Performs the quick action
       initiated by the quick-copy-set or quick-cut-set action.
     | 
  
  
    | 
      end-of-file(extend):
     | 
    
       If this action is called with no argument, moves the insertion cursor
       to the end of the text.
     | 
  
  
    | 
       
     | 
    
      If called with
      extend, moves the insertion cursor as in the case of
      no argument and extends the selection.
     | 
  
  
    | 
      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
      extend, moves the insertion cursor as in the case of
      no argument and extends the selection.
     | 
  
  
    | 
      extend-adjust():
     | 
    
       Selects text from the anchor to the pointer position and deselects text
       outside that range. Moving the pointer over several lines selects text
       from the anchor to the end of each line over which the pointer moves
       and up to the pointer position on the current line.
     | 
  
  
    | 
      extend-end():
     | 
    
       Moves the insertion cursor to the position of the pointer.
     | 
  
  
    | 
      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.
     | 
  
  
    | 
      extreme-left-of-file(extend):
     | 
    
       If this action is called with no argument and the current text path is
       left to right, moves the insertion cursor to the beginning of the text.
     | 
  
  
    | 
       
     | 
    
      If called with no argument and the current text path is right to left,
      moves the insertion cursor to the end of the text.
     | 
  
  
    | 
       
     | 
    
      If called with
      extend, moves the insertion cursor as in the case of
      no argument and extends the selection.
     | 
  
  
    | 
       
     | 
    
      The text path can be initially set using the DXmNtextPath resource or
      interactively (see toggle-text-path).
     | 
  
  
    | 
      extreme-right-of-file(extend):
     | 
    
       If this action is called with no argument and the current text path is
       left to right, moves the insertion cursor to the end of the text.
     | 
  
  
    | 
       
     | 
    
      If called with no argument and the current text path is right to left,
      moves the insertion cursor to the beginning of the text.
     | 
  
  
    | 
       
     | 
    
      If called with
      extend, moves the insertion cursor as in the case of
      no argument and extends the selection.
     | 
  
  
    | 
       
     | 
    
      The text path can be set initially using the DXmNtextPath resource or
      interactively (see toggle-text-path).
     | 
  
  
    | 
      forward-character():
     | 
    
       Moves the insertion cursor one character to the right.
     | 
  
  
    | 
      forward-paragraph(extend):
     | 
    
       If XmNeditMode is XmMULTI_LINE_EDIT, and this action is called with no
       argument, moves the insertion cursor to the first nonwhitespace
       character following the next blank line. If the insertion cursor is
       already at the beginning of a paragraph, moves the insertion cursor to
       the beginning of the next paragraph.
     | 
  
  
    | 
       
     | 
    
      If XmNeditMode is XmMULTI_LINE_EDIT and this action is called with
      extend, moves the insertion cursor as in the case of
      no argument and extends the selection.
     | 
  
  
    | 
      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
       nonwhitespace character. If the insertion cursor is already at the end
       of a word, moves the insertion cursor to the end of the next word.
     | 
  
  
    | 
       
     | 
    
      If called with
      extend, moves the insertion cursor as in the case of
      no argument and extends the selection.
     | 
  
  
    | 
      grab-focus():
     | 
    
       This key binding performs the action in the XmNselectArray, 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, three clicks to select a line of
       text, and four clicks to select all text.
     | 
  
  
    | 
      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.
     | 
  
  
    | 
      insert-string(string):
     | 
    
       If XmNpendingDelete is TRUE and the cursor is inside the selection,
       deletes the entire selection. Inserts "string" at the insertion cursor.
     | 
  
  
    | 
      key-select(direction):
     | 
    
       If called with an argument of "right", moves the insertion cursor one
       character to the right and extends the selection. If called with an
       argument of "left", moves the insertion cursor one character to the
       left and extends the selection. If called with no argument, extends the
       selection.
     | 
  
  
    | 
      kill-next-character():
     | 
    
       If XmNpendingDelete is TRUE and the cursor is inside the selection,
       deletes the entire selection. Otherwise, kills the character following
       the insertion cursor and stores the character in the cut buffer.
     | 
  
  
    | 
      kill-next-word():
     | 
    
       If XmNpendingDelete is TRUE and the cursor is inside the selection,
       deletes the entire selection. Otherwise, kills the characters following
       the insertion cursor to the next space, tab, or end of line character,
       and stores the characters in the cut buffer.
     | 
  
  
    | 
      kill-previous-character():
     | 
    
       If XmNpendingDelete is TRUE and the cursor is inside the selection,
       deletes the entire selection. Otherwise, kills the character of text
       immediately preceding the insertion cursor and stores the character in
       the cut buffer.
     | 
  
  
    | 
      kill-previous-word():
     | 
    
       If XmNpendingDelete is TRUE and the cursor is inside the selection,
       deletes the entire selection. Otherwise, kills the characters preceding
       the insertion cursor to the next space, tab, or beginning of line
       character, and stores the characters in the cut buffer.
     | 
  
  
    | 
      kill-selection():
     | 
    
       Kills the currently selected text and stores the text in the cut buffer.
     | 
  
  
    | 
      kill-to-end-of-line():
     | 
    
       Kills the characters following the insertion cursor to the next end of
       line character and stores the characters in the cut buffer.
     | 
  
  
    | 
      kill-to-start-of-line():
     | 
    
       Kills the characters preceding the insertion cursor to the next
       beginning of line character and stores the characters in the cut buffer.
     | 
  
  
    | 
      left-character():
     | 
    
       Moves the insertion cursor one character to the left.
     | 
  
  
    | 
      left-side-of-line(extend):
     | 
    
       If this action is called with no argument and the current text path is
       left to right, moves the insertion cursor to the beginning of the line.
     | 
  
  
    | 
       
     | 
    
      If called with no argument and the current text path is right to left,
      moves the insertion cursor to the end of the line.
     | 
  
  
    | 
       
     | 
    
      If called with
      extend, moves the insertion cursor as in the case of
      no argument and extends the selection.
     | 
  
  
    | 
       
     | 
    
      Set the text path initially (using the DXmNtextPath resource) or
      interactively (see toggle-text-path).
     | 
  
  
    | 
      left-word(extend):
     | 
    
       If this action is called with no argument and the current text path is
       left to right, moves the insertion cursor to the first nonwhitespace
       character after the first whitespace character to the left or to 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.
     | 
  
  
    | 
       
     | 
    
      If this action is called with no argument and the current text path is
      right to left, moves the insertion cursor to the first whitespace
      character or end of line following the next nonwhitespace character. If
      the insertion cursor is already at the end of a word, moves the
      insertion cursor to the end of the next word.
     | 
  
  
    | 
       
     | 
    
      If called with
      extend, moves the insertion cursor as in the case of
      no argument and extends the selection.
     | 
  
  
    | 
       
     | 
    
      Set the text path initially (using the DXmNtextPath resource) or
      interactively (see toggle-text-path).
     | 
  
  
    | 
      move-destination():
     | 
    
       Moves the insertion cursor to the pointer position without changing any
       existing selection. If no selection exists, also moves the destination
       cursor to the pointer position.
     | 
  
  
    | 
      move-to():
     | 
    
       If a secondary selection exists, cuts the secondary selection to the
       insertion cursor. If no secondary selection exists, cuts the primary
       selection to the pointer location.
     | 
  
  
    | 
      new-line():
     | 
    
       If XmNpendingDelete is TRUE and the cursor is inside the selection,
       deletes the entire selection. Inserts a newline at the insertion cursor.
     | 
  
  
    | 
      newline-and-backup():
     | 
    
       If XmNpendingDelete is TRUE and the cursor is inside the selection,
       deletes the entire selection. Inserts a newline and repositions the
       insertion cursor to the end of the line before the newline.
     | 
  
  
    | 
      newline-and-indent():
     | 
    
       If XmNpendingDelete is TRUE and the cursor is inside the selection,
       deletes the entire selection. Inserts a newline and then the same
       number of whitespace characters as at the beginning of the previous
       line.
     | 
  
  
    | 
      next-line():
     | 
    
       Moves the insertion cursor to the next line.
     | 
  
  
    | 
      next-page(extend):
     | 
    
       If this action is called with now argument, moves the insertion cursor
       forward one page.
     | 
  
  
    | 
       
     | 
    
      If called with
      extend, moves the insertion cursor as in the case of
      no argument and extends the selection.
     | 
  
  
    | 
      next-tab-group():
     | 
    
       Traverses to the next tab group.
     | 
  
  
    | 
      page-horizontal-backward():
     | 
    
       If the current text path is left to right, scrolls the viewing window
       left one path of text.
     | 
  
  
    | 
       
     | 
    
      If the current text path is right to left, scrolls the viewing window
      right one path of text.
     | 
  
  
    | 
       
     | 
    
      Set the text path initially (using the DXmNtextPath resource) or
      interactively (see toggle-text-path).
     | 
  
  
    | 
      page-horizontal-forward():
     | 
    
       If the current text path is left to right, scrolls the viewing window
       right one path of text.
     | 
  
  
    | 
       
     | 
    
      If the current text path is right to left, scrolls the viewing window
      left one path of text.
     | 
  
  
    | 
       
     | 
    
      Set the text path initially (using the DXmNtextPath resource) or
      interactively (see toggle-text-path).
     | 
  
  
    | 
      page-left():
     | 
    
       Scrolls the viewing window left one page of text.
     | 
  
  
    | 
      page-right():
     | 
    
       Scrolls the viewing window right one page of text.
     | 
  
  
    | 
      paste-clipboard():
     | 
    
       Pastes the contents of the clipboard before the insertion cursor.
     | 
  
  
    | 
      prev-tab-group():
     | 
    
       Traverses to the previous tab group.
     | 
  
  
    | 
      previous-line():
     | 
    
       Moves the insertion cursor to the previous line.
     | 
  
  
    | 
      previous-page(extend):
     | 
    
       If this action is called with no argument, moves the insertion cursor
       back one page.
     | 
  
  
    | 
       
     | 
    
      If called with
      extend, moves the insertion cursor as in the case of
      no argument and extends the selection.
     | 
  
  
    | 
      process-cancel():
     | 
    
       Cancels the current extend-adjust() or secondary-adjust() operation and
       leaves the selection state as it was before the operation.
     | 
  
  
    | 
      process-down():
     | 
    
       If XmNeditMode is XmSINGLE_LINE_EDIT and XmNnavigationType is XmNONE,
       traverses to the widget below the current one in the tab group.
     | 
  
  
    | 
       
     | 
    
      If XmNeditMode is XmMULTI_LINE_EDIT, moves the insertion cursor down
      one line.
     | 
  
  
    | 
      process-home():
     | 
    
       Moves the insertion cursor to the beginning of the line.
     | 
  
  
    | 
      process-return():
     | 
    
       If XmNeditMode is XmSINGLE_LINE_EDIT, calls the callbacks for
       XmNactivateCallback. If XmNeditMode is XmMULTI_LINE_EDIT, inserts a new
       line.
     | 
  
  
    | 
      process-shift-down():
     | 
    
       If XmNeditMode is XmMULTI_LINE_EDIT, moves the insertion cursor down
       one line.
     | 
  
  
    | 
      process-shift-up():
     | 
    
       If XmNeditMode is XmMULTI_LINE_EDIT, moves the insertion cursor up one
       line.
     | 
  
  
    | 
      process-tab():
     | 
    
       If XmNeditMode is XmSINGLE_LINE_EDIT, traverses to the next tab group.
       If XmNeditMode is XmMULTI_LINE_EDIT, inserts a tab.
     | 
  
  
    | 
      process-up():
     | 
    
       If XmNeditMode is XmSINGLE_LINE_EDIT and XmNnavigationType is XmNONE,
       traverses to the widget above the current one in tab group.
     | 
  
  
    | 
       
     | 
    
      If XmNeditMode is XmMULTI_LINE_EDIT, moves the insertion cursor up one
      line.
     | 
  
  
    | 
      quick-copy-set():
     | 
    
       Marks the beginning of a secondary selection for use in quick copy.
     | 
  
  
    | 
      quick-cut-set():
     | 
    
       Marks the beginning of a secondary selection for use in quick cut.
     | 
  
  
    | 
      redraw-display():
     | 
    
       Redraws the contents of the text windows.
     | 
  
  
    | 
      right-character():
     | 
    
       Moves the insertion cursor one character to the right.
     | 
  
  
    | 
      right-side-of-line(extend):
     | 
    
       If this action is called with no argument and the current text path is
       left to right, moves the insertion cursor to the end of the line.
     | 
  
  
    | 
       
     | 
    
      If called with no argument and the current text path is right to left,
      moves the insertion cursor to the beginning of the line.
     | 
  
  
    | 
       
     | 
    
      If called with
      extend, moves the insertion cursor as in the case of
      no argument and extends the selection.
     | 
  
  
    | 
       
     | 
    
      Set the text path initially (using the DXmNtextPath resource) or
      interactively (see toggle-text-path).
     | 
  
  
    | 
      right-word(extend):
     | 
    
       If this action is called with no argument and the current text path is
       left to right, moves the insertion cursor to the first whitespace
       character or end of line following the next nonwhitespace character. If
       the insertion cursor is already at the end of a word, moves the
       insertion cursor to the end of the next word.
     | 
  
  
    | 
       
     | 
    
      If this action is called with no argument and the current text path is
      right to left, moves the insertion cursor to the first nonwhitespace
      character after the first whitespace character to the left or 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.
     | 
  
  
    | 
       
     | 
    
      If called with
      extend, moves the insertion cursor as in the case of
      no argument and extends the selection.
     | 
  
  
    | 
       
     | 
    
      Set the text path initially (using the DXmNtextPath resource) or
      interactively (see toggle-text-path).
     | 
  
  
    | 
      scroll-one-line-down():
     | 
    
       Scrolls the text area down one line.
     | 
  
  
    | 
      scroll-one-line-up():
     | 
    
       Scrolls the text area up one line.
     | 
  
  
    | 
      secondary-adjust():
     | 
    
       Extends the secondary selection to the pointer position.
     | 
  
  
    | 
      secondary-notify():
     | 
    
       Copies the secondary selection to the destination cursor.
     | 
  
  
    | 
      secondary-start():
     | 
    
       Marks the beginning of a secondary selection.
     | 
  
  
    | 
      select-adjust():
     | 
    
       Extends the selection. The amount of text selected depends on the
       number of mouse clicks, as specified by the XmNselectionArray resource.
     | 
  
  
    | 
      select-all():
     | 
    
       Select all text.
     | 
  
  
    | 
      select-end():
     | 
    
       Extends the selection. The amount of text selected depends on the
       number of mouse clicks, as specified by the XmNselectionArray resource.
     | 
  
  
    | 
      select-start():
     | 
    
       Marks the beginning of a new selection region.
     | 
  
  
    | 
      self-insert():
     | 
    
       If XmNpendingDelete is TRUE and the cursor is inside the selection,
       deletes the entire selection. Inserts the character associated with the
       key pressed at the insertion cursor.
     | 
  
  
    | 
      set-anchor():
     | 
    
       Resets the anchor point for extended selections. Resets the destination
       of secondary selection actions.
     | 
  
  
    | 
      set-insertion-point():
     | 
    
       Sets the insertion point.
     | 
  
  
    | 
      set-selection-hint():
     | 
    
       Sets the text source and location of the selection.
     | 
  
  
    | 
      toggle-add-mode():
     | 
    
       Toggles the state of Add Mode.
     | 
  
  
    | 
      toggle-editing-path-move():
     | 
    
       Toggles the editing path direction.
     | 
  
  
    | 
       
     | 
    
      If the direction is toggled for right to left editing, the insertion
      cursor stays at the current position.
     | 
  
  
    | 
       
     | 
    
      If the direction is toggled for left to right editing, the insertion
      cursor will move to the rightmost position of the previous right to
      left text.
     | 
  
  
    | 
      toggle-editing-path-stay():
     | 
    
       Toggles the editing path direction. The insertion cursor stays at the
       current position.
     | 
  
  
    | 
      toggle-text-path():
     | 
    
       Toggles the text path direction of the entire text. Inverts each
       segment's direction, creating a mirror image of the original text.
     | 
  
  
    | 
      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.
     | 
  
  
    | 
      unkill():
     | 
    
       Restores last killed text to the position of the insertion cursor.
     |