change-style in pasteboard%

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-style in text% to monitor style changes.

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

  Changes the style of style to a specific style. If snip is #f, then all currently selected snips are changed. The editor's style list must contain style, otherwise the style is not changed. See also convert in style-list%.

  
  

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

  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) -> void
     delta : style-delta% object or #f

  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 or #f

  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 in style-list%.