Packagespark.components.supportClasses
Classpublic class StyleableTextField
InheritanceStyleableTextField Inheritance FlexTextField Inheritance flash.text.TextField
Implements IEditableText, ISimpleStyleClient, IVisualElement
Subclasses MobileGridTextCellRenderer

Language Version : ActionScript 3.0
Product Version : Flex 4.5
Runtime Versions : AIR 2.5

The StyleableTextField class is a text primitive for use in ActionScript skins and item renderers. It cannot be used in MXML markup and is not compatible with effects.



Public Properties
 PropertyDefined By
  AIR-only editable : Boolean
Specifies whether the text is editable, true, or not, false.
StyleableTextField
  AIR-only enabled : Boolean
Whether the component can accept user interaction.
StyleableTextField
  AIR-only focusEnabled : Boolean
Indicates whether the component can receive focus when tabbed to.
StyleableTextField
  AIR-only horizontalScrollPosition : Number
The horizontal scroll position of the text.
StyleableTextField
  AIR-only isTruncated : Boolean
[read-only] Indicates whether the text has been truncated, true, or not, false.
StyleableTextField
  AIR-only lineBreak : String
Controls word wrapping within the text.
StyleableTextField
  AIR-only minHeight : Number
The minimum recommended height of the component to be considered by the parent during layout.
StyleableTextField
  AIR-only minWidth : Number
The minimum recommended width of the component to be considered by the parent during layout.
StyleableTextField
  AIR-only selectionActivePosition : int
[read-only] The active, or last clicked position, of the selection.
StyleableTextField
  AIR-only selectionAnchorPosition : int
[read-only] The anchor, or first clicked position, of the selection.
StyleableTextField
  AIR-only styleDeclaration : CSSStyleDeclaration
Storage for the inline inheriting styles on this object.
StyleableTextField
  AIR-only styleName : Object
The class style used by this component.
StyleableTextField
  AIR-only text : String
[override] The text displayed by this text component.
StyleableTextField
  AIR-only verticalScrollPosition : Number
The vertical scroll position of the text.
StyleableTextField
Public Methods
 MethodDefined By
  
Constructor.
StyleableTextField
  
AIR-only appendText(text:String):void
[override] Appends the specified text to the end of the text component, as if you had clicked at the end and typed.
StyleableTextField
  
AIR-only commitStyles():void
Commit the styles into the TextField.
StyleableTextField
  
AIR-only getStyle(styleProp:String):*
Gets a style property that has been set anywhere in this component's style lookup chain.
StyleableTextField
  
AIR-only insertText(text:String):void
Inserts the specified text into the text component as if you had typed it.
StyleableTextField
  
AIR-only scrollToRange(anchorPosition:int, activePosition:int):void
Scroll so the specified range is in view.
StyleableTextField
  
AIR-only selectAll():void
Selects all of the text.
StyleableTextField
  
AIR-only selectRange(anchorIndex:int, activeIndex:int):void
Selects a specified range of characters.
StyleableTextField
  
AIR-only setFocus():void
Set focus to this text field.
StyleableTextField
  
AIR-only setStyle(styleProp:String, value:*):void
Sets a style property on this component instance.
StyleableTextField
  
AIR-only styleChanged(styleProp:String):void
Detects changes to style properties.
StyleableTextField
 Inherited
toString():String
[override] Returns a string indicating the location of this object within the hierarchy of DisplayObjects in the Application.
FlexTextField
  
AIR-only truncateToFit(truncationIndicator:String = ...):Boolean
Truncate text to make it fit horizontally in the area defined for the control, and append an ellipsis, three periods (...), to the text.
StyleableTextField
Styles
 Style Description Defined By
  
color
Type: uint Format: Color CSS Inheritance: yes
Color of text in the component, including the component label. The default value for the Halo theme is 0x0B333C. The default value for the Spark theme is 0x000000. The default value for the Mobile theme is 0xFFFFFF.
StyleableTextField
  
fontFamily
Type: String CSS Inheritance: yes
Name of the font to use. Unlike in a full CSS implementation, comma-separated lists are not supported. You can use any font family name. If you specify a generic font name, it is converted to an appropriate device font. The default font for the Halo theme is "Verdana". The default font for the Spark theme is "Arial". The default font for the Mobile theme is "_sans".
StyleableTextField
  
fontSize
Type: Number Format: Length CSS Inheritance: yes
Height of the text, in pixels. In the Halo theme, the default value is 10 for all controls except the ColorPicker control. For the Halo themed ColorPicker control, the default value is 11. In the Spark theme, the default value is 12 for all controls except the ColorPicker control. For the Spark themed ColorPicker control, the default value is 11. The default value for the Mobile theme is 24.
StyleableTextField
  
fontStyle
Type: String CSS Inheritance: yes
Determines whether the text is italic font. Recognized values are "normal" and "italic". The default value is "normal".
StyleableTextField
  
fontWeight
Type: String CSS Inheritance: yes
Determines whether the text is boldface. Recognized values are normal and bold. The default value for Button controls is bold. The default value for all other controls is normal.
StyleableTextField
  
leading
Type: Number Format: Length CSS Inheritance: yes
Additional vertical space between lines of text.

The default value is 0.

StyleableTextField
  
letterSpacing
Type: Number CSS Inheritance: yes
The number of additional pixels to appear between each character. A positive value increases the character spacing beyond the normal spacing, while a negative value decreases it. The default value is 0.
StyleableTextField
  
textAlign
Type: String CSS Inheritance: yes
Alignment of text within a container. Possible values are "left", "right", or "center".

The default value for most components is "left". For the FormItem component, the default value is "right". For the Button, LinkButton, and AccordionHeader components, the default value is "center", and this property is only recognized when the labelPlacement property is set to "left" or "right". If labelPlacement is set to "top" or "bottom", the text and any icon are centered.

StyleableTextField
  
textDecoration
Type: String CSS Inheritance: yes
Determines whether the text is underlined. Possible values are "none" and "underline". The default value is "none".
StyleableTextField
  
textIndent
Type: Number Format: Length CSS Inheritance: yes
Offset of first line of text from the left side of the container, in pixels. This property cannot be a negative number when used with the mobile theme. The default value is 0.
StyleableTextField
Property Detail
AIR-only editableproperty
editable:Boolean

Language Version : ActionScript 3.0
Product Version : Flex 4.5
Runtime Versions : AIR 2.5

Specifies whether the text is editable, true, or not, false.

The default value is true if type is TextFieldType.INPUT, otherwise false..


Implementation
    public function get editable():Boolean
    public function set editable(value:Boolean):void
AIR-only enabledproperty 
enabled:Boolean

Language Version : ActionScript 3.0
Product Version : Flex 4.5
Runtime Versions : AIR 2.5

Whether the component can accept user interaction. After setting the enabled property to false, some components still respond to mouse interactions such as mouseOver. As a result, to fully disable the component, you should also set the value of the mouseEnabled property to false.


Implementation
    public function get enabled():Boolean
    public function set enabled(value:Boolean):void
AIR-only focusEnabledproperty 
focusEnabled:Boolean

Language Version : ActionScript 3.0
Product Version : Flex 4.5
Runtime Versions : AIR 2.5

Indicates whether the component can receive focus when tabbed to. You can set focusEnabled to false when a component is used as a subcomponent of another component so that the outer component becomes the focusable entity. If this property is false, focus is transferred to the first parent that has focusEnable set to true.

The default value is true.


Implementation
    public function get focusEnabled():Boolean
    public function set focusEnabled(value:Boolean):void
AIR-only horizontalScrollPositionproperty 
horizontalScrollPosition:Number

Language Version : ActionScript 3.0
Product Version : Flex 4.5
Runtime Versions : AIR 2.5

The horizontal scroll position of the text.


Implementation
    public function get horizontalScrollPosition():Number
    public function set horizontalScrollPosition(value:Number):void
AIR-only isTruncatedproperty 
isTruncated:Boolean  [read-only]

Language Version : ActionScript 3.0
Product Version : Flex 4.5
Runtime Versions : AIR 2.5

Indicates whether the text has been truncated, true, or not, false.


Implementation
    public function get isTruncated():Boolean
AIR-only lineBreakproperty 
lineBreak:String

Language Version : ActionScript 3.0
Product Version : Flex 4.5
Runtime Versions : AIR 2.5

Controls word wrapping within the text. This property corresponds to the lineBreak style.

Text may be set to fit the width of the container (LineBreak.TO_FIT), or can be set to break only at explicit return or line feed characters (LineBreak.EXPLICIT).

Legal values are flashx.textLayout.formats.LineBreak.EXPLICIT, flashx.textLayout.formats.LineBreak.TO_FIT, and flashx.textLayout.formats.FormatValue.INHERIT.


Implementation
    public function get lineBreak():String
    public function set lineBreak(value:String):void
AIR-only minHeightproperty 
public var minHeight:Number

Language Version : ActionScript 3.0
Product Version : Flex 4.5
Runtime Versions : AIR 2.5

The minimum recommended height of the component to be considered by the parent during layout. This value is in the component's coordinates, in pixels. The default value depends on the component's implementation.

If the application developer sets the value of minHeight, the new value is stored in explicitMinHeight. The default value of minHeight does not change. As a result, at layout time, if minHeight was explicitly set by the application developer, then the value of explicitMinHeight is used for the component's minimum recommended height. If minHeight is not set explicitly by the application developer, then the value of measuredMinHeight is used.

This value is used by the container in calculating the size and position of the component. It is not used by the component itself in determining its default size. Thus this property may not have any effect if parented by Container, or containers that don't factor in this property. Because the value is in component coordinates, the true minHeight with respect to its parent is affected by the scaleY property.

AIR-only minWidthproperty 
public var minWidth:Number

Language Version : ActionScript 3.0
Product Version : Flex 4.5
Runtime Versions : AIR 2.5

The minimum recommended width of the component to be considered by the parent during layout. This value is in the component's coordinates, in pixels. The default value depends on the component's implementation.

If the application developer sets the value of minWidth, the new value is stored in explicitMinWidth. The default value of minWidth does not change. As a result, at layout time, if minWidth was explicitly set by the application developer, then the value of explicitMinWidth is used for the component's minimum recommended width. If minWidth is not set explicitly by the application developer, then the value of measuredMinWidth is used.

This value is used by the container in calculating the size and position of the component. It is not used by the component itself in determining its default size. Thus this property may not have any effect if parented by Container, or containers that don't factor in this property. Because the value is in component coordinates, the true minWidth with respect to its parent is affected by the scaleX property.

AIR-only selectionActivePositionproperty 
selectionActivePosition:int  [read-only]

Language Version : ActionScript 3.0
Product Version : Flex 4.5
Runtime Versions : AIR 2.5

The active, or last clicked position, of the selection. If the implementation does not support selection anchor this is the last character of the selection.


Implementation
    public function get selectionActivePosition():int
AIR-only selectionAnchorPositionproperty 
selectionAnchorPosition:int  [read-only]

Language Version : ActionScript 3.0
Product Version : Flex 4.5
Runtime Versions : AIR 2.5

The anchor, or first clicked position, of the selection. If the implementation does not support selection anchor this is the first character of the selection.


Implementation
    public function get selectionAnchorPosition():int
AIR-only styleDeclarationproperty 
styleDeclaration:CSSStyleDeclaration

Language Version : ActionScript 3.0
Product Version : Flex 4.5
Runtime Versions : AIR 2.5

Storage for the inline inheriting styles on this object. This CSSStyleDeclaration is created the first time that the setStyle() method is called on this component to set an inheriting style. Developers typically never need to access this property directly.


Implementation
    public function get styleDeclaration():CSSStyleDeclaration
    public function set styleDeclaration(value:CSSStyleDeclaration):void
AIR-only styleNameproperty 
styleName:Object

Language Version : ActionScript 3.0
Product Version : Flex 4.5
Runtime Versions : AIR 2.5

The class style used by this component. This should be an IStyleClient.


Implementation
    public function get styleName():Object
    public function set styleName(value:Object):void
AIR-only textproperty 
text:String[override]

Language Version : ActionScript 3.0
Product Version : Flex 4.5
Runtime Versions : AIR 2.5

The text displayed by this text component.

The formatting of this text is controlled by CSS styles. The supported styles depend on the subclass.

The default value is "".


Implementation
    public function get text():String
    public function set text(value:String):void
AIR-only verticalScrollPositionproperty 
verticalScrollPosition:Number

Language Version : ActionScript 3.0
Product Version : Flex 4.5
Runtime Versions : AIR 2.5

The vertical scroll position of the text.


Implementation
    public function get verticalScrollPosition():Number
    public function set verticalScrollPosition(value:Number):void
Constructor Detail
AIR-only StyleableTextField()Constructor
public function StyleableTextField()

Language Version : ActionScript 3.0
Product Version : Flex 4.5
Runtime Versions : AIR 2.5

Constructor.

Method Detail
AIR-only appendText()method
override public function appendText(text:String):void

Language Version : ActionScript 3.0
Product Version : Flex 4.5
Runtime Versions : AIR 2.5

Appends the specified text to the end of the text component, as if you had clicked at the end and typed.

An insertion point is then set after the new text. If necessary, the text will scroll to ensure that the insertion point is visible.

Parameters

text:String — The text to be appended.

AIR-only commitStyles()method 
public function commitStyles():void

Language Version : ActionScript 3.0
Product Version : Flex 4.5
Runtime Versions : AIR 2.5

Commit the styles into the TextField. This method must be called before the text is displayed, and any time the styles have changed. This method does nothing if the styles have already been committed.

AIR-only getStyle()method 
public function getStyle(styleProp:String):*

Language Version : ActionScript 3.0
Product Version : Flex 4.5
Runtime Versions : AIR 2.5

Gets a style property that has been set anywhere in this component's style lookup chain.

This same method is used to get any kind of style property, so the value returned can be a Boolean, String, Number, int, uint (for an RGB color), Class (for a skin), or any kind of object. Therefore the return type is simply specified as *.

If you are getting a particular style property, you know its type and often want to store the result in a variable of that type. No casting from * to that type is necessary.

var backgroundColor:uint = getStyle("backgroundColor");

If the style property has not been set anywhere in the style lookup chain, the value returned by getStyle() is undefined. Note that undefined is a special value that is not the same as false, "", NaN, 0, or null. No valid style value is ever undefined. You can use the method IStyleManager2.isValidStyleValue() to test whether the value was set.

Parameters

styleProp:String — Name of the style property.

Returns
* — Style value.
AIR-only insertText()method 
public function insertText(text:String):void

Language Version : ActionScript 3.0
Product Version : Flex 4.5
Runtime Versions : AIR 2.5

Inserts the specified text into the text component as if you had typed it.

If a range was selected, the new text replaces the selected text. If there was an insertion point, the new text is inserted there.

An insertion point is then set after the new text. If necessary, the text will scroll to ensure that the insertion point is visible.

Parameters

text:String — The text to be inserted.


Throws
Error — This method or property cannot be used on a text field with a style sheet.
AIR-only scrollToRange()method 
public function scrollToRange(anchorPosition:int, activePosition:int):void

Language Version : ActionScript 3.0
Product Version : Flex 4.5
Runtime Versions : AIR 2.5

Scroll so the specified range is in view.

Parameters

anchorPosition:int — The anchor position of the selection range.
 
activePosition:int — The active position of the selection range.

AIR-only selectAll()method 
public function selectAll():void

Language Version : ActionScript 3.0
Product Version : Flex 4.5
Runtime Versions : AIR 2.5

Selects all of the text.

AIR-only selectRange()method 
public function selectRange(anchorIndex:int, activeIndex:int):void

Language Version : ActionScript 3.0
Product Version : Flex 4.5
Runtime Versions : AIR 2.5

Selects a specified range of characters.

If either position is negative, it will deselect the text range.

Parameters

anchorIndex:int — The character position specifying the end of the selection that stays fixed when the selection is extended.
 
activeIndex:int — The character position specifying the end of the selection that moves when the selection is extended.

AIR-only setFocus()method 
public function setFocus():void

Language Version : ActionScript 3.0
Product Version : Flex 4.5
Runtime Versions : AIR 2.5

Set focus to this text field.

AIR-only setStyle()method 
public function setStyle(styleProp:String, value:*):void

Language Version : ActionScript 3.0
Product Version : Flex 4.5
Runtime Versions : AIR 2.5

Sets a style property on this component instance.

This can override a style that was set globally.

Calling the setStyle() method can result in decreased performance. Use it only when necessary.

Parameters

styleProp:String — Name of the style property.
 
value:* — New value for the style.

AIR-only styleChanged()method 
public function styleChanged(styleProp:String):void

Language Version : ActionScript 3.0
Product Version : Flex 4.5
Runtime Versions : AIR 2.5

Detects changes to style properties. When any style property is set, Flex calls the styleChanged() method, passing to it the name of the style being set.

This is an advanced method that you might override when creating a subclass of UIComponent. When you create a custom component, you can override the styleChanged() method to check the style name passed to it, and handle the change accordingly. This lets you override the default behavior of an existing style, or add your own custom style properties.

If you handle the style property, your override of the styleChanged() method should call the invalidateDisplayList() method to cause Flex to execute the component's updateDisplayList() method at the next screen update.

Parameters

styleProp:String — The name of the style property, or null if all styles for this component have changed.

AIR-only truncateToFit()method 
public function truncateToFit(truncationIndicator:String = ...):Boolean

Language Version : ActionScript 3.0
Product Version : Flex 4.5
Runtime Versions : AIR 2.5

Truncate text to make it fit horizontally in the area defined for the control, and append an ellipsis, three periods (...), to the text. This function only works for single line text.

Parameters

truncationIndicator:String (default = ...) — The text to be appended after truncation. If you pass null, a localizable string such as "..." will be used.

Returns
Booleantrue if the text needed truncation.