Document revision date: 10 November 2000

Table C-5 further describes the action routines for the DXmCSText widget.

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.

	privacy and legal statement
5635PRO_035.HTML