Paket | mx.core |
Gränssnitt | public interface IUITextField extends IIMESupport , IFlexModule , IInvalidating , ISimpleStyleClient , IToolTipManagerClient , IUIComponent , IFlexDisplayObject , IFlexDisplayObject , IBitmapDrawable , IEventDispatcher |
Implementorer | UIFTETextField, UITextField |
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Egenskap | Definieras med | ||
---|---|---|---|
accessibilityProperties : AccessibilityProperties
De nuvarande hjälpmedelsalternativen för det här visningsobjektet. | IFlexDisplayObject | ||
alpha : Number
Anger det angivna objektets alfagenomskinlighetsvärde. | IFlexDisplayObject | ||
alwaysShowSelection : Boolean
Om inställningen är true och textfältet inte är i fokus markerar Flash Player markeringen i textfältet med grått. | IUITextField | ||
antiAliasType : String
Den typ av kantutjämning som används för det här textfältet. | IUITextField | ||
autoSize : String
Styr automatisk storleksinställning och justering av textfält. | IUITextField | ||
background : Boolean
Anger om textfältet har en bakgrundsfyllning. | IUITextField | ||
backgroundColor : uint
Färgen på textfältets bakgrund. | IUITextField | ||
baselinePosition : Number [skrivskyddad]
The y-coordinate of the baseline
of the first line of text of the component. | IUIComponent | ||
blendMode : String
Ett värde från klassen BlendMode som anger vilket blandningsläge som ska användas. | IFlexDisplayObject | ||
border : Boolean
Anger om textfältet har en kantlinje. | IUITextField | ||
borderColor : uint
Färgen på textfältets kantlinje. | IUITextField | ||
bottomScrollV : int [skrivskyddad]
Ett heltal (ett 1-baserat indexvärde) som visar den nedersta raden som är synlig i textfältet som anges. | IUITextField | ||
cacheAsBitmap : Boolean
Om det är true, sparar Flash-miljöerna en intern bitmappsrepresentation av visningsobjektet i cache-minnet. | IFlexDisplayObject | ||
caretIndex : int [skrivskyddad]
Indexvärdet för inmatningspunkten. | IUITextField | ||
condenseWhite : Boolean
Ett booleskt värde som anger om extra tomrum (blanksteg, radbrytningar o.s.v.) i ett textfält med HTML-text tas bort. | IUITextField | ||
defaultTextFormat : flash.text:TextFormat
Anger vilket format som ska användas för nyinfogad text, till exempel text som anges av en användare eller text som infogas med metoden replaceSelectedText(). | IUITextField | ||
displayAsPassword : Boolean
Anger om textfältet har ett lösenord. | IUITextField | ||
document : Object
A reference to the document object associated with this component. | IUIComponent | ||
doubleClickEnabled : Boolean
Anger om det här objektet tar emot doubleClick-händelser. | IUITextField | ||
embedFonts : Boolean
Anger om rendering ska göras med inbäddade teckensnittskonturer. | IUITextField | ||
enabled : Boolean
Whether the component can accept user interaction. | IUIComponent | ||
enableIME : Boolean [skrivskyddad]
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 [skrivskyddad]
Number that specifies the maximum height of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
explicitMaxWidth : Number [skrivskyddad]
Number that specifies the maximum width of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
explicitMinHeight : Number [skrivskyddad]
Number that specifies the minimum height of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
explicitMinWidth : Number [skrivskyddad]
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
En indexerad array som innehåller varje filterobjekt som är associerat med visningsobjektet. | 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
Anger om det här objektet visar en fokusram. | IUITextField | ||
gridFitType : String
Den typ av rutnätspassning som används för det här textfältet. | IUITextField | ||
height : Number
Anger visningsobjektets höjd i pixlar. | IFlexDisplayObject | ||
htmlText : String
Innehåller HTML-representationen av textfältets innehåll. | 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 [skrivskyddad]
Antalet tecken i ett textfält. | IUITextField | ||
loaderInfo : LoaderInfo [skrivskyddad]
Returnerar ett LoaderInfo-objekt som innehåller information om hur filen som visningsobjektet tillhör ska läsas in. | IFlexDisplayObject | ||
mask : DisplayObject
Det anropande visningsobjektet maskeras av det angivna visningsobjektet. | IFlexDisplayObject | ||
maxChars : int
Det maximala antal tecken som en användare kan skriva i textfältet. | IUITextField | ||
maxHeight : Number [skrivskyddad]
Number that specifies the maximum height of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
maxScrollH : int [skrivskyddad]
Maxvärdet för scrollH. | IUITextField | ||
maxScrollV : int [skrivskyddad]
Maxvärdet för scrollV. | IUITextField | ||
maxWidth : Number [skrivskyddad]
Number that specifies the maximum width of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
measuredHeight : Number [skrivskyddad]
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 [skrivskyddad]
The measured width of this object. | IFlexDisplayObject | ||
minHeight : Number [skrivskyddad]
Number that specifies the minimum height of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
minWidth : Number [skrivskyddad]
Number that specifies the minimum width of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
mouseEnabled : Boolean
Anger om det här objektet tar emot musmeddelanden eller annan indata från användaren. | IUITextField | ||
mouseWheelEnabled : Boolean
Ett booleskt värde som anger om Flash Player automatiskt ska rulla textfält med flera rader när användaren klickar i ett textfält och rullar på mushjulet. | IUITextField | ||
mouseX : Number [skrivskyddad]
Anger x-koordinaten för musens eller användarens indataenhets position i pixlar. | IFlexDisplayObject | ||
mouseY : Number [skrivskyddad]
Anger y-koordinaten för musens eller användarens indataenhets position i pixlar. | IFlexDisplayObject | ||
multiline : Boolean
Anger om textfältet har flera rader. | IUITextField | ||
name : String
Anger instansnamnet för 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 [skrivskyddad]
Unlike textHeight, this returns a non-zero value
even when the text is empty. | IUITextField | ||
numLines : int [skrivskyddad]
Definierar antalet textrader i ett textfält med flera rader. | IUITextField | ||
opaqueBackground : Object
Anger om visningsobjektet är ogenomskinligt med en viss bakgrundsfärg. | IFlexDisplayObject | ||
owner : DisplayObjectContainer
The owner of this IVisualElement object. | IUIComponent | ||
parent : DisplayObjectContainer [skrivskyddad]
Anger DisplayObjectContainer-objektet som innehåller visningsobjektet. | 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
Anger den teckenuppsättning en användare kan använda för att skriva i textfältet. | IUITextField | ||
root : DisplayObject [skrivskyddad]
För ett visningsobjekt i en inläst SWF-fil är rotegenskapen det översta visningsobjektet i den del av visningslistans trädstruktur som representeras av den SWF-filen. | IFlexDisplayObject | ||
rotation : Number
Anger DisplayObject-instansens rotation i grader från den ursprungliga orienteringen. | IFlexDisplayObject | ||
scale9Grid : Rectangle
Det skalningsrutnät som används för närvarande. | IFlexDisplayObject | ||
scaleX : Number
Anger vågrät skala (i procent) för objektet utifrån dess registreringspunkt. | IFlexDisplayObject | ||
scaleY : Number
Anger lodrät skala (i procent) för objektet utifrån dess registreringspunkt. | IFlexDisplayObject | ||
scrollH : int
Den vågräta rullningspositionen. | IUITextField | ||
scrollRect : Rectangle
Visningsobjektets gränser för rullningsrektangeln. | IFlexDisplayObject | ||
scrollV : int
Den lodräta positionen för texten i ett textfält. | IUITextField | ||
selectable : Boolean
Ett booleskt värde som anger om ett textfält är markeringsbart. | IUITextField | ||
selectionBeginIndex : int [skrivskyddad]
Det nollbaserade teckenindexvärdet för det första tecknet i den aktuella markeringen. | IUITextField | ||
selectionEndIndex : int [skrivskyddad]
Det nollbaserade teckenindexvärdet för det sista tecknet i den aktuella markeringen. | IUITextField | ||
sharpness : Number
Skärpan på specialtecknens kanter i det här textfältet. | IUITextField | ||
stage : Stage [skrivskyddad]
Visningsobjektets scen. | IFlexDisplayObject | ||
styleName : Object
The source of this object's style values. | ISimpleStyleClient | ||
styleSheet : StyleSheet
Kopplar en formatmall till textfältet. | IUITextField | ||
systemManager : ISystemManager
A reference to the SystemManager object for this component. | IUIComponent | ||
tabEnabled : Boolean
Anger om det här objektet inkluderas i tabbordningen. | IUITextField | ||
tabIndex : int
Anger tabbordningen för objekt i en SWF-fil. | IUITextField | ||
text : String
En sträng som utgör den nuvarande texten i textfältet. | IUITextField | ||
textColor : uint
Färgen på texten i ett textfält, i hexadecimalt format. | IUITextField | ||
textHeight : Number [skrivskyddad]
Textens höjd i pixlar. | IUITextField | ||
textWidth : Number [skrivskyddad]
Textens bredd i pixlar. | IUITextField | ||
thickness : Number
Tjockleken på specialtecknens kanter i det här textfältet. | IUITextField | ||
toolTip : String
The text of this component's tooltip. | IToolTipManagerClient | ||
transform : flash.geom:Transform
Ett objekt med egenskaper som gäller ett visningsobjekts matris, färgomformning och pixelgränser. | IFlexDisplayObject | ||
tweeningProperties : Array
Used by EffectManager. | IUIComponent | ||
type : String
Textfältets typ. | IUITextField | ||
useRichTextClipboard : Boolean
Anger om textformateringen ska kopieras och klistras in med texten. | IUITextField | ||
visible : Boolean
Om visingsobjektet är synligt eller inte. | IFlexDisplayObject | ||
width : Number
Anger visningsobjektets bredd i pixlar. | IFlexDisplayObject | ||
wordWrap : Boolean
Ett booleskt värde som anger om textfältet har automatisk radbrytning. | IUITextField | ||
x : Number
Anger x-koordinaten för DisplayObject-instansen i förhållande till de lokala koordinaterna för den överordnade DisplayObjectContainer. | IFlexDisplayObject | ||
y : Number
Anger y-koordinaten för DisplayObject-instansen i förhållande till de lokala koordinaterna för den överordnade DisplayObjectContainer. | IFlexDisplayObject |
Metod | Definieras med | ||
---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registrerar ett händelseavlyssnarobjekt för ett EventDispatcher-objekt så att avlyssnaren får meddelanden om händelser. | IEventDispatcher | ||
Lägger till strängen som angetts av parametern newText på en del av eller all text i ett textfält. | IUITextField | ||
Skickar en händelse till händelseflödet. | IEventDispatcher | ||
Returnerar en rektangel som definierar visningsområdets område i relation till targetCoordinateSpace-objektets koordinatsystem. | IFlexDisplayObject | ||
Returnerar en rektangel som utgör tecknets begränsningsram. | IUITextField | ||
Returnerar det nollbaserade indexvärdet för tecknet vid den punkt som anges av parametrarna x och y. | 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 | ||
Returnerar ett givet teckenindexvärde för det första tecknet i samma stycke. | IUITextField | ||
Returnerar en DisplayObject-referens för det angivna ID:t för en bild eller SWF-fil som har lagts till i ett HTML-formaterat textfält med en <img>-tagg. | IUITextField | ||
Returnerar det nollbaserade indexvärdet för raden vid den punkt som anges av parametrarna x och y. | IUITextField | ||
Returnerar det nollbaserade indexvärdet för raden som innehåller tecknet som anges av parametern charIndex. | IUITextField | ||
Returnerar antalet tecken på en viss textrad. | IUITextField | ||
Returnerar måttinformation om en viss textram. | IUITextField | ||
Returnerar teckenindexvärdet för det första tecknet på raden som anges av parametern lineIndex. | IUITextField | ||
Returnerar texten på raden som anges av parametern lineIndex. | IUITextField | ||
Returnerar längden på det stycke som innehåller ett givet teckenindexvärde. | IUITextField | ||
Returnerar en rektangel som definierar visningsområdets gräns, baserat på koordinatsystemet som definieras av targetCoordinateSpace-parametern, exklusive eventuella linjer i former. | IFlexDisplayObject | ||
Gets a style property that has been set anywhere in this
component's style lookup chain. | IUITextField | ||
Returnerar ett TextFormat-objekt som innehåller formateringsinformation för textintervallet som anges av parametrarna beginIndex och endIndex. | IUITextField | ||
Returns a UITextFormat object that contains formatting information for this component. | IUITextField | ||
Konverterar punktobjektet från scenens (globala) koordinater till visningsobjektets (lokala) koordinater. | IFlexDisplayObject | ||
Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse. | IEventDispatcher | ||
Utvärderar begränsningsramen för visningsobjektet för att kontrollera om den överlappar eller korsar begränsningsramen för obj-visningsobjektet. | IFlexDisplayObject | ||
Utvärderar visningsobjektet för att avgöra om det överlappar eller korsar den punkt som anges av x- och y-parametrarna. | 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 | ||
Konverterar punktobjektet från visningsobjektets (lokala) koordinater till scenens (globala) koordinater. | 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 | ||
Tar bort en avlyssnare från EventDispatcher-objektet. | IEventDispatcher | ||
Ersätter markeringen med innehållet i parametern value. | IUITextField | ||
Ersätter teckenintervallet som anges av parametrarna beginIndex och endIndex med innehållet i parametern newText. | IUITextField | ||
Sets the actual size of this object. | IFlexDisplayObject | ||
Sets the font color of the text. | IUITextField | ||
Sets the focus to this component. | IUITextField | ||
Anges som markerad text som definierats av indexvärdena för det första och sista tecknet, som anges med parametrarna beginIndex och endIndex. | IUITextField | ||
Använder textformateringen som angetts av formatparametern på den angivna texten i ett textfält. | 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 | ||
Kontrollerar om en händelseavlyssnare är registrerad för det här EventDispatcher-objektet eller något av dess överordnade objekt för den angivna händelsetypen. | IEventDispatcher |
alwaysShowSelection | egenskap |
alwaysShowSelection:Boolean
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Om inställningen är true
och textfältet inte är i fokus markerar Flash Player markeringen i textfältet med grått. Om inställningen är false
och textfältet inte är i fokus markerar Flash Player markeringen i textfältet med grått.
Implementering
public function get alwaysShowSelection():Boolean
public function set alwaysShowSelection(value:Boolean):void
antiAliasType | egenskap |
antiAliasType:String
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Den typ av kantutjämning som används för det här textfältet. Använd flash.text.AntiAliasType
-konstanter för den här egenskapen. Du kan bara styra inställningen om teckensnittet är inbäddat (med egenskapen embedFonts
inställd på true
). Standardinställningen är flash.text.AntiAliasType.NORMAL
.
Använd följande strängvärden när du ska ange värden för den här egenskapen:
Strängvärde | Beskrivning |
---|---|
flash.text.AntiAliasType.NORMAL | Använder kantutjämning för vanlig text. Detta värde motsvarar den typ av kantutjämning som används i Flash Player version 7 och tidigare. |
flash.text.AntiAliasType.ADVANCED | Använder avancerad kantutjämning som gör texten mer läsbar. (Funktionen är tillgänglig i Flash Player 8.) Med avancerad kantutjämning kan typsnitt återges med mycket hög kvalitet för små teckenstorlekar. Detta fungerar bäst i program som innehåller stora mängder liten text. Avancerad kantutjämning rekommenderas inte för teckensnitt som är större än 48 punkter. |
Implementering
public function get antiAliasType():String
public function set antiAliasType(value:String):void
autoSize | egenskap |
autoSize:String
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Styr automatisk storleksinställning och justering av textfält. Tillåtna värden för TextFieldAutoSize
-konstanter: TextFieldAutoSize.NONE
(standard), TextFieldAutoSize.LEFT
, TextFieldAutoSize.RIGHT
och TextFieldAutoSize.CENTER
.
Om autoSize
är inställt på TextFieldAutoSize.NONE
(standard) görs ingen storleksändring.
Om autoSize
är inställd på TextFieldAutoSize.LEFT
behandlas texten som vänsterjusterad text, vilket innebär att den vänstra sidan av textfältet förblir fast och eventuell storleksändring av en enstaka rad i textfältet sker på höger sida. Om texten innehåller en radbrytning (till exempel "\n"
eller "\r"
) ändras storleken på den nedersta delen så att den passar med nästa textrad. Om wordWrap
också är inställd på true
ändras storleken bara för den nedersta delen av textfältet, medan högersidan förblir fast.
Om autoSize
är inställd på TextFieldAutoSize.RIGHT
behandlas texten som högerjusterad text, vilket innebär att den högra sidan av textfältet förblir fast och storleksändring av en enstaka rad i textfältet sker på vänster sida. Om texten innehåller en radbrytning (till exempel "\n" eller "\r")
ändras storleken på den nedersta delen så att den passar med nästa textrad. Om wordWrap
också är inställd på true
ändras storleken bara för den nedersta delen av textfältet, medan vänstersidan förblir fast.
Om autoSize
är inställd på TextFieldAutoSize.CENTER
behandlas texten som centrerad text, vilket innebär att en storleksändring av en enstaka rad i textfältet distribueras jämnt på vänster och höger marginal. Om texten innehåller en radbrytning (till exempel "\n"
eller "\r"
) ändras storleken på den nedersta delen så att den passar med nästa textrad. Om wordWrap
också är inställd på true
ändras storleken bara för den nedersta delen av textfältet, medan höger och vänster sida förblir fasta.
Implementering
public function get autoSize():String
public function set autoSize(value:String):void
background | egenskap |
background:Boolean
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Anger om textfältet har en bakgrundsfyllning. Värdet true
innebär att textfältet har en bakgrundsfyllning. Värdet false
innebär att textfältet inte har någon bakgrundsfyllning. Använd egenskapen backgroundColor
för att ställa in bakgrundsfärgen i ett textfält.
Implementering
public function get background():Boolean
public function set background(value:Boolean):void
backgroundColor | egenskap |
backgroundColor:uint
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Färgen på textfältets bakgrund. Standardvärdet är 0xFFFFFF
(vitt). Egenskapen kan hämtas eller ställas in, även om det inte finns någon bakgrund, men färgen är bara synlig om textfältet har egenskapen background
inställd på true
.
Implementering
public function get backgroundColor():uint
public function set backgroundColor(value:uint):void
border | egenskap |
border:Boolean
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Anger om textfältet har en kantlinje. Värdet true
innebär att textfältet har en kantlinje. Värdet false
innebär att textfältet inte har en kantlinje. Använd egenskapen borderColor
för att ställa in kantlinjefärgen.
Implementering
public function get border():Boolean
public function set border(value:Boolean):void
borderColor | egenskap |
borderColor:uint
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Färgen på textfältets kantlinje. Standardvärdet är 0x000000
(svart). Egenskapen kan hämtas eller ställas in, även om det inte finns någon kantlinje, men färgen är bara synlig om textfältet har egenskapen border
inställd på true
.
Implementering
public function get borderColor():uint
public function set borderColor(value:uint):void
bottomScrollV | egenskap |
bottomScrollV:int
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Ett heltal (ett 1-baserat indexvärde) som visar den nedersta raden som är synlig i textfältet som anges. Se textfältet som ett fönster på ett textblock. Egenskapen scrollV
är det ettbaserade indexvärdet i den översta synliga raden i fönstret.
All text mellan raderna som anges av scrollV
och bottomScrollV
är synliga i textfältet.
Implementering
public function get bottomScrollV():int
caretIndex | egenskap |
caretIndex:int
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Indexvärdet för inmatningspunkten. Om ingen inmatningspunkt visas är värdet det läge inmatningspunkten skulle ha om du återställde fokus till fältet (vanligtvis på den plats inmatningspunkten senast var, eller noll om fältet inte haft något fokus).
Index för markeringsomfång är nollbaserade (den första positionen är 0, den andra är 1 och så vidare).
Implementering
public function get caretIndex():int
condenseWhite | egenskap |
condenseWhite:Boolean
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Ett booleskt värde som anger om extra tomrum (blanksteg, radbrytningar o.s.v.) i ett textfält med HTML-text tas bort. Standardvärdet är false
. Egenskapen condenseWhite
påverkar bara text som anges med egenskapen htmlText
, inte med egenskapen text
. Om du anger text med egenskapen text
ignoreras condenseWhite
.
Om du ställer in condenseWhite
på true
måste du använda standard-HTML-kommandon, till exempel <BR>
och <P>
, för att placera radbrytningar i textfältet.
Ställ in egenskapen condenseWhite
innan du ställer in egenskapen htmlText
.
Implementering
public function get condenseWhite():Boolean
public function set condenseWhite(value:Boolean):void
defaultTextFormat | egenskap |
defaultTextFormat:flash.text:TextFormat
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Anger vilket format som ska användas för nyinfogad text, till exempel text som anges av en användare eller text som infogas med metoden replaceSelectedText()
.
Obs! När tecken som ska bytas ut markeras med setSelection()
och replaceSelectedText()
, används defaultTextFormat
endast om texten har markerats upp till och med det sista tecknet. Exempel:
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");
När du kommer åt egenskapen defaultTextFormat
definieras alla egenskaper för TextFormat-objektet som returneras. Ingen egenskap är null
.
Obs! Du kan inte ange den här egenskapen om en formatmall används på textfältet.
Implementering
public function get defaultTextFormat():flash.text:TextFormat
public function set defaultTextFormat(value:flash.text:TextFormat):void
displayAsPassword | egenskap |
displayAsPassword:Boolean
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Anger om textfältet har ett lösenord. Om värdet för egenskapen är true
behandlas textfältet som ett password-textfält som döljer inmatningstecknen med asterisker i stället för de riktiga tecknen. Värdet false
innebär att textfältet inte behandlas som ett password-textfält. När password-läget är aktiverat fungerar inte kommandona Klipp ut och Klistra in eller deras motsvarande kortkommandon. Den här säkerhetstekniken förebygger att obehöriga användare använder genvägar för att ta reda på ett lösenord på en dator som är obevakad.
Implementering
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
doubleClickEnabled | egenskap |
doubleClickEnabled:Boolean
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Anger om det här objektet tar emot doubleClick
-händelser. Standardvärdet är false
, vilket innebär att en InteractiveObject-instans inte tar emot doubleClick
-händelser som standard. Om doubleClickEnabled
-egenskapen står på true
tar instansen emot doubleClick
-händelser inom sina gränser. Egenskapen mouseEnabled
för InteractiveObject-instansen måste också anges som true
för att objektet ska ta emot doubleClick
-händelser.
Ingen händelse skickas när denna egenskap sätts. Du måste använda addEventListener()
-metoden för att lägga till en händelseavlyssnare för doubleClick
-händelsen.
Implementering
public function get doubleClickEnabled():Boolean
public function set doubleClickEnabled(value:Boolean):void
embedFonts | egenskap |
embedFonts:Boolean
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Anger om rendering ska göras med inbäddade teckensnittskonturer. Om det är false
visar Flash Player textfältet med enhetens teckensnitt.
Om du ställer in egenskapen embedFonts
på true
för ett textfält måste du ange ett teckensnitt för den texten med hjälp av font
-egenskapen i ett TextFormat-objekt som tillämpas på textfältet. Om det angivna teckensnittet inte är inbäddat i SWF-filen visas inte texten.
Implementering
public function get embedFonts():Boolean
public function set embedFonts(value:Boolean):void
focusRect | egenskap |
focusRect:Object
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Anger om det här objektet visar en fokusram. Den kan ta ett av tre värden: true
, false
eller null
. Värdena true
och false
fungerar som förväntat och anger om fokusrektangeln visas eller inte. Ett värde på null
anger att detta objekt lyder stageFocusRect
-egenskapen i Stage.
Implementering
public function get focusRect():Object
public function set focusRect(value:Object):void
gridFitType | egenskap |
gridFitType:String
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Den typ av rutnätspassning som används för det här textfältet. Den här egenskapen gäller bara om textfältets flash.text.AntiAliasType
-egenskap är inställd på flash.text.AntiAliasType.ADVANCED
.
Den typ av rutnätspassning som används avgör om Flash Player tvingar tydliga vågräta och lodräta rader att passa till ett pixel- eller delpixelrutnät, eller inte alls.
För egenskapen flash.text.GridFitType
kan du använda följande strängvärden:
Strängvärde | Beskrivning |
---|---|
flash.text.GridFitType.NONE | Ingen rutnätspassning används. Vågräta och lodräta linjer i glyferna tvingas inte till pixelrutnätet. Den här inställningen rekommenderas för animering och för stora teckenstorlekar. |
flash.text.GridFitType.PIXEL | Anger att tydliga vågräta och lodräta linjer ska passas till rutnätet. Inställningen fungerar endast för vänsterjusterade textfält. Om du vill använda den här inställningen måste textfältets flash.dispaly.AntiAliasType -egenskap vara inställd på flash.text.AntiAliasType.ADVANCED . Inställningen ger normalt den bästa läsbarheten för vänsterjusterad text. |
flash.text.GridFitType.SUBPIXEL | Anger att tydliga vågräta och lodräta linjer passas till delpixelrutnätet på en LCD-skärm. Om du vill använda den här inställningen måste textfältets flash.text.AntiAliasType -egenskap vara inställd på flash.text.AntiAliasType.ADVANCED . Inställningen flash.text.GridFitType.SUBPIXEL rekommenderas vid högerjusterad och centrerad dynamisk text. Detta är ibland en praktisk kompromiss mellan animering och textkvalitet. |
Implementering
public function get gridFitType():String
public function set gridFitType(value:String):void
htmlText | egenskap |
htmlText:String
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Innehåller HTML-representationen av textfältets innehåll.
Flash Player stöder följande HTML-taggar:
Tagg | Beskrivning |
---|---|
Ankartagg |
Med <a> -taggen skapas en hypertextlänk och den används med följande attribut:
|
Tagg för fetstil |
Taggen <b> visar text i fetstil. Det måste finnas ett tillgängligt typsnitt för fetstil.
|
Tagg för radbrytning |
Med <br> -taggen skapas en radbrytning i textfältet. För att använda denna tagg måste du ange att textfältet ska innehålla flera rader.
|
Tagg för teckensnitt |
Med <font> -taggen anges ett teckensnitt eller lista med flera teckensnitt för textvisningen. Teckensnittstaggen kan användas med följande attribut:
|
Tagg för bild |
Med <img> -taggen bäddar du in externa bildfiler (JPEG, GIF, PNG), SWF-filer och filmklipp i textfält. Texten visas automatiskt runt de bilder som bäddas in i textfält. Du måste ange att textfältet ska innehålla flera rader för att kunna figursätta texten runt en bild.
Med Flash visas inbäddade medier i ett textfält i full storlek. Om du vill ange dimensionerna på de medier du bäddar in använder du Normalt visas en inbäddad bild i ett textfält på raden efter För AIR-innehåll i programmets säkerhetssandlåda ignoreras |
Tagg för kursiv text |
Taggen <i> visar texten i kursiv stil. Det måste finnas ett tillgängligt teckensnitt för kursiv text.
|
Tagg för punktlista |
Med <li> -taggen placeras en punkttyp framför texten som omfattas. Obs! Eftersom Flash Player och AIR inte kan identifiera numrerade och onumrerade listtaggar (<ol> och <ul> ) påverkar de inte hur din lista visas. I listor är onumrerade och alla listobjekt använder punkter.
|
Tagg för stycke |
Med <p> -taggen skapar du ett nytt stycke. För att använda denna tagg måste textfältet ställas in så att det innehåller flera rader. <p> -taggen kan användas med följande attribut:
|
Tagg för textspann |
<span> -taggen används endast ihop med CSS-textformat. Taggen kan användas med följande attribut:
|
Tagg för textformat |
Med
|
Tagg för understruken text |
Taggen <u> visar texten understruken.
|
Flash Player och AIR stöder följande HTML-entiteter:
Entitet | Beskrivning |
---|---|
< | < (mindre än) |
> | > (större än) |
& | & (et-tecken) |
" | " (dubbla citattecken) |
' | ' (apostrof, enkelt citattecken) |
I Flash Player och AIR stöds även explicita teckenkoder, t.ex. & (et-tecken, ASCII) och € (Unicode, €-symbol).
Implementering
public function get htmlText():String
public function set htmlText(value:String):void
ignorePadding | egenskap |
ignorePadding:Boolean
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
If true
, the paddingLeft
and
paddingRight
styles will not add space
around the text of the component.
Implementering
public function get ignorePadding():Boolean
public function set ignorePadding(value:Boolean):void
inheritingStyles | egenskap |
inheritingStyles:Object
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | 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.
Implementering
public function get inheritingStyles():Object
public function set inheritingStyles(value:Object):void
length | egenskap |
maxChars | egenskap |
maxChars:int
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Det maximala antal tecken som en användare kan skriva i textfältet. Ett skript kan infoga mer text än vad maxChars
tillåter. Egenskapen maxChars
visar bara hur mycket text som en användare kan ange. Om värdet för den här egenskapen är 0
finns det ingen gräns för hur mycket text som en användare kan ange.
Implementering
public function get maxChars():int
public function set maxChars(value:int):void
maxScrollH | egenskap |
maxScrollV | egenskap |
mouseEnabled | egenskap |
mouseEnabled:Boolean
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Anger om det här objektet tar emot musmeddelanden eller annan indata från användaren. Standardvärdet är true
, vilket innebär att varje InteractiveObject-instans som förekommer på visningslistan tar emot mushändelser eller andra indatahändelser från användaren som standard. Om mouseEnabled
är inställt på false
, tar instansen inte emot några mushändelser (eller andra indatahändelser från användaren, t.ex. tangentbordshändelser). Eventuella underordnade till denna instans i visningslistan påverkas inte. För att ändra mouseEnabled
-beteendet för samtliga underordnade till ett objekt i visningslistan använder man flash.display.DisplayObjectContainer.mouseChildren
.
Ingen händelse skickas när denna egenskap sätts. Du måste använda addEventListener()
-metoden för att skapa interaktiv funktionalitet.
Implementering
public function get mouseEnabled():Boolean
public function set mouseEnabled(value:Boolean):void
mouseWheelEnabled | egenskap |
mouseWheelEnabled:Boolean
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Ett booleskt värde som anger om Flash Player automatiskt ska rulla textfält med flera rader när användaren klickar i ett textfält och rullar på mushjulet. Standardvärdet är true
. Egenskapen är användbar om du vill förhindra att mushjulet rullar textfält eller om du vill implementera egen rullning av textfält.
Implementering
public function get mouseWheelEnabled():Boolean
public function set mouseWheelEnabled(value:Boolean):void
multiline | egenskap |
multiline:Boolean
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Anger om textfältet har flera rader. Om värdet är true
har textfältet flera rader. Om värdet är false
har textfältet en rad. I ett fält av typen TextFieldType.INPUT
avgör värdet multiline
om Enter
-tangenten skapar en ny rad (om värdet är false
ignoreras Enter
-tangenten). Om du klistrar in text i TextField
med ett multiline
-värde som är false
tas nya rader bort ur texten.
Implementering
public function get multiline():Boolean
public function set multiline(value:Boolean):void
nestLevel | egenskap |
nestLevel:int
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | 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.
Implementering
public function get nestLevel():int
public function set nestLevel(value:int):void
nonInheritingStyles | egenskap |
nonInheritingStyles:Object
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | 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.
Implementering
public function get nonInheritingStyles():Object
public function set nonInheritingStyles(value:Object):void
nonZeroTextHeight | egenskap |
nonZeroTextHeight:Number
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | 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.
Implementering
public function get nonZeroTextHeight():Number
numLines | egenskap |
numLines:int
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Definierar antalet textrader i ett textfält med flera rader. Om wordWrap
-egenskapen är inställd på true
ökar antalet rader när texten figursätts.
Implementering
public function get numLines():int
restrict | egenskap |
restrict:String
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Anger den teckenuppsättning en användare kan använda för att skriva i textfältet. Om värdet för egenskapen restrict
är null
kan du skriva vilket tecken som helst. Om värdet för egenskapen restrict
är en tom sträng kan du inte skriva vilket tecken som helst. Om värdet för restrict
-egenskapen är en teckensträng kan du bara ange tecknen i strängen i textfältet. Strängen läses från vänster till höger. Du kan ange intervall med hjälp av bindestreck (-). Endast användarinteraktionen är begränsad; ett skript kan lägga in alla slags texter i textfältet. Egenskapen synkroniseras inte med alternativen Bädda in teckensnittskonturer i egenskapsinspektören.
Om strängen börjar med cirkumflexen (^) accepteras alla tecken utom de som anges i strängen. Om strängen inte börjar med cirkumflexen (^) accepteras bara de tecken som anges i strängen.
I följande exempel tillåts bara att stora bokstäver, mellanslag och siffror i ett textfält:
my_txt.restrict = "A-Z 0-9";
I följande exempel tillåts alla tecken utom små bokstäver:
my_txt.restrict = "^a-z";
Du kan använda omvänt snedstreck för att ange ett ^ eller - ordagrant. Sekvenserna med omvänt snedstreck är \-, \^ eller \\. Det omvända snedsträcket måste vara ett faktiskt tecken i strängen. Två omvända snedstreck måste användas i ActionScript. I följande kod finns bara strecket (-) och cirkumflexen (^):
my_txt.restrict = "\\-\\^";
^ kan användas var som helst i strängen för att växla mellan att inkludera och exkludera tecken. I följande exempel tillåts bara stora bokstäver, men stora Q utesluts:
my_txt.restrict = "A-Z^Q";
Du kan använda escape-sekvensen \u
för att skapa restrict
-strängar. I följande kod inkluderas bara tecknen från ASCII 32 (mellanslag) till ASCII 126 (tilde).
my_txt.restrict = "\u0020-\u007E";
Implementering
public function get restrict():String
public function set restrict(value:String):void
scrollH | egenskap |
scrollH:int
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Den vågräta rullningspositionen. Om egenskapen scrollH
är 0 rullas inte texten vågrätt. Egenskapsvärdet är ett heltal som representerar den vågräta positionen i pixlar.
Enheten för vågrät rullning är pixlar, medan enheten för lodrät rullning är rader. Vågrät rullning mäts i pixlar, eftersom de flesta teckensnitten som du använder har proportionella mellanrum. Det innebär att tecknen kan ha olika bredd. Flash Player utför lodrät rullning efter rad, eftersom användare vanligtvis vill se en hel textrad i stället för en ofullständig rad. Även om det finns flera teckensnitt på en rad anpassas radens höjd för att passa det största teckensnittet som används.
Obs! Egenskapen scrollH
är nollbaserad, inte ettbaserad som den lodräta rullningsegenskapen scrollV
.
Implementering
public function get scrollH():int
public function set scrollH(value:int):void
scrollV | egenskap |
scrollV:int
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Den lodräta positionen för texten i ett textfält. Egenskapen scrollV
är användbar när användare vill hitta ett visst stycke i en lång text eller ska skapa rullningsbara textfält.
Enheten för lodrät rullning är rader, medan enheten för vågrät rullning är pixlar. Om den första visade raden är den första raden i textfältet ställs scrollV in på 1 (inte 0). Vågrät rullning mäts i pixlar, eftersom de flesta teckensnitten har proportionella mellanrum. Det innebär att tecknen kan ha olika bredd. Flash utför lodrät rullning efter rad, eftersom användare vanligtvis vill se en hel textrad i stället för en ofullständig rad. Även om det finns flera teckensnitt på en rad anpassas radens höjd för att passa det största teckensnittet som används.
Implementering
public function get scrollV():int
public function set scrollV(value:int):void
selectable | egenskap |
selectable:Boolean
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Ett booleskt värde som anger om ett textfält är markeringsbart. Värdet true
anger att texten är markeringsbar. Egenskapen selectable
kontrollerar om ett textfält är markeringsbart, inte om det är redigeringsbart. Ett dynamiskt textfält kan vara markeringsbart även om det inte är redigeringsbart. Om ett dynamiskt textfält inte är markeringsbart går det inte att markera texten i det.
Om selectable
är inställt på false
svarar inte texten i textfältet på markeringskommandon från musen eller tangentbordet, och texten kan inte kopieras med hjälp av kommandot Kopiera. Om selectable
är inställt på true
kan texten i textfältet markeras med musen eller tangentbordet, och texten kan kopieras med hjälp av kommandot Kopiera. Du kan markera text på det här sättet även om textfältet är dynamiskt i stället för ett textinmatningsfält.
Implementering
public function get selectable():Boolean
public function set selectable(value:Boolean):void
selectionBeginIndex | egenskap |
selectionBeginIndex:int
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Det nollbaserade teckenindexvärdet för det första tecknet i den aktuella markeringen. Det första tecknet är 0, det andra 1 och så vidare. Om ingen text är markerad är värdet för den här egenskapen caretIndex
.
Implementering
public function get selectionBeginIndex():int
selectionEndIndex | egenskap |
selectionEndIndex:int
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Det nollbaserade teckenindexvärdet för det sista tecknet i den aktuella markeringen. Det första tecknet är 0, det andra 1 och så vidare. Om ingen text är markerad är värdet för den här egenskapen caretIndex
.
Implementering
public function get selectionEndIndex():int
sharpness | egenskap |
sharpness:Number
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Skärpan på specialtecknens kanter i det här textfältet. Den här egenskapen gäller bara om textfältets flash.text.AntiAliasType
-egenskap är inställd på flash.text.AntiAliasType.ADVANCED
. Intervallet för sharpness
är ett tal från -400 till 400. Om du försöker ställa in sharpness
på ett värde utanför det intervallet ställer Flash in egenskapen på det närmsta värdet som är i intervallet (antingen -400 eller 400).
Implementering
public function get sharpness():Number
public function set sharpness(value:Number):void
styleSheet | egenskap |
styleSheet:StyleSheet
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Kopplar en formatmall till textfältet. Information om att skapa formatmallar finns i klassen StyleSheet och Utvecklarhandbok för Adobe ActionScript 3.0.
Du kan när som helst byta ut den formatmall som är kopplad till ett textfält. Om formatmallen byts ut ritas textfältet om med den nya formatmallen. Du kan ställa in formatmallen på null
eller undefined
om du vill ta bort formatmallen. Om formatmallen som används tas bort ritas textfältet om utan formatmall.
Obs! Om formatmallen tas bort ändras innehållet i både TextField.text
och TextField.htmlText
till att omfatta den formatering som tidigare använts i formatmallen. Om du vill bevara det ursprungliga TextField.htmlText
-innehållet utan formateringen sparar du värdet i en variabel innan du tar bort formatmallen.
Implementering
public function get styleSheet():StyleSheet
public function set styleSheet(value:StyleSheet):void
tabEnabled | egenskap |
tabEnabled:Boolean
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Anger om det här objektet inkluderas i tabbordningen. Om detta värde är inkluderat i tabbordningen är värdet true
, i annat fall är det false
. Som standard är värdet false
utom i följande fall:
- För ett SimpleButton-objekt är värdet
true
. - För ett TextField-objekt med
typ = "input"
är värdettrue
. - För ett Sprite-objekt eller MovieClip-objekt med
buttonMode = true
är värdettrue
.
Implementering
public function get tabEnabled():Boolean
public function set tabEnabled(value:Boolean):void
tabIndex | egenskap |
tabIndex:int
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Anger tabbordningen för objekt i en SWF-fil. tabIndex
-egenskapen är -1 som standard, vilket innebär att inget tabbindexvärde läggs upp för objektet.
Om ett objekt som visas i SWF-filen innehåller en tabIndex
-egenskap inaktiveras automatisk tabbordning. I stället beräknas tabbordningen från tabIndex
-egenskaperna för objekten i SWF-filen. Den anpassade tabbordningen omfattar bara objekt som har tabIndex
-egenskaper.
Egenskapen tabIndex
måste vara ett positivt heltal. Objekten ordnas efter deras tabIndex
-egenskaper i stigande ordning. Ett objekt med ett tabIndex
-värde på 1 föregår ett objekt med ett tabIndex
-värde på 2. Använd inte samma tabIndex
-värde för flera objekt.
Den anpassade tabbordning som tabIndex
-egenskapen definierar är flat. Det innebär att de hierarkiska förhållandena mellan objekt i SWF-filen inte har någon betydelse. Alla objekt i SWF-filen med tabIndex
-egenskaper placeras i tabbordningen, som bestäms av ordningen för tabIndex
-värden.
Obs! Om du vill ställa in tabbordningen för TLFTextField-instanser, ska du byta underordnat visningsobjekt för TLFTextField till ett InteractiveObject och sedan ställa in egenskapen tabIndex
. Till exempel:
InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;Om du vill ändra tabbordningen från standardinställningen för tre instanser av ett TLFTextField-objekt (
tlfInstance1
, tlfInstance2
och tlfInstance3
), använder du:
InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3; InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2; InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
Implementering
public function get tabIndex():int
public function set tabIndex(value:int):void
text | egenskap |
text:String
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
En sträng som utgör den nuvarande texten i textfältet. Rader avgränsas med vagnreturtecknet ('\r'
, ASCII 13). Den här egenskapen innehåller oformaterad text i textfältet utan HTML-taggar.
Om du vill hämta texten i HTML-format använder du egenskapen htmlText
.
Obs! Om en formatmall används på textfältet tolkas innehållet i egenskapen text
som HTML.
Implementering
public function get text():String
public function set text(value:String):void
textColor | egenskap |
textColor:uint
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Färgen på texten i ett textfält, i hexadecimalt format. I det hexadecimala färgsystemet används sex siffror som representerar färgvärden. Varje siffra har 16 möjliga värden eller tecken. Teckenintervallet går från 0 till -9 och sedan från A till F. Svart är till exempel 0x000000
och vitt är 0xFFFFFF
.
Implementering
public function get textColor():uint
public function set textColor(value:uint):void
textHeight | egenskap |
textWidth | egenskap |
thickness | egenskap |
thickness:Number
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Tjockleken på specialtecknens kanter i det här textfältet. Den här egenskapen gäller bara när flash.text.AntiAliasType
är inställd på flash.text.AntiAliasType.ADVANCED
.
Intervallet för thickness
är ett tal från -200 till 200. Om du försöker ställa in thickness
på ett värde utanför det intervallet ställs egenskapen in på det närmsta värdet som är i intervallet (antingen -200 eller 200).
Implementering
public function get thickness():Number
public function set thickness(value:Number):void
type | egenskap |
type:String
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Textfältets typ. Någon av följande TextFieldType-konstanter: TextFieldType.DYNAMIC
som anger ett dynamiskt textfält som användaren inte kan redigera, eller TextFieldType.INPUT
som anger ett inmatningsfält som användaren kan redigera.
Implementering
public function get type():String
public function set type(value:String):void
useRichTextClipboard | egenskap |
useRichTextClipboard:Boolean
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Anger om textformateringen ska kopieras och klistras in med texten. Om värdet är true
kopierar och klistrar Flash Player in formatering (t.ex. justering, fetstil och kursiv stil) när du kopierar och klistrar in mellan textfält. För både original- och måltextfältet måste useRichTextClipboard
vara inställt på true
. Standardvärdet är false
.
Implementering
public function get useRichTextClipboard():Boolean
public function set useRichTextClipboard(value:Boolean):void
wordWrap | egenskap |
wordWrap:Boolean
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Ett booleskt värde som anger om textfältet har automatisk radbrytning. Om värdet för wordWrap
är true
innehåller textfältet automatisk radbrytning. Är värdet false
innehåller textfältet inte automatisk radbrytning. Standardvärdet är false
.
Implementering
public function get wordWrap():Boolean
public function set wordWrap(value:Boolean):void
appendText | () | metod |
public function appendText(newText:String):void
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Lägger till strängen som angetts av parametern newText
på en del av eller all text i ett textfält. Den här metoden är effektivare än additionstilldelning (+=
) på en text
-egenskap (t.ex. someTextField.text += moreText
), särskilt för ett textfält med mycket innehåll.
Parametrar
newText:String — The string to append to the existing text.
|
getCharBoundaries | () | metod |
public function getCharBoundaries(charIndex:int):Rectangle
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Returnerar en rektangel som utgör tecknets begränsningsram.
Parametrar
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 | () | metod |
public function getCharIndexAtPoint(x:Number, y:Number):int
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Returnerar det nollbaserade indexvärdet för tecknet vid den punkt som anges av parametrarna x
och y
.
Parametrar
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 | () | metod |
public function getFirstCharInParagraph(charIndex:int):int
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Returnerar ett givet teckenindexvärde för det första tecknet i samma stycke.
Parametrar
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 | () | metod |
public function getImageReference(id:String):DisplayObject
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Returnerar en DisplayObject-referens för givet id
för en bild eller SWF-fil som har lagts till i ett HTML-formaterat textfält med en <img>
-tagg. Taggen <img>
har följande format:
<img src = 'filename.jpg' id = 'instanceName' >
Parametrar
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 | () | metod |
public function getLineIndexAtPoint(x:Number, y:Number):int
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Returnerar det nollbaserade indexvärdet för raden vid den punkt som anges av parametrarna x
och y
.
Parametrar
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 | () | metod |
public function getLineIndexOfChar(charIndex:int):int
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Returnerar det nollbaserade indexvärdet för raden som innehåller tecknet som anges av parametern charIndex
.
Parametrar
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 | () | metod |
public function getLineLength(lineIndex:int):int
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Returnerar antalet tecken på en viss textrad.
Parametrar
lineIndex:int — The line number for which you want the length.
|
int — The number of characters in the line.
|
getLineMetrics | () | metod |
public function getLineMetrics(lineIndex:int):flash.text:TextLineMetrics
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Returnerar måttinformation om en viss textram.
Parametrar
lineIndex:int — The line number for which you want metrics information.
|
flash.text:TextLineMetrics — A TextLineMetrics object.
|
getLineOffset | () | metod |
public function getLineOffset(lineIndex:int):int
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Returnerar teckenindexvärdet för det första tecknet på raden som anges av parametern lineIndex
.
Parametrar
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 | () | metod |
public function getLineText(lineIndex:int):String
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Returnerar texten på raden som anges av parametern lineIndex
.
Parametrar
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 | () | metod |
public function getParagraphLength(charIndex:int):int
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Returnerar längden på det stycke som innehåller ett givet teckenindexvärde. Längden anges i förhållande till det första tecknet i stycket (som returneras av getFirstCharInParagraph()
), inte i förhållande till det teckenindexvärde som skickats.
Parametrar
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 | () | metod |
public function getStyle(styleProp:String):*
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | 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.
Parametrar
styleProp:String — Name of the style property.
|
* — Style value.
|
getTextFormat | () | metod |
public function getTextFormat(beginIndex:int = -1, endIndex:int = -1):flash.text:TextFormat
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Returnerar ett TextFormat-objekt som innehåller formateringsinformation för textintervallet som anges av parametrarna beginIndex
och endIndex
. Endast egenskaper som är gemensamma för hela den angivna texten ställs in i det resulterande TextFormat-objektet. Alla egenskaper som är mixed, vilket innebär att de har olika värden på olika ställen i texten, har värdet null
.
Om du inte anger värden för de här parametrarna används metoden på hela texten i textfältet.
I följande tabell beskrivs tre möjliga användningar:
Användning | Beskrivning |
---|---|
my_textField.getTextFormat() | Returnerar ett TextFormat-objekt som innehåller formateringsinformation för all text i ett textfält. Endast egenskaper som är gemensamma för all text i textfältet ställs in i det resulterande TextFormat-objektet. Alla egenskaper som är mixed, vilket innebär att de har olika värden på olika ställen i texten, har värdet null . |
my_textField.getTextFormat(beginIndex:Number) | Returnerar ett TextFormat-objekt som innehåller en kopia av tecknets textformat på positionen beginIndex . |
my_textField.getTextFormat(beginIndex:Number,endIndex:Number) | Returnerar ett TextFormat-objekt som innehåller formateringsinformation för hela textens omfång från beginIndex till endIndex-1 . Endast egenskaper som är gemensamma för all text i det angivna omfånget ställs in i det resulterande TextFormat-objektet. Alla egenskaper som är blandade (har olika värden på olika ställen i omfånget) får värdet null . |
Parametrar
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 | () | metod |
public function getUITextFormat():mx.core:UITextFormat
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | 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 | () | metod |
public function replaceSelectedText(value:String):void
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Ersätter markeringen med innehållet i parametern value
. Texten infogas i markeringens position med standardteckenformatet och standardstyckeformatet. Texten behandlas inte som HTML.
Du kan använda metoden replaceSelectedText()
för att infoga och ta bort text utan att störa tecken- och styckeformateringen i resten av texten.
Obs!Metoden fungerar inte om en formatmall används på textfältet.
Parametrar
value:String — The string to replace the currently selected text.
|
replaceText | () | metod |
public function replaceText(beginIndex:int, endIndex:int, newText:String):void
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Ersätter teckenintervallet som anges av parametrarna beginIndex
och endIndex
med innehållet i parametern newText
. Texten från beginIndex
till endIndex-1
ersätts.
Obs!Metoden fungerar inte om en formatmall används på textfältet.
Parametrar
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 | () | metod |
setFocus | () | metod |
public function setFocus():void
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | 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 | () | metod |
public function setSelection(beginIndex:int, endIndex:int):void
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Anges som markerad text som definierats av indexvärdena för det första och sista tecknet, som anges med parametrarna beginIndex
och endIndex
. Om de två parametervärdena är desamma anger den här metoden en inmatningspunkt, precis som om egenskapen caretIndex
anges.
Parametrar
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 | () | metod |
public function setTextFormat(format:flash.text:TextFormat, beginIndex:int = -1, endIndex:int = -1):void
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Använder textformateringen som angetts av format
-parametern på den angivna texten i ett textfält. Värdet för format
måste vara ett TextFormat-objekt som anger de önskade textformateringsändringarna. Endast de egenskaper som inte har värdet null i format
används på textfältet. Inga format
-egenskaper som är inställda på null
används. Som standard ställs alla egenskaper i ett nyligen skapat TextFormat-objekt in på null
.
Obs!Metoden fungerar inte om en formatmall används på textfältet.
Metoden setTextFormat()
ändrar textformateringen som används för ett intervall med tecken eller för hela texten i ett textfält. Om du vill använda formategenskaperna på all text i textfältet ska du inte ange värden för beginIndex
och endIndex
. Om du vill använda formategenskaperna på ett textintervall anger du värden för parametrarna beginIndex
och endIndex
. Du kan använda length
-egenskapen för att fastställa indexvärden.
De två typerna av formateringsinformation i ett TextFormat-objekt är formatering på teckennivå och på styckenivå. Varje tecken i ett textfält kan ha egna teckenformateringsinställningar, till exempel teckensnittsnamn, teckensnittsstorlek, fet stil och kursiv stil.
I stycken undersöks det första tecknet i stycket för att se om det finns styckeformateringsinställningar för hela stycket. Exempel på styckeformateringsinställningar är vänstermarginal, högermarginal och indrag.
All text som infogas manuellt av användaren eller ersätts med hjälp av metoden replaceSelectedText()
får textfältets standardformatering för ny text, inte formateringen som har angetts för textens inmatningspunkt. Du ställer in standardformateringen för ny text med defaultTextFormat
.
Parametrar
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 | () | metod |
public function truncateToFit(truncationIndicator:String = null):Boolean
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | 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.
Parametrar
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.
|
Tue Jun 12 2018, 01:40 PM Z