insert

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 select'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 item length 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.

  See also get-styles-sticky.

  
  

• (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.

  
  

• (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.

  
  

• (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.