change-style

Changes the style for items in the editor.

The style within 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-change or on-change-style in text% to monitor style changes.

• (send a-pasteboard change-style style snip) -> void
      style : style<%> object
      snip = #f : snip% object or #f

  Changes the style of snip by applying a style delta. If snip is #f, then all currently selected snips are changed.

  
  

• (send a-pasteboard change-style delta snip) -> void
      delta : style-delta% object
      snip : snip% object

  Changes the style of style to a specific style. The editor's style list must contain style. If snip is #f, then all currently selected snips are changed.

  
  

• (send a-pasteboard change-style delta) -> void
      delta : style-delta% object

  Changes the style of the selected items by applying a style delta.

  To change a large collection of snips from one style to another style, consider providing a style<%> instance rather than a style-delta% instance. Otherwise, change-style must convert the style-delta% instance to the style<%> instance for every snip; this conversion consumes both time and (temporary) memory.

  
  

• (send a-pasteboard change-style style) -> void
      style : style<%> object

  Changes the style of the selected items to a specific style. The editor's style list must contain style, otherwise the style is not changed. See also convert.