Package | mx.core |
Interface | public interface IUITextField extends IIMESupport , IFlexModule , IInvalidating , ISimpleStyleClient , IToolTipManagerClient , IUIComponent , IFlexDisplayObject , IFlexDisplayObject , IBitmapDrawable , IEventDispatcher |
Implementors | UIFTETextField, UITextField |
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Property | Defined By | ||
---|---|---|---|
accessibilityProperties : AccessibilityProperties
The current accessibility options for this display object. | IFlexDisplayObject | ||
alpha : Number
Indicates the alpha transparency value of the object specified. | IFlexDisplayObject | ||
alwaysShowSelection : Boolean
When set to true and the text field is not in focus, Flash Player highlights the
selection in the text field in gray. | IUITextField | ||
antiAliasType : String
The type of anti-aliasing used for this text field. | IUITextField | ||
autoSize : String
Controls automatic sizing and alignment of text fields. | IUITextField | ||
background : Boolean
Specifies whether the text field has a background fill. | IUITextField | ||
backgroundColor : uint
The color of the text field background. | IUITextField | ||
baselinePosition : Number [read-only]
The y-coordinate of the baseline
of the first line of text of the component. | IUIComponent | ||
blendMode : String
A value from the BlendMode class that specifies which blend mode to use. | IFlexDisplayObject | ||
border : Boolean
Specifies whether the text field has a border. | IUITextField | ||
borderColor : uint
The color of the text field border. | IUITextField | ||
bottomScrollV : int [read-only]
An integer (1-based index) that indicates the bottommost line that is currently visible in
the specified text field. | IUITextField | ||
cacheAsBitmap : Boolean
If set to true, Flash runtimes cache an internal bitmap representation of the
display object. | IFlexDisplayObject | ||
caretIndex : int [read-only]
The index of the insertion point (caret) position. | IUITextField | ||
condenseWhite : Boolean
A Boolean value that specifies whether extra white space (spaces, line breaks, and so on)
in a text field with HTML text is removed. | IUITextField | ||
defaultTextFormat : flash.text:TextFormat
Specifies the format applied to newly inserted text, such as text entered by a user or text inserted with the
replaceSelectedText() method. | IUITextField | ||
displayAsPassword : Boolean
Specifies whether the text field is a password text field. | IUITextField | ||
document : Object
A reference to the document object associated with this component. | IUIComponent | ||
doubleClickEnabled : Boolean
Specifies whether the object receives doubleClick events. | IUITextField | ||
embedFonts : Boolean
Specifies whether to render by using embedded font outlines. | IUITextField | ||
enabled : Boolean
Whether the component can accept user interaction. | IUIComponent | ||
enableIME : Boolean [read-only]
Specifies whether the IME should be enabled when
this component has focus. | IIMESupport | ||
explicitHeight : Number
The explicitly specified height for the component,
in pixels, as the component's coordinates. | IUIComponent | ||
explicitMaxHeight : Number [read-only]
Number that specifies the maximum height of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
explicitMaxWidth : Number [read-only]
Number that specifies the maximum width of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
explicitMinHeight : Number [read-only]
Number that specifies the minimum height of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
explicitMinWidth : Number [read-only]
Number that specifies the minimum width of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
explicitWidth : Number
The explicitly specified width for the component,
in pixels, as the component's coordinates. | IUIComponent | ||
filters : Array
An indexed array that contains each filter object currently associated with the display object. | IFlexDisplayObject | ||
focusPane : Sprite
A single Sprite object that is shared among components
and used as an overlay for drawing the focus indicator. | IUIComponent | ||
focusRect : Object
Specifies whether this object displays a focus rectangle. | IUITextField | ||
gridFitType : String
The type of grid fitting used for this text field. | IUITextField | ||
height : Number
Indicates the height of the display object, in pixels. | IFlexDisplayObject | ||
htmlText : String
Contains the HTML representation of the text field contents. | IUITextField | ||
ignorePadding : Boolean
If true, the paddingLeft and
paddingRight styles will not add space
around the text of the component. | IUITextField | ||
imeMode : String
The IME mode of the component. | IIMESupport | ||
includeInLayout : Boolean
Specifies whether this component is included in the layout of the
parent container. | IUIComponent | ||
inheritingStyles : Object
The beginning of this UITextField's chain of inheriting styles. | IUITextField | ||
isPopUp : Boolean
Set to true by the PopUpManager to indicate
that component has been popped up. | IUIComponent | ||
length : int [read-only]
The number of characters in a text field. | IUITextField | ||
loaderInfo : LoaderInfo [read-only]
Returns a LoaderInfo object containing information about loading the file
to which this display object belongs. | IFlexDisplayObject | ||
mask : DisplayObject
The calling display object is masked by the specified mask object. | IFlexDisplayObject | ||
maxChars : int
The maximum number of characters that the text field can contain, as entered by a user. | IUITextField | ||
maxHeight : Number [read-only]
Number that specifies the maximum height of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
maxScrollH : int [read-only]
The maximum value of scrollH. | IUITextField | ||
maxScrollV : int [read-only]
The maximum value of scrollV. | IUITextField | ||
maxWidth : Number [read-only]
Number that specifies the maximum width of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
measuredHeight : Number [read-only]
The measured height of this object. | IFlexDisplayObject | ||
measuredMinHeight : Number
The default minimum height of the component, in pixels. | IUIComponent | ||
measuredMinWidth : Number
The default minimum width of the component, in pixels. | IUIComponent | ||
measuredWidth : Number [read-only]
The measured width of this object. | IFlexDisplayObject | ||
minHeight : Number [read-only]
Number that specifies the minimum height of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
minWidth : Number [read-only]
Number that specifies the minimum width of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
mouseEnabled : Boolean
Specifies whether this object receives mouse, or other user input, messages. | IUITextField | ||
mouseWheelEnabled : Boolean
A Boolean value that indicates whether Flash Player automatically scrolls multiline
text fields when the user clicks a text field and rolls the mouse wheel. | IUITextField | ||
mouseX : Number [read-only]
Indicates the x coordinate of the mouse or user input device position, in pixels. | IFlexDisplayObject | ||
mouseY : Number [read-only]
Indicates the y coordinate of the mouse or user input device position, in pixels. | IFlexDisplayObject | ||
multiline : Boolean
Indicates whether field is a multiline text field. | IUITextField | ||
name : String
Indicates the instance name of the DisplayObject. | IFlexDisplayObject | ||
nestLevel : int
Depth of this object in the containment hierarchy. | IUITextField | ||
nonInheritingStyles : Object
The beginning of this UITextField's chain of non-inheriting styles. | IUITextField | ||
nonZeroTextHeight : Number [read-only]
Unlike textHeight, this returns a non-zero value
even when the text is empty. | IUITextField | ||
numLines : int [read-only]
Defines the number of text lines in a multiline text field. | IUITextField | ||
opaqueBackground : Object
Specifies whether the display object is opaque with a certain background color. | IFlexDisplayObject | ||
owner : DisplayObjectContainer
The owner of this IVisualElement object. | IUIComponent | ||
parent : DisplayObjectContainer [read-only]
Indicates the DisplayObjectContainer object that contains this display object. | IFlexDisplayObject | ||
percentHeight : Number
Number that specifies the height of a component as a
percentage of its parent's size. | IUIComponent | ||
percentWidth : Number
Number that specifies the width of a component as a
percentage of its parent's size. | IUIComponent | ||
restrict : String
Indicates the set of characters that a user can enter into the text field. | IUITextField | ||
root : DisplayObject [read-only]
For a display object in a loaded SWF file, the root property is the
top-most display object in the portion of the display list's tree structure represented by that SWF file. | IFlexDisplayObject | ||
rotation : Number
Indicates the rotation of the DisplayObject instance, in degrees, from its original orientation. | IFlexDisplayObject | ||
scale9Grid : Rectangle
The current scaling grid that is in effect. | IFlexDisplayObject | ||
scaleX : Number
Indicates the horizontal scale (percentage) of the object as applied from the registration point. | IFlexDisplayObject | ||
scaleY : Number
Indicates the vertical scale (percentage) of an object as applied from the registration point of the object. | IFlexDisplayObject | ||
scrollH : int
The current horizontal scrolling position. | IUITextField | ||
scrollRect : Rectangle
The scroll rectangle bounds of the display object. | IFlexDisplayObject | ||
scrollV : int
The vertical position of text in a text field. | IUITextField | ||
selectable : Boolean
A Boolean value that indicates whether the text field is selectable. | IUITextField | ||
selectionBeginIndex : int [read-only]
The zero-based character index value of the first character in the current selection. | IUITextField | ||
selectionEndIndex : int [read-only]
The zero-based character index value of the last character in the current selection. | IUITextField | ||
sharpness : Number
The sharpness of the glyph edges in this text field. | IUITextField | ||
stage : Stage [read-only]
The Stage of the display object. | IFlexDisplayObject | ||
styleName : Object
The source of this object's style values. | ISimpleStyleClient | ||
styleSheet : StyleSheet
Attaches a style sheet to the text field. | IUITextField | ||
systemManager : ISystemManager
A reference to the SystemManager object for this component. | IUIComponent | ||
tabEnabled : Boolean
Specifies whether this object is in the tab order. | IUITextField | ||
tabIndex : int
Specifies the tab ordering of objects in a SWF file. | IUITextField | ||
text : String
A string that is the current text in the text field. | IUITextField | ||
textColor : uint
The color of the text in a text field, in hexadecimal format. | IUITextField | ||
textHeight : Number [read-only]
The height of the text in pixels. | IUITextField | ||
textWidth : Number [read-only]
The width of the text in pixels. | IUITextField | ||
thickness : Number
The thickness of the glyph edges in this text field. | IUITextField | ||
toolTip : String
The text of this component's tooltip. | IToolTipManagerClient | ||
transform : flash.geom:Transform
An object with properties pertaining to a display object's matrix, color transform, and pixel bounds. | IFlexDisplayObject | ||
tweeningProperties : Array
Used by EffectManager. | IUIComponent | ||
type : String
The type of the text field. | IUITextField | ||
useRichTextClipboard : Boolean
Specifies whether to copy and paste the text formatting along with the text. | IUITextField | ||
visible : Boolean
Whether or not the display object is visible. | IFlexDisplayObject | ||
width : Number
Indicates the width of the display object, in pixels. | IFlexDisplayObject | ||
wordWrap : Boolean
A Boolean value that indicates whether the text field has word wrap. | IUITextField | ||
x : Number
Indicates the x coordinate of the DisplayObject instance relative to the local coordinates of
the parent DisplayObjectContainer. | IFlexDisplayObject | ||
y : Number
Indicates the y coordinate of the DisplayObject instance relative to the local coordinates of
the parent DisplayObjectContainer. | IFlexDisplayObject |
Method | Defined By | ||
---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registers an event listener object with an EventDispatcher object so that the listener
receives notification of an event. | IEventDispatcher | ||
Appends the string specified by the newText parameter to the end of the text
of the text field. | IUITextField | ||
Dispatches an event into the event flow. | IEventDispatcher | ||
Returns a rectangle that defines the area of the display object relative to the coordinate system
of the targetCoordinateSpace object. | IFlexDisplayObject | ||
Returns a rectangle that is the bounding box of the character. | IUITextField | ||
Returns the zero-based index value of the character at the point specified by the x
and y parameters. | IUITextField | ||
A convenience method for determining whether to use the
explicit or measured height
| IUIComponent | ||
A convenience method for determining whether to use the
explicit or measured width
| IUIComponent | ||
Given a character index, returns the index of the first character in the same paragraph. | IUITextField | ||
Returns a DisplayObject reference for the given id, for an image or SWF file
that has been added to an HTML-formatted text field by using an <img> tag. | IUITextField | ||
Returns the zero-based index value of the line at the point specified by the x
and y parameters. | IUITextField | ||
Returns the zero-based index value of the line containing the character specified
by the charIndex parameter. | IUITextField | ||
Returns the number of characters in a specific text line. | IUITextField | ||
Returns metrics information about a given text line. | IUITextField | ||
Returns the character index of the first character in the line that
the lineIndex parameter specifies. | IUITextField | ||
Returns the text of the line specified by the lineIndex parameter. | IUITextField | ||
Given a character index, returns the length of the paragraph containing the given character. | IUITextField | ||
Returns a rectangle that defines the boundary of the display object,
based on the coordinate system defined by the targetCoordinateSpace
parameter, excluding any strokes on shapes. | IFlexDisplayObject | ||
Gets a style property that has been set anywhere in this
component's style lookup chain. | IUITextField | ||
Returns a TextFormat object that contains formatting information for the range of text that the
beginIndex and endIndex parameters specify. | IUITextField | ||
Returns a UITextFormat object that contains formatting information for this component. | IUITextField | ||
Converts the point object from the Stage (global) coordinates
to the display object's (local) coordinates. | IFlexDisplayObject | ||
Checks whether the EventDispatcher object has any listeners registered for a specific type
of event. | IEventDispatcher | ||
Evaluates the bounding box of the display object to see if it overlaps or intersects with the
bounding box of the obj display object. | IFlexDisplayObject | ||
Evaluates the display object to see if it overlaps or intersects with the
point specified by the x and y parameters. | IFlexDisplayObject | ||
Initialize the object. | IUIComponent | ||
Calling this method results in a call to the component's
validateDisplayList() method
before the display list is rendered. | IInvalidating | ||
Calling this method results in a call to the component's
validateProperties() method
before the display list is rendered. | IInvalidating | ||
Calling this method results in a call to the component's
validateSize() method
before the display list is rendered. | IInvalidating | ||
Converts the point object from the display object's (local) coordinates to the
Stage (global) coordinates. | IFlexDisplayObject | ||
Moves this object to the specified x and y coordinates. | IFlexDisplayObject | ||
Returns true if the chain of owner properties
points from child to this UIComponent. | IUIComponent | ||
Called by Flex when a UIComponent object is added to or removed from a parent. | IUIComponent | ||
Removes a listener from the EventDispatcher object. | IEventDispatcher | ||
Replaces the current selection with the contents of the value parameter. | IUITextField | ||
Replaces the range of characters that the beginIndex and
endIndex parameters specify with the contents
of the newText parameter. | IUITextField | ||
Sets the actual size of this object. | IFlexDisplayObject | ||
Sets the font color of the text. | IUITextField | ||
Sets the focus to this component. | IUITextField | ||
Sets as selected the text designated by the index values of the
first and last characters, which are specified with the beginIndex
and endIndex parameters. | IUITextField | ||
Applies the text formatting that the format parameter specifies to the specified text in a text field. | IUITextField | ||
Called when the visible property changes. | IUIComponent | ||
Called when the value of a style property is changed. | ISimpleStyleClient | ||
Truncate text to make it fit horizontally in the area defined for the control,
and append an ellipsis, three periods (...), to the text. | IUITextField | ||
Validates and updates the properties and layout of this object
by immediately calling validateProperties(),
validateSize(), and validateDisplayList(),
if necessary. | IInvalidating | ||
Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type. | IEventDispatcher |
alwaysShowSelection | property |
alwaysShowSelection:Boolean
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
When set to true
and the text field is not in focus, Flash Player highlights the
selection in the text field in gray. When set to false
and the text field is not in
focus, Flash Player does not highlight the selection in the text field.
Implementation
public function get alwaysShowSelection():Boolean
public function set alwaysShowSelection(value:Boolean):void
antiAliasType | property |
antiAliasType:String
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The type of anti-aliasing used for this text field. Use flash.text.AntiAliasType
constants for this property. You can control this setting only if the font is
embedded (with the embedFonts
property set to true
).
The default setting is flash.text.AntiAliasType.NORMAL
.
To set values for this property, use the following string values:
String value | Description |
---|---|
flash.text.AntiAliasType.NORMAL | Applies the regular text anti-aliasing. This value matches the type of anti-aliasing that Flash Player 7 and earlier versions used. |
flash.text.AntiAliasType.ADVANCED | Applies advanced anti-aliasing, which makes text more legible. (This feature became available in Flash Player 8.) Advanced anti-aliasing allows for high-quality rendering of font faces at small sizes. It is best used with applications with a lot of small text. Advanced anti-aliasing is not recommended for fonts that are larger than 48 points. |
Implementation
public function get antiAliasType():String
public function set antiAliasType(value:String):void
autoSize | property |
autoSize:String
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Controls automatic sizing and alignment of text fields.
Acceptable values for the TextFieldAutoSize
constants: TextFieldAutoSize.NONE
(the default),
TextFieldAutoSize.LEFT
, TextFieldAutoSize.RIGHT
, and TextFieldAutoSize.CENTER
.
If autoSize
is set to TextFieldAutoSize.NONE
(the default) no resizing occurs.
If autoSize
is set to TextFieldAutoSize.LEFT
, the text is
treated as left-justified text, meaning that the left margin of the text field remains fixed and any
resizing of a single line of the text field is on the right margin. If the text includes a line break
(for example, "\n"
or "\r"
), the bottom is also resized to fit the next
line of text. If wordWrap
is also set to true
, only the bottom
of the text field is resized and the right side remains fixed.
If autoSize
is set to TextFieldAutoSize.RIGHT
, the text is treated as
right-justified text, meaning that the right margin of the text field remains fixed and any resizing
of a single line of the text field is on the left margin. If the text includes a line break
(for example, "\n" or "\r")
, the bottom is also resized to fit the next
line of text. If wordWrap
is also set to true
, only the bottom
of the text field is resized and the left side remains fixed.
If autoSize
is set to TextFieldAutoSize.CENTER
, the text is treated as
center-justified text, meaning that any resizing of a single line of the text field is equally distributed
to both the right and left margins. If the text includes a line break (for example, "\n"
or
"\r"
), the bottom is also resized to fit the next line of text. If wordWrap
is also
set to true
, only the bottom of the text field is resized and the left and
right sides remain fixed.
Implementation
public function get autoSize():String
public function set autoSize(value:String):void
background | property |
background:Boolean
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Specifies whether the text field has a background fill. If true
, the text field has a
background fill. If false
, the text field has no background fill.
Use the backgroundColor
property to set the background color of a text field.
Implementation
public function get background():Boolean
public function set background(value:Boolean):void
backgroundColor | property |
backgroundColor:uint
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The color of the text field background. The default value is 0xFFFFFF
(white).
This property can be retrieved or set, even if there currently is no background, but the
color is visible only if the text field has the background
property set to
true
.
Implementation
public function get backgroundColor():uint
public function set backgroundColor(value:uint):void
border | property |
border:Boolean
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Specifies whether the text field has a border. If true
, the text field has a border.
If false
, the text field has no border. Use the borderColor
property
to set the border color.
Implementation
public function get border():Boolean
public function set border(value:Boolean):void
borderColor | property |
borderColor:uint
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The color of the text field border. The default value is 0x000000
(black).
This property can be retrieved or set, even if there currently is no border, but the
color is visible only if the text field has the border
property set to
true
.
Implementation
public function get borderColor():uint
public function set borderColor(value:uint):void
bottomScrollV | property |
bottomScrollV:int
[read-only] Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
An integer (1-based index) that indicates the bottommost line that is currently visible in
the specified text field. Think of the text field as a window onto a block of text.
The scrollV
property is the 1-based index of the topmost visible line
in the window.
All the text between the lines indicated by scrollV
and bottomScrollV
is currently visible in the text field.
Implementation
public function get bottomScrollV():int
caretIndex | property |
caretIndex:int
[read-only] Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The index of the insertion point (caret) position. If no insertion point is displayed, the value is the position the insertion point would be if you restored focus to the field (typically where the insertion point last was, or 0 if the field has not had focus).
Selection span indexes are zero-based (for example, the first position is 0, the second position is 1, and so on).
Implementation
public function get caretIndex():int
condenseWhite | property |
condenseWhite:Boolean
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
A Boolean value that specifies whether extra white space (spaces, line breaks, and so on)
in a text field with HTML text is removed. The default value is false
.
The condenseWhite
property only affects text set with
the htmlText
property, not the text
property. If you set
text with the text
property, condenseWhite
is ignored.
If condenseWhite
is set to true
, use standard HTML commands such as
<BR>
and <P>
to place line breaks in the text field.
Set the condenseWhite
property before setting the htmlText
property.
Implementation
public function get condenseWhite():Boolean
public function set condenseWhite(value:Boolean):void
defaultTextFormat | property |
defaultTextFormat:flash.text:TextFormat
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Specifies the format applied to newly inserted text, such as text entered by a user or text inserted with the
replaceSelectedText()
method.
Note: When selecting characters to be replaced with setSelection()
and
replaceSelectedText()
, the defaultTextFormat
will be applied only if the
text has been selected up to and including the last character. Here is an example:
var my_txt:TextField new TextField(); my_txt.text = "Flash Macintosh version"; var my_fmt:TextFormat = new TextFormat(); my_fmt.color = 0xFF0000; my_txt.defaultTextFormat = my_fmt; my_txt.setSelection(6,15); // partial text selected - defaultTextFormat not applied my_txt.setSelection(6,23); // text selected to end - defaultTextFormat applied my_txt.replaceSelectedText("Windows version");
When you access the defaultTextFormat
property, the returned TextFormat object has all
of its properties defined. No property is null
.
Note: You can't set this property if a style sheet is applied to the text field.
Implementation
public function get defaultTextFormat():flash.text:TextFormat
public function set defaultTextFormat(value:flash.text:TextFormat):void
displayAsPassword | property |
displayAsPassword:Boolean
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Specifies whether the text field is a password text field. If the value of this property is true
,
the text field is treated as a password text field and hides the input characters using asterisks instead of the
actual characters. If false
, the text field is not treated as a password text field. When password mode
is enabled, the Cut and Copy commands and their corresponding keyboard shortcuts will
not function. This security mechanism prevents an unscrupulous user from using the shortcuts to discover
a password on an unattended computer.
Implementation
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
doubleClickEnabled | property |
doubleClickEnabled:Boolean
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Specifies whether the object receives doubleClick
events. The default value
is false
, which means that by default an InteractiveObject instance does not receive
doubleClick
events. If the doubleClickEnabled
property is set to
true
, the instance receives doubleClick
events within its bounds.
The mouseEnabled
property of the InteractiveObject instance must also be
set to true
for the object to receive doubleClick
events.
No event is dispatched by setting this property. You must use the
addEventListener()
method to add an event listener
for the doubleClick
event.
Implementation
public function get doubleClickEnabled():Boolean
public function set doubleClickEnabled(value:Boolean):void
embedFonts | property |
embedFonts:Boolean
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Specifies whether to render by using embedded font outlines.
If false
, Flash Player renders the text field by using
device fonts.
If you set the embedFonts
property to true
for a text field,
you must specify a font for that text by using the font
property of
a TextFormat object applied to the text field.
If the specified font is not embedded in the SWF file, the text is not displayed.
Implementation
public function get embedFonts():Boolean
public function set embedFonts(value:Boolean):void
focusRect | property |
focusRect:Object
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Specifies whether this object displays a focus rectangle. It can take one of three
values: true
, false
, or null
. Values of true
and false
work as expected, specifying whether or not the focus rectangle
appears. A value of null
indicates that this object obeys the
stageFocusRect
property of the Stage.
Implementation
public function get focusRect():Object
public function set focusRect(value:Object):void
gridFitType | property |
gridFitType:String
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The type of grid fitting used for this text field. This property applies only if the
flash.text.AntiAliasType
property of the text field is set to flash.text.AntiAliasType.ADVANCED
.
The type of grid fitting used determines whether Flash Player forces strong horizontal and vertical lines to fit to a pixel or subpixel grid, or not at all.
For the flash.text.GridFitType
property, you can use the following string values:
String value | Description |
---|---|
flash.text.GridFitType.NONE | Specifies no grid fitting. Horizontal and vertical lines in the glyphs are not forced to the pixel grid. This setting is recommended for animation or for large font sizes. |
flash.text.GridFitType.PIXEL | Specifies that strong horizontal and vertical lines are fit to the
pixel grid. This setting works only for left-aligned text fields.
To use this setting, the flash.dispaly.AntiAliasType property of the text field
must be set to flash.text.AntiAliasType.ADVANCED .
This setting generally provides the best legibility for
left-aligned text. |
flash.text.GridFitType.SUBPIXEL | Specifies that strong horizontal and vertical lines are fit to the subpixel grid on
an LCD monitor. To use this setting, the
flash.text.AntiAliasType property of the text field must be set to
flash.text.AntiAliasType.ADVANCED . The flash.text.GridFitType.SUBPIXEL setting is often good
for right-aligned or centered
dynamic text, and it is sometimes a useful trade-off for animation versus text quality. |
Implementation
public function get gridFitType():String
public function set gridFitType(value:String):void
htmlText | property |
htmlText:String
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Contains the HTML representation of the text field contents.
Flash Player supports the following HTML tags:
Tag | Description |
---|---|
Anchor tag |
The <a> tag creates a hypertext link and supports the following attributes:
|
Bold tag |
The <b> tag renders text as bold. A bold typeface must be available for the font used.
|
Break tag |
The <br> tag creates a line break in the text field. Set the text field to
be a multiline text field to use this tag.
|
Font tag |
The <font> tag specifies a font or list of fonts to display the text.The font tag
supports the following attributes:
|
Image tag |
The <img> tag lets you embed external image files (JPEG, GIF, PNG), SWF files, and
movie clips inside text fields. Text automatically flows around images you embed in text fields. You
must set the text field to be multiline to wrap text around an image.
The
Flash displays media embedded in a text field at full size. To specify the dimensions of the media
you are embedding, use the In general, an image embedded in a text field appears on the line following the
For AIR content in the application security sandbox, AIR ignores |
Italic tag |
The <i> tag displays the tagged text in italics. An italic typeface must be available
for the font used.
|
List item tag |
The <li> tag places a bullet in front of the text that it encloses.
Note: Because Flash Player and AIR do not recognize ordered and unordered list tags (<ol>
and <ul> , they do not modify how your list is rendered. All lists are unordered and all
list items use bullets.
|
Paragraph tag |
The <p> tag creates a new paragraph. The text field must be set to be a multiline
text field to use this tag.
The <p> tag supports the following attributes:
|
Span tag |
The <span> tag is available only for use with CSS text styles. It supports the
following attribute:
|
Text format tag |
The The
|
Underline tag |
The <u> tag underlines the tagged text.
|
Flash Player and AIR support the following HTML entities:
Entity | Description |
---|---|
< | < (less than) |
> | > (greater than) |
& | & (ampersand) |
" | " (double quotes) |
' | ' (apostrophe, single quote) |
Flash Player and AIR also support explicit character codes, such as & (ASCII ampersand) and € (Unicode € symbol).
Implementation
public function get htmlText():String
public function set htmlText(value:String):void
ignorePadding | property |
ignorePadding:Boolean
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
If true
, the paddingLeft
and
paddingRight
styles will not add space
around the text of the component.
Implementation
public function get ignorePadding():Boolean
public function set ignorePadding(value:Boolean):void
inheritingStyles | property |
inheritingStyles:Object
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The beginning of this UITextField's chain of inheriting styles.
The getStyle()
method accesses
inheritingStyles[styleName]
to search the entire
prototype-linked chain.
This object is set up by the initProtoChain()
method.
You typically never need to access this property directly.
Implementation
public function get inheritingStyles():Object
public function set inheritingStyles(value:Object):void
length | property |
maxChars | property |
maxChars:int
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The maximum number of characters that the text field can contain, as entered by a user.
A script can insert more text than maxChars
allows; the maxChars
property
indicates only how much text a user can enter. If the value of this property is 0
,
a user can enter an unlimited amount of text.
Implementation
public function get maxChars():int
public function set maxChars(value:int):void
maxScrollH | property |
maxScrollV | property |
mouseEnabled | property |
mouseEnabled:Boolean
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Specifies whether this object receives mouse, or other user input, messages. The default value is true
,
which means that by default any InteractiveObject instance that is on the display list
receives mouse events or other user input events.
If mouseEnabled
is set to false
, the instance does not receive any
mouse events (or other user input events like keyboard events). Any children of this instance on the display list are not affected. To change
the mouseEnabled
behavior for all children of an object on the display list, use
flash.display.DisplayObjectContainer.mouseChildren
.
No event is dispatched by setting this property. You must use the
addEventListener()
method to create interactive functionality.
Implementation
public function get mouseEnabled():Boolean
public function set mouseEnabled(value:Boolean):void
mouseWheelEnabled | property |
mouseWheelEnabled:Boolean
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
A Boolean value that indicates whether Flash Player automatically scrolls multiline
text fields when the user clicks a text field and rolls the mouse wheel.
By default, this value is true
. This property is useful if you want to prevent
mouse wheel scrolling of text fields, or implement your own text field scrolling.
Implementation
public function get mouseWheelEnabled():Boolean
public function set mouseWheelEnabled(value:Boolean):void
multiline | property |
multiline:Boolean
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Indicates whether field is a multiline text field. If the value is true
,
the text field is multiline; if the value is false
, the text field is a single-line
text field. In a field of type TextFieldType.INPUT
, the multiline
value
determines whether the Enter
key creates a new line (a value of false
,
and the Enter
key is ignored).
If you paste text into a TextField
with a multiline
value of false
,
newlines are stripped out of the text.
Implementation
public function get multiline():Boolean
public function set multiline(value:Boolean):void
nestLevel | property |
nestLevel:int
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Depth of this object in the containment hierarchy. This number is used by the measurement and layout code. The value is 0 if this component is not on the DisplayList.
Implementation
public function get nestLevel():int
public function set nestLevel(value:int):void
nonInheritingStyles | property |
nonInheritingStyles:Object
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The beginning of this UITextField's chain of non-inheriting styles.
The getStyle()
method accesses
nonInheritingStyles[styleName]
method to search the entire
prototype-linked chain.
This object is set up by the initProtoChain()
method.
You typically never need to access this property directly.
Implementation
public function get nonInheritingStyles():Object
public function set nonInheritingStyles(value:Object):void
nonZeroTextHeight | property |
nonZeroTextHeight:Number
[read-only] Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Unlike textHeight, this returns a non-zero value even when the text is empty. In this case, it returns what the textHeight would be if the text weren't empty.
Implementation
public function get nonZeroTextHeight():Number
numLines | property |
numLines:int
[read-only] Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Defines the number of text lines in a multiline text field.
If wordWrap
property is set to true
,
the number of lines increases when text wraps.
Implementation
public function get numLines():int
restrict | property |
restrict:String
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Indicates the set of characters that a user can enter into the text field. If the value of the
restrict
property is null
, you can enter any character. If the value of
the restrict
property is an empty string, you cannot enter any character. If the value
of the restrict
property is a string of characters, you can enter only characters in
the string into the text field. The string is scanned from left to right. You can specify a range by
using the hyphen (-) character. Only user interaction is restricted; a script can put any text into the
text field. This property does not synchronize with the Embed font options
in the Property inspector.
If the string begins with a caret (^) character, all characters are initially accepted and succeeding characters in the string are excluded from the set of accepted characters. If the string does not begin with a caret (^) character, no characters are initially accepted and succeeding characters in the string are included in the set of accepted characters.
The following example allows only uppercase characters, spaces, and numbers to be entered into a text field:
my_txt.restrict = "A-Z 0-9";
The following example includes all characters, but excludes lowercase letters:
my_txt.restrict = "^a-z";
You can use a backslash to enter a ^ or - verbatim. The accepted backslash sequences are \-, \^ or \\. The backslash must be an actual character in the string, so when specified in ActionScript, a double backslash must be used. For example, the following code includes only the dash (-) and caret (^):
my_txt.restrict = "\\-\\^";
The ^ can be used anywhere in the string to toggle between including characters and excluding characters. The following code includes only uppercase letters, but excludes the uppercase letter Q:
my_txt.restrict = "A-Z^Q";
You can use the \u
escape sequence to construct restrict
strings.
The following code includes only the characters from ASCII 32 (space) to ASCII 126 (tilde).
my_txt.restrict = "\u0020-\u007E";
Implementation
public function get restrict():String
public function set restrict(value:String):void
scrollH | property |
scrollH:int
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The current horizontal scrolling position. If the scrollH
property is 0, the text
is not horizontally scrolled. This property value is an integer that represents the horizontal
position in pixels.
The units of horizontal scrolling are pixels, whereas the units of vertical scrolling are lines. Horizontal scrolling is measured in pixels because most fonts you typically use are proportionally spaced; that is, the characters can have different widths. Flash Player performs vertical scrolling by line because users usually want to see a complete line of text rather than a partial line. Even if a line uses multiple fonts, the height of the line adjusts to fit the largest font in use.
Note: The scrollH
property is zero-based, not 1-based like
the scrollV
vertical scrolling property.
Implementation
public function get scrollH():int
public function set scrollH(value:int):void
scrollV | property |
scrollV:int
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The vertical position of text in a text field. The scrollV
property is useful for
directing users to a specific paragraph in a long passage, or creating scrolling text fields.
The units of vertical scrolling are lines, whereas the units of horizontal scrolling are pixels. If the first line displayed is the first line in the text field, scrollV is set to 1 (not 0). Horizontal scrolling is measured in pixels because most fonts are proportionally spaced; that is, the characters can have different widths. Flash performs vertical scrolling by line because users usually want to see a complete line of text rather than a partial line. Even if there are multiple fonts on a line, the height of the line adjusts to fit the largest font in use.
Implementation
public function get scrollV():int
public function set scrollV(value:int):void
selectable | property |
selectable:Boolean
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
A Boolean value that indicates whether the text field is selectable. The value true
indicates that the text is selectable. The selectable
property controls whether
a text field is selectable, not whether a text field is editable. A dynamic text field can
be selectable even if it is not editable. If a dynamic text field is not selectable, the user
cannot select its text.
If selectable
is set to false
, the text in the text field does not
respond to selection commands from the mouse or keyboard, and the text cannot be copied with the
Copy command. If selectable
is set to true
, the text in the text field
can be selected with the mouse or keyboard, and the text can be copied with the Copy command.
You can select text this way even if the text field is a dynamic text field instead of an input text field.
Implementation
public function get selectable():Boolean
public function set selectable(value:Boolean):void
selectionBeginIndex | property |
selectionBeginIndex:int
[read-only] Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The zero-based character index value of the first character in the current selection.
For example, the first character is 0, the second character is 1, and so on. If no
text is selected, this property is the value of caretIndex
.
Implementation
public function get selectionBeginIndex():int
selectionEndIndex | property |
selectionEndIndex:int
[read-only] Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The zero-based character index value of the last character in the current selection.
For example, the first character is 0, the second character is 1, and so on. If no
text is selected, this property is the value of caretIndex
.
Implementation
public function get selectionEndIndex():int
sharpness | property |
sharpness:Number
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The sharpness of the glyph edges in this text field. This property applies
only if the flash.text.AntiAliasType
property of the text field is set to
flash.text.AntiAliasType.ADVANCED
. The range for
sharpness
is a number from -400 to 400. If you attempt to set
sharpness
to a value outside that range, Flash sets the property to
the nearest value in the range (either -400 or 400).
Implementation
public function get sharpness():Number
public function set sharpness(value:Number):void
styleSheet | property |
styleSheet:StyleSheet
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Attaches a style sheet to the text field. For information on creating style sheets, see the StyleSheet class and the ActionScript 3.0 Developer's Guide.
You can change the style sheet associated with a text field at any time. If you change
the style sheet in use, the text field is redrawn with the new style sheet.
You can set the style sheet to null
or undefined
to remove the style sheet. If the style sheet in use is removed, the text field is redrawn without a style sheet.
Note: If the style sheet is removed, the contents of both TextField.text
and
TextField.htmlText
change to incorporate the formatting previously applied by the style sheet. To preserve
the original TextField.htmlText
contents without the formatting, save the value in a variable before
removing the style sheet.
Implementation
public function get styleSheet():StyleSheet
public function set styleSheet(value:StyleSheet):void
tabEnabled | property |
tabEnabled:Boolean
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Specifies whether this object is in the tab order. If this object is in the tab order,
the value is true
; otherwise, the value is false
. By default,
the value is false
, except for the following:
- For a SimpleButton object, the value is
true
. - For a TextField object with
type = "input"
, the value istrue
. - For a Sprite object or MovieClip object with
buttonMode = true
, the value istrue
.
Implementation
public function get tabEnabled():Boolean
public function set tabEnabled(value:Boolean):void
tabIndex | property |
tabIndex:int
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Specifies the tab ordering of objects in a SWF file. The tabIndex
property is -1 by default, meaning no tab index is set for the object.
If any currently displayed object in the SWF file contains a tabIndex
property, automatic
tab ordering is disabled, and the tab ordering is calculated from the tabIndex
properties of
objects in the SWF file. The custom tab ordering includes only objects that have tabIndex
properties.
The tabIndex
property can be a non-negative integer. The objects are ordered according to
their tabIndex
properties, in ascending order. An object with a tabIndex
value of 1 precedes an object with a tabIndex
value of 2. Do not use the same tabIndex
value for multiple objects.
The custom tab ordering that the tabIndex
property defines is flat.
This means that no attention is paid to the hierarchical relationships of objects in the SWF file.
All objects in the SWF file with tabIndex
properties are placed in the tab order, and the
tab order is determined by the order of the tabIndex
values.
Note: To set the tab order for TLFTextField instances, cast the display object child
of the TLFTextField as an InteractiveObject, then set the tabIndex
property. For example:
InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;To reverse the tab order from the default setting for three instances of a TLFTextField object (
tlfInstance1
, tlfInstance2
and tlfInstance3
), use:
InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3; InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2; InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
Implementation
public function get tabIndex():int
public function set tabIndex(value:int):void
text | property |
text:String
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
A string that is the current text in the text field. Lines are separated by the carriage
return character ('\r'
, ASCII 13). This property contains unformatted text in the text
field, without HTML tags.
To get the text in HTML form, use the htmlText
property.
Note: If a style sheet is applied to the text field the content
of the text
property will be interpreted as HTML.
Implementation
public function get text():String
public function set text(value:String):void
textColor | property |
textColor:uint
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The color of the text in a text field, in hexadecimal format.
The hexadecimal color system uses six digits to represent
color values. Each digit has 16 possible values or characters. The characters range from
0-9 and then A-F. For example, black is 0x000000
; white is
0xFFFFFF
.
Implementation
public function get textColor():uint
public function set textColor(value:uint):void
textHeight | property |
textWidth | property |
thickness | property |
thickness:Number
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The thickness of the glyph edges in this text field. This property applies only
when flash.text.AntiAliasType
is set to flash.text.AntiAliasType.ADVANCED
.
The range for thickness
is a number from -200 to 200. If you attempt to
set thickness
to a value outside that range, the property is set to the
nearest value in the range (either -200 or 200).
Implementation
public function get thickness():Number
public function set thickness(value:Number):void
type | property |
type:String
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The type of the text field.
Either one of the following TextFieldType constants: TextFieldType.DYNAMIC
,
which specifies a dynamic text field, which a user cannot edit, or TextFieldType.INPUT
,
which specifies an input text field, which a user can edit.
Implementation
public function get type():String
public function set type(value:String):void
useRichTextClipboard | property |
useRichTextClipboard:Boolean
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Specifies whether to copy and paste the text formatting along with the text. When set to true
,
Flash Player copies and pastes formatting (such as alignment, bold, and italics) when you copy and paste between text fields. Both the origin and destination text fields for the copy and paste procedure must have
useRichTextClipboard
set to true
. The default value
is false
.
Implementation
public function get useRichTextClipboard():Boolean
public function set useRichTextClipboard(value:Boolean):void
wordWrap | property |
wordWrap:Boolean
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
A Boolean value that indicates whether the text field has word wrap. If the value of
wordWrap
is true
, the text field has word wrap;
if the value is false
, the text field does not have word wrap. The default
value is false
.
Implementation
public function get wordWrap():Boolean
public function set wordWrap(value:Boolean):void
appendText | () | method |
public function appendText(newText:String):void
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Appends the string specified by the newText
parameter to the end of the text
of the text field. This method is more efficient than an addition assignment (+=
) on
a text
property (such as someTextField.text += moreText
),
particularly for a text field that contains a significant amount of content.
Parameters
newText:String — The string to append to the existing text.
|
getCharBoundaries | () | method |
public function getCharBoundaries(charIndex:int):Rectangle
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns a rectangle that is the bounding box of the character.
Parameters
charIndex:int — The zero-based index value for the character (for example, the first
position is 0, the second position is 1, and so on).
|
Rectangle — A rectangle with x and y minimum and maximum values
defining the bounding box of the character.
|
getCharIndexAtPoint | () | method |
public function getCharIndexAtPoint(x:Number, y:Number):int
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns the zero-based index value of the character at the point specified by the x
and y
parameters.
Parameters
x:Number — The x coordinate of the character.
| |
y:Number — The y coordinate of the character.
|
int — The zero-based index value of the character (for example, the first position is 0,
the second position is 1, and so on). Returns -1 if the point is not over any character.
|
getFirstCharInParagraph | () | method |
public function getFirstCharInParagraph(charIndex:int):int
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Given a character index, returns the index of the first character in the same paragraph.
Parameters
charIndex:int — The zero-based index value of the character (for example, the first character is 0,
the second character is 1, and so on).
|
int — The zero-based index value of the first character in the same paragraph.
|
getImageReference | () | method |
public function getImageReference(id:String):DisplayObject
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns a DisplayObject reference for the given id
, for an image or SWF file
that has been added to an HTML-formatted text field by using an <img>
tag.
The <img>
tag is in the following format:
<img src = 'filename.jpg' id = 'instanceName' >
Parameters
id:String — The id to match (in the id attribute of the
<img> tag).
|
DisplayObject — The display object corresponding to the image or SWF file with the matching id
attribute in the <img> tag of the text field. For media loaded from an external source,
this object is a Loader object, and, once loaded, the media object is a child of that Loader object. For media
embedded in the SWF file, it is the loaded object. If no <img> tag with
the matching id exists, the method returns null .
|
getLineIndexAtPoint | () | method |
public function getLineIndexAtPoint(x:Number, y:Number):int
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns the zero-based index value of the line at the point specified by the x
and y
parameters.
Parameters
x:Number — The x coordinate of the line.
| |
y:Number — The y coordinate of the line.
|
int — The zero-based index value of the line (for example, the first line is 0, the
second line is 1, and so on). Returns -1 if the point is not over any line.
|
getLineIndexOfChar | () | method |
public function getLineIndexOfChar(charIndex:int):int
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns the zero-based index value of the line containing the character specified
by the charIndex
parameter.
Parameters
charIndex:int — The zero-based index value of the character (for example, the first character is 0,
the second character is 1, and so on).
|
int — The zero-based index value of the line.
|
getLineLength | () | method |
public function getLineLength(lineIndex:int):int
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns the number of characters in a specific text line.
Parameters
lineIndex:int — The line number for which you want the length.
|
int — The number of characters in the line.
|
getLineMetrics | () | method |
public function getLineMetrics(lineIndex:int):flash.text:TextLineMetrics
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns metrics information about a given text line.
Parameters
lineIndex:int — The line number for which you want metrics information.
|
flash.text:TextLineMetrics — A TextLineMetrics object.
|
getLineOffset | () | method |
public function getLineOffset(lineIndex:int):int
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns the character index of the first character in the line that
the lineIndex
parameter specifies.
Parameters
lineIndex:int — The zero-based index value of the line (for example, the first line is 0,
the second line is 1, and so on).
|
int — The zero-based index value of the first character in the line.
|
getLineText | () | method |
public function getLineText(lineIndex:int):String
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns the text of the line specified by the lineIndex
parameter.
Parameters
lineIndex:int — The zero-based index value of the line (for example, the first line is 0,
the second line is 1, and so on).
|
String — The text string contained in the specified line.
|
getParagraphLength | () | method |
public function getParagraphLength(charIndex:int):int
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Given a character index, returns the length of the paragraph containing the given character.
The length is relative to the first character in the paragraph (as returned by
getFirstCharInParagraph()
), not to the character index passed in.
Parameters
charIndex:int — The zero-based index value of the character (for example, the first character is 0,
the second character is 1, and so on).
|
int — Returns the number of characters in the paragraph.
|
getStyle | () | method |
public function getStyle(styleProp:String):*
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
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.
|
* — Style value.
|
getTextFormat | () | method |
public function getTextFormat(beginIndex:int = -1, endIndex:int = -1):flash.text:TextFormat
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns a TextFormat object that contains formatting information for the range of text that the
beginIndex
and endIndex
parameters specify. Only properties
that are common to the entire text specified are set in the resulting TextFormat object.
Any property that is mixed, meaning that it has different values
at different points in the text, has a value of null
.
If you do not specify values for these parameters, this method is applied to all the text in the text field.
The following table describes three possible usages:
Usage | Description |
---|---|
my_textField.getTextFormat() | Returns a TextFormat object containing formatting information for all text in a text field.
Only properties that are common to all text in the text field are set in the resulting TextFormat
object. Any property that is mixed, meaning that it has different values at different
points in the text, has a value of null . |
my_textField.getTextFormat(beginIndex:Number) | Returns a TextFormat object containing a copy of the text format of the character at the
beginIndex position. |
my_textField.getTextFormat(beginIndex:Number,endIndex:Number) | Returns a TextFormat object containing formatting information for the span of
text from beginIndex to endIndex-1 . Only properties that are common
to all of the text in the specified range are set in the resulting TextFormat object. Any property
that is mixed (that is, has different values at different points in the range) has its value set to null . |
Parameters
beginIndex:int (default = -1 ) — Optional; an integer that specifies the starting location of a range of text within the text field.
| |
endIndex:int (default = -1 ) — Optional; an integer that specifies the position of the first character after the desired
text span. As designed, if you specify beginIndex and endIndex values,
the text from beginIndex to endIndex-1 is read.
|
flash.text:TextFormat — The TextFormat object that represents the formatting properties for the specified text.
|
getUITextFormat | () | method |
public function getUITextFormat():mx.core:UITextFormat
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns a UITextFormat object that contains formatting information for this component.
This method is similar to the getTextFormat()
method of the
flash.text.TextField class, but it returns a UITextFormat object instead
of a TextFormat object.
The UITextFormat class extends the TextFormat class to add the text measurement methods
measureText()
and measureHTMLText()
.
mx.core:UITextFormat — An object that contains formatting information for this component.
|
replaceSelectedText | () | method |
public function replaceSelectedText(value:String):void
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Replaces the current selection with the contents of the value
parameter.
The text is inserted at the position of the current selection, using the current default character
format and default paragraph format. The text is not treated as HTML.
You can use the replaceSelectedText()
method to insert and delete text without disrupting
the character and paragraph formatting of the rest of the text.
Note: This method does not work if a style sheet is applied to the text field.
Parameters
value:String — The string to replace the currently selected text.
|
replaceText | () | method |
public function replaceText(beginIndex:int, endIndex:int, newText:String):void
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Replaces the range of characters that the beginIndex
and
endIndex
parameters specify with the contents
of the newText
parameter. As designed, the text from
beginIndex
to endIndex-1
is replaced.
Note: This method does not work if a style sheet is applied to the text field.
Parameters
beginIndex:int — The zero-based index value for the start position of the replacement range.
| |
endIndex:int — The zero-based index position of the first character after the desired
text span.
| |
newText:String — The text to use to replace the specified range of characters.
|
setColor | () | method |
setFocus | () | method |
public function setFocus():void
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Sets the focus to this component. The component can in turn pass focus to a subcomponent.
Note: Only the TextInput and TextArea controls show a highlight when this method sets the focus. All controls show a highlight when the user tabs to the control.
setSelection | () | method |
public function setSelection(beginIndex:int, endIndex:int):void
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Sets as selected the text designated by the index values of the
first and last characters, which are specified with the beginIndex
and endIndex
parameters. If the two parameter values are the same,
this method sets the insertion point, as if you set the
caretIndex
property.
Parameters
beginIndex:int — The zero-based index value of the first character in the selection
(for example, the first character is 0, the second character is 1, and so on).
| |
endIndex:int — The zero-based index value of the last character in the selection.
|
setTextFormat | () | method |
public function setTextFormat(format:flash.text:TextFormat, beginIndex:int = -1, endIndex:int = -1):void
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Applies the text formatting that the format
parameter specifies to the specified text in a text field.
The value of format
must be a TextFormat object that specifies the
desired text formatting changes. Only the non-null properties of format
are applied
to the text field. Any property of format
that is set to null
is not
applied. By default, all of the properties of a newly created TextFormat object are set to null
.
Note: This method does not work if a style sheet is applied to the text field.
The setTextFormat()
method changes the text formatting applied to a range of
characters or to the entire body of text in a text field. To apply the properties of format to all text in the text
field, do not specify values for beginIndex
and endIndex
. To apply the
properties of the format to a range of text, specify values for the beginIndex
and
the endIndex
parameters. You can use the length
property to determine
the index values.
The two types of formatting information in a TextFormat object are character level formatting and paragraph level formatting. Each character in a text field can have its own character formatting settings, such as font name, font size, bold, and italic.
For paragraphs, the first character of the paragraph is examined for the paragraph formatting settings for the entire paragraph. Examples of paragraph formatting settings are left margin, right margin, and indentation.
Any text inserted manually by the user, or replaced by the
replaceSelectedText()
method, receives the default text field formatting for new text,
and not the formatting specified for the text insertion point. To set the default
formatting for new text, use defaultTextFormat
.
Parameters
format:flash.text:TextFormat — A TextFormat object that contains character and paragraph formatting information.
| |||||||||
beginIndex:int (default = -1 ) — Optional; an integer that specifies the zero-based index position specifying the
first character of the desired range of text.
| |||||||||
endIndex:int (default = -1 ) — Optional; an integer that specifies the first character after the desired text span.
As designed, if you specify beginIndex and endIndex values,
the text from beginIndex to endIndex-1 is updated.
Notice that any text inserted manually by the user, or replaced by the
|
truncateToFit | () | method |
public function truncateToFit(truncationIndicator:String = null):Boolean
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Truncate text to make it fit horizontally in the area defined for the control, and append an ellipsis, three periods (...), to the text.
Parameters
truncationIndicator:String (default = null ) — The text to be appended after truncation.
If you pass null , a localizable string
such as "..." will be used.
|
Boolean — true if the text needed truncation.
|
Wed Nov 21 2018, 06:34 AM -08:00