Packagecom.yworks.canvas.drawing
Classpublic class AbstractTextPaintable
InheritanceAbstractTextPaintable Inheritance Object
Implements IDisplayObjectCreator, IBoundsProvider
Subclasses SimpleTextPaintable

Provides IDisplayObjectCreator implementations for drawing text. This is an abstract class that provides factory methods that each return a concrete subclass of this.



Public Properties
 PropertyDefined By
  text : String
The text to draw.
AbstractTextPaintable
  textFormat : UITextFormat
The text format to use for the text.
AbstractTextPaintable
Public Methods
 MethodDefined By
  
AbstractTextPaintable(textFormat:UITextFormat)
Constructor.
AbstractTextPaintable
  
Returns a tight rectangular area where the whole rendering would fit into.
AbstractTextPaintable
  
create(text:String, textFormat:UITextFormat, location:IPoint):AbstractTextPaintable
[static] Creates a dynamic display object creator that renders the string in its created DisplayObject using the textFormat at the given location.
AbstractTextPaintable
  
AbstractTextPaintable
  
AbstractTextPaintable
  
updateDisplayObject(oldDisplayObject:DisplayObject, context:IDisplayObjectContext):DisplayObject
AbstractTextPaintable
Property Detail
textproperty
text:String

The text to draw.


Implementation
    public function get text():String
    public function set text(value:String):void
textFormatproperty 
textFormat:UITextFormat

The text format to use for the text.


Implementation
    public function get textFormat():UITextFormat
    public function set textFormat(value:UITextFormat):void
Constructor Detail
AbstractTextPaintable()Constructor
public function AbstractTextPaintable(textFormat:UITextFormat)

Constructor. Should only be called from child classes.

Parameters
textFormat:UITextFormat
Method Detail
calculateBounds()method
public function calculateBounds(scratch:IMutableRectangle, ctx:ICanvasContext):IRectangle

Returns a tight rectangular area where the whole rendering would fit into.

Implementations can use the scratch rectangle to put their results in and return it as the result of the operation. Client has to always provide a non-null instance as a parameter. They may however decide to return an internally cached or dynamically created IRectangle implementation and disregard the scratch parameter. If calculating the bounds is too expensive or the painting is not bound to a certain area, this method may return null. If nothing is painted, this method should return an empty rectangle, where either or both the width and height is non-positive or ImmutableRectangle.Empty.

Parameters

scratch:IMutableRectangle — An instance that can optionally be used to fill with the corresponding values and be returned
 
ctx:ICanvasContext — The context to calculate the bounds for (currently not used)

Returns
IRectangle — The bounds or null to indicate an unbound area
create()method 
public static function create(text:String, textFormat:UITextFormat, location:IPoint):AbstractTextPaintable

Creates a dynamic display object creator that renders the string in its created DisplayObject using the textFormat at the given location.

Parameters

text:String — The string to draw.
 
textFormat:UITextFormat — The text format to use.
 
location:IPoint — Where to draw the text (top left anchor).

Returns
AbstractTextPaintable — A dynamic display object creator that renders the text in its created DisplayObject.
createDisplayObject()method 
public function createDisplayObject(context:IDisplayObjectContext):DisplayObject

Parameters

context:IDisplayObjectContext

Returns
DisplayObject
paint()method 
public function paint(g:YGraphics, ctx:IPaintContext):void

Parameters

g:YGraphics
 
ctx:IPaintContext

updateDisplayObject()method 
public function updateDisplayObject(oldDisplayObject:DisplayObject, context:IDisplayObjectContext):DisplayObject

Parameters

oldDisplayObject:DisplayObject
 
context:IDisplayObjectContext

Returns
DisplayObject