insert in text%

Inserts data into the editor.

The content of an editor can be changed by the system in response to other method calls, and such changes do not go through this method; use on-insert in text% or on-insert in pasteboard% to monitor content additions changes.

• (send a-text insert str start end scroll-ok?) -> void
     str : string
     start : exact non-negative integer
     end = 'same : exact non-negative integer or 'same
   scroll-ok? = #t : boolean

  Inserts the text str at position start.

  If end is not 'same, then str replaces the region from start to end, and the selection is left at the end of the inserted text. Otherwise, if the insertion position is before or equal to the selection's start/end position, then the selection's start/end position is incremented by the length of str.

  If scroll-ok? is not #f and start is the same as the current selection's start position, then the editor's display is scrolled to show the new selection position.

  See also get-styles-sticky.

  
  

• (send a-text insert n str start end scroll-ok?) -> void
     n : exact non-negative integer
     str : string
     start : exact non-negative integer
     end = 'same : exact non-negative integer or 'same
   scroll-ok? = #t : boolean

  Inserts the first n characters of str at position start.

  If end is not 'same, then the inserted text replaces the region from start to end, and the selection is left at the end of the inserted text. Otherwise, if the insertion position is before or equal to the selection's start/end position, then the selection's start/end position is incremented by n.

  If scroll-ok? is not #f and start is the same as the current selection's start position, then the editor's display is scrolled to show the new selection position.

  See also get-styles-sticky.

  
  

• (send a-text insert str) -> void
     str : string

  Inserts str at the current selection start position.

  If the current selection covers a range of items, then str replaces the selected text. The selection's starts and end positions are moved to the end of the inserted text.

  The editor's display is scrolled to show the new selection position.

  See also get-styles-sticky.

  
  

• (send a-text insert n str) -> void
     n : exact non-negative integer
     str : string

  Inserts the first n characters of str at the current selection start position.

  If the current selection covers a range of items, then the inserted text replaces the selected text. The selection's start and end positions are moved to the end of the inserted text.

  The editor's display is scrolled to show the new selection position.

  See also get-styles-sticky.

  
  

• (send a-text insert snip start end scroll-ok?) -> void
     snip : snip% object
     start : exact non-negative integer
     end = 'same : exact non-negative integer or 'same
   scroll-ok? = #t : boolean

  Inserts snip into the editor at start. A snip cannot be inserted into multiple editors or multiple times within a single editor.

  If end is not 'same, then snip replaces the region from start to end, and the selection is left at the end of the inserted snip. Otherwise, if the insertion position is before or equal to the selection's start/end position, then the selection's start/end position is incremented by the count of snip.

  If scroll-ok? is not #f and start is the same as the current selection's start position, then the editor's display is scrolled to show the new selection position.

  As the snip is inserted, its current style is converted to one in the editor's style list; see also convert.

  
  

• (send a-text insert snip) -> void
     snip : snip% object

  Inserts snip into the editor at the current selection position. A snip cannot be inserted into multiple editors or multiple times within a single editor.

  If the current selection covers a range of items, then the inserted text replaces the selected text. The selection's start and end positions are moved to the end of the inserted snip.

  The editor's display is scrolled to show the new selection position.

  As the snip is inserted, its current style is converted to one in the editor's style list; see also convert.

  
  

• (send a-text insert char) -> void
     char : character

  Inserts char into the editor at the current selection position.

  If the current selection covers a range of items, then char replaces the selected text. The selection's start and end positions are moved to the end of the inserted character.

  The editor's display is scrolled to show the new selection position.

  See also get-styles-sticky.

  Multiple calls to the character-inserting method are grouped together for undo purposes, since this case of the method is typically used for handling user keystrokes. However, this undo-grouping feature interferes with the undo grouping performed by begin-edit-sequence and end-edit-sequence, so the string-inserting method should be used instead during undoable edit sequences.

  
  

• (send a-text insert char start end) -> void
     char : character
     start : exact non-negative integer
     end = 'same : exact non-negative integer or 'same

  Inserts char into the editor at the position start.

  If end is not 'same, then char replaces the region from start to end, and the selection is left at the end of the inserted text. Otherwise, if the insertion position is before or equal to the selection's start/end position, then the selection's start/end position is incremented by 1.

  If start is the same as the current selection's start position, then the editor's display is scrolled to show the new selection position.

  See also get-styles-sticky.

  Multiple calls to the character-inserting method are grouped together for undo purposes, since this case of the method is typically used for handling user keystrokes. However, this undo-grouping feature interferes with the undo grouping performed by begin-edit-sequence and end-edit-sequence, so the string-inserting method should be used instead during undoable edit sequences.