Pakket | spark.core |
Interface | public interface IEditableText extends IDisplayText , IEventDispatcher |
Geïmplementeerd door | RichEditableText, StyleableStageText, StyleableTextField |
Taalversie: | ActionScript 3.0 |
Productversie: | Flex 4.5 |
Runtimeversies: | Flash Player 10.1, AIR 2.0 |
Eigenschap | Gedefinieerd door | ||
---|---|---|---|
accessibilityProperties : AccessibilityProperties
De huidige toegankelijkheidsopties voor dit weergaveobject. | IEditableText | ||
displayAsPassword : Boolean
Geeft aan of het tekstveld een tekstveld voor wachtwoorden is. | IEditableText | ||
editable : Boolean
Flag that indicates whether the text is editable. | IEditableText | ||
enabled : Boolean
Whether the component can accept user interaction. | IEditableText | ||
focusEnabled : Boolean
Indicates whether the component can receive focus when tabbed to. | IEditableText | ||
horizontalScrollPosition : Number
The horizontal scroll position of the text. | IEditableText | ||
isTruncated : Boolean [alleen-lezen]
A flag that indicates whether the text has been truncated. | IDisplayText | ||
lineBreak : String
Controls word wrapping within the text. | IEditableText | ||
maxChars : int
Het maximum aantal tekens dat het tekstveld kan bevatten (ingevoerd door de gebruiker). | IEditableText | ||
multiline : Boolean
Hiermee wordt aangegeven of het veld een tekstveld met meerdere regels is. | IEditableText | ||
restrict : String
Geeft de set tekens aan die een gebruiker in het tekstveld kan invoeren. | IEditableText | ||
selectable : Boolean
Een booleaanse waarde die aangeeft of het tekstveld kan worden geselecteerd. | IEditableText | ||
selectionActivePosition : int [alleen-lezen]
The active, or last clicked position, of the selection. | IEditableText | ||
selectionAnchorPosition : int [alleen-lezen]
The anchor, or first clicked position, of the selection. | IEditableText | ||
tabIndex : int
Geeft de tabvolgorde van objecten in een SWF-bestand op. | IEditableText | ||
text : String
The text displayed by this text component. | IDisplayText | ||
verticalScrollPosition : Number
The vertical scroll position of the text. | IEditableText |
Methode | Gedefinieerd door | ||
---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt. | IEventDispatcher | ||
Appends the specified text to the end of the text component,
as if you had clicked at the end and typed. | IEditableText | ||
Verzendt een gebeurtenis naar de gebeurtenisstroom. | IEventDispatcher | ||
Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis. | IEventDispatcher | ||
Inserts the specified text into the text component
as if you had typed it. | IEditableText | ||
Verwijdert een listener uit het object EventDispatcher. | IEventDispatcher | ||
Scroll so the specified range is in view. | IEditableText | ||
Selects all of the text. | IEditableText | ||
Selects a specified range of characters. | IEditableText | ||
Set focus to this text field. | IEditableText | ||
Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis. | IEventDispatcher |
accessibilityProperties | eigenschap |
accessibilityProperties:AccessibilityProperties
Taalversie: | ActionScript 3.0 |
Productversie: | Flex 4.5 |
Runtimeversies: | Flash Player 10.1, AIR 2.0 |
De huidige toegankelijkheidsopties voor dit weergaveobject. Wanneer u de eigenschap accessibilityProperties
of een van de velden binnen accessibilityProperties
wijzigt, moet u de methode Accessibility.updateProperties()
aanroepen om ervoor te zorgen dat uw wijzigingen van kracht worden.
Opmerking: voor een object dat in het Flash-ontwerpgereedschap is gemaakt, wordt de waarde van accessibilityProperties
vooraf gevuld met informatie die u in het deelvenster Toegankelijkheid van dat object hebt ingevoerd.
Implementatie
public function get accessibilityProperties():AccessibilityProperties
public function set accessibilityProperties(value:AccessibilityProperties):void
displayAsPassword | eigenschap |
displayAsPassword:Boolean
Taalversie: | ActionScript 3.0 |
Productversie: | Flex 4.5 |
Runtimeversies: | Flash Player 10.1, AIR 2.0 |
Geeft aan of het tekstveld een tekstveld voor wachtwoorden is. Wanneer de waarde van deze eigenschap true
is, wordt het tekstveld behandeld als een tekstveld voor wachtwoorden en worden de invoertekens weergegeven als sterretjes om de echte tekens te verbergen. Wanneer de waarde false
is, wordt het tekstveld niet behandeld als een tekstveld voor wachtwoorden. Wanneer de wachtwoordmodus is ingeschakeld, werken de opdrachten Knippen en Kopiëren en de bijbehorende sneltoetsen niet. Met dit beveiligingsmechanisme wordt voorkomen dat een kwaadwillende gebruiker de sneltoetsen gebruikt om achter een wachtwoord te komen op een onbeheerde computer.
Implementatie
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
editable | eigenschap |
enabled | eigenschap |
enabled:Boolean
Taalversie: | ActionScript 3.0 |
Productversie: | Flex 4.5 |
Runtimeversies: | Flash Player 10.1, AIR 2.0 |
Whether the component can accept user interaction. After setting the enabled
property to false
, some components still respond to mouse interactions such
as mouseOver. As a result, to fully disable UIComponents,
you should also set the value of the mouseEnabled
property to false
.
If you set the enabled
property to false
for a container, Flex dims the color of the container and of all
of its children, and blocks user input to the container
and to all of its children.
Implementatie
public function get enabled():Boolean
public function set enabled(value:Boolean):void
focusEnabled | eigenschap |
focusEnabled:Boolean
Taalversie: | ActionScript 3.0 |
Productversie: | Flex 4.5 |
Runtimeversies: | Flash Player 10.1, AIR 2.0 |
Indicates whether the component can receive focus when tabbed to.
You can set focusEnabled
to false
when a UIComponent is used as a subcomponent of another component
so that the outer component becomes the focusable entity.
If this property is false
, focus is transferred to
the first parent that has focusEnable
set to true
.
The default value is true
, except for the
spark.components.Scroller component.
For that component, the default value is false
.
Implementatie
public function get focusEnabled():Boolean
public function set focusEnabled(value:Boolean):void
horizontalScrollPosition | eigenschap |
horizontalScrollPosition:Number
Taalversie: | ActionScript 3.0 |
Productversie: | Flex 4.5 |
Runtimeversies: | Flash Player 10.1, AIR 2.0 |
The horizontal scroll position of the text.
Implementatie
public function get horizontalScrollPosition():Number
public function set horizontalScrollPosition(value:Number):void
lineBreak | eigenschap |
lineBreak:String
Taalversie: | ActionScript 3.0 |
Productversie: | Flex 4.5 |
Runtimeversies: | Flash Player 10.1, AIR 2.0 |
Controls word wrapping within the text. This property corresponds to the lineBreak style.
Implementatie
public function get lineBreak():String
public function set lineBreak(value:String):void
Verwante API-elementen
maxChars | eigenschap |
maxChars:int
Taalversie: | ActionScript 3.0 |
Productversie: | Flex 4.5 |
Runtimeversies: | Flash Player 10.1, AIR 2.0 |
Het maximum aantal tekens dat het tekstveld kan bevatten (ingevoerd door de gebruiker). Een script kan meer tekst invoegen dan maxChars
toestaat. Met de eigenschap maxChars
wordt slechts aangegeven hoeveel tekst een gebruiker kan invoeren. Wanneer de waarde van deze eigenschap 0
is, kan een gebruiker een onbeperkte hoeveelheid tekst invoeren.
Implementatie
public function get maxChars():int
public function set maxChars(value:int):void
multiline | eigenschap |
multiline:Boolean
Taalversie: | ActionScript 3.0 |
Productversie: | Flex 4.5 |
Runtimeversies: | Flash Player 10.1, AIR 2.0 |
Hiermee wordt aangegeven of het veld een tekstveld met meerdere regels is. Wanneer de waarde true
is, bevat het tekstveld meerdere regels. Wanneer de waarde false
is, bevat het tekstveld slechts één regel. In een veld van het type TextFieldType.INPUT
bepaalt de waarde multiline
of met de toets Enter
een nieuwe regel kan worden gemaakt (wanneer de waarde false
is, wordt de toets Enter
genegeerd). Als u tekst plakt in een TextField
waarvan de waarde multiline
is ingesteld op false
, worden nieuwe regels uit de tekst verwijderd.
Implementatie
public function get multiline():Boolean
public function set multiline(value:Boolean):void
restrict | eigenschap |
restrict:String
Taalversie: | ActionScript 3.0 |
Productversie: | Flex 4.5 |
Runtimeversies: | Flash Player 10.1, AIR 2.0 |
Geeft de set tekens aan die een gebruiker in het tekstveld kan invoeren. Wanneer de waarde van de eigenschap restrict
null
is, kunt u een willekeurig teken invoeren. Wanneer de waarde van de eigenschap restrict
een lege tekenreeks is, kunt u geen willekeurig teken invoeren. Wanneer de waarde van de eigenschap restrict
een reeks tekens is, kunt u alleen tekens in die reeks in het tekstveld invoeren. De tekenreeks wordt van links naar rechts gescand. U kunt een bereik opgeven met het koppelteken (-). Alleen gebruikersinteractie is beperkt; een script kan alle mogelijke tekst in het tekstveld plaatsen. Deze eigenschap synchroniseert niet met de opties voor het insluiten van lettertypen in Eigenschapcontrole.
Wanneer de tekenreeks begint met een invoegteken (^), worden alle tekens eerst geaccepteerd, maar worden de tekens na het invoegteken in de tekenreeks uitgesloten van de set met geaccepteerde tekens. Wanneer de tekenreeks niet begint met een invoegteken (^), worden eerst geen tekens geaccepteerd, maar worden alle tekens in de tekenreeks opgenomen in de set met geaccepteerde tekens.
In het volgende voorbeeld kunnen alleen hoofdletters, spaties en getallen worden ingevoerd in een tekstveld:
my_txt.restrict = "A-Z 0-9";
In het volgende voorbeeld worden alle tekens opgenomen, maar worden twee kleine letters uitgesloten:
my_txt.restrict = "^a-z";
U kunt een backslash gebruiken om de letterlijke tekens ^ of - op te geven. De geaccepteerde backslash-reeksen zijn \-, \^ en \\. De backslash moet een echt teken in de tekenreeks zijn. In ActionScript-code moet dus een dubbele backslash worden gebruikt. De volgende code bevat bijvoorbeeld alleen het streepje (-) en invoegpunt (^):
my_txt.restrict = "\\-\\^";
Het invoegpunt ^ kan overal in de tekenreeks worden gebruikt om te schakelen tussen het opnemen en uitsluiten van tekens. Met de volgende code worden alleen hoofdletters opgenomen, maar wordt de hoofdletter Q uitgesloten:
my_txt.restrict = "A-Z^Q";
Met de escape-reeks \u
kunt u restrict
-tekenreeksen maken. Met de volgende code worden alleen tekens vanaf ASCII 32 (spatie) tot ASCII 126 (tilde) opgenomen.
my_txt.restrict = "\u0020-\u007E";
Implementatie
public function get restrict():String
public function set restrict(value:String):void
selectable | eigenschap |
selectable:Boolean
Taalversie: | ActionScript 3.0 |
Productversie: | Flex 4.5 |
Runtimeversies: | Flash Player 10.1, AIR 2.0 |
Een booleaanse waarde die aangeeft of het tekstveld kan worden geselecteerd. De waarde true
geeft aan dat de tekst kan worden geselecteerd. Met de eigenschap selectable
wordt bepaald of een tekstveld kan worden geselecteerd, niet of een tekstveld kan worden bewerkt. Een dynamisch tekstveld kan ook selecteerbaar zijn wanneer het niet bewerkbaar is. Wanneer een dynamisch tekstveld niet selecteerbaar is, kan de gebruiker de tekst niet selecteren.
Wanneer selectable
is ingesteld op false
, reageert de tekst in het tekstveld niet op selectieopdrachten van de muis of het toetsenbord en kan de tekst niet worden gekopieerd met de opdracht Kopiëren. Wanneer selectable
is ingesteld op true
, kan de tekst in het tekstveld worden geselecteerd met de muis of het toetsenbord en kan de tekst worden gekopieerd met de opdracht Kopiëren. U kunt tekst ook op deze manier selecteren als het tekstveld een dynamisch tekstveld is in plaats van een invoertekstveld.
Implementatie
public function get selectable():Boolean
public function set selectable(value:Boolean):void
selectionActivePosition | eigenschap |
selectionActivePosition:int
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Productversie: | Flex 4.5 |
Runtimeversies: | Flash Player 10.1, AIR 2.0 |
The active, or last clicked position, of the selection. If the implementation does not support selection anchor this is the last character of the selection.
Implementatie
public function get selectionActivePosition():int
selectionAnchorPosition | eigenschap |
selectionAnchorPosition:int
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Productversie: | Flex 4.5 |
Runtimeversies: | Flash Player 10.1, AIR 2.0 |
The anchor, or first clicked position, of the selection. If the implementation does not support selection anchor this is the first character of the selection.
Implementatie
public function get selectionAnchorPosition():int
tabIndex | eigenschap |
tabIndex:int
Taalversie: | ActionScript 3.0 |
Productversie: | Flex 4.5 |
Runtimeversies: | Flash Player 10.1, AIR 2.0 |
Geeft de tabvolgorde van objecten in een SWF-bestand op. De eigenschap tabIndex
is standaard -1. Dit betekent dat er geen tabindex is ingesteld voor het object.
Wanneer een momenteel weergegeven object in het SWF-bestand de eigenschap tabIndex
bevat, wordt automatische tabvolgorde uitgeschakeld en wordt de tabvolgorde berekend op basis van de eigenschappen tabIndex
van objecten in het SWF-bestand. De aangepaste tabvolgorde omvat alleen objecten met eigenschappen tabIndex
.
De eigenschap tabIndex
kan een positief geheel getal zijn. De objecten worden gerangschikt op basis van hun eigenschappen tabIndex
, in oplopende volgorde. Een object met een waarde tabIndex
van 1 komt voor een object met een waarde tabIndex
van 2. Gebruik dezelfde waarde tabIndex
niet voor meerdere objecten.
De aangepaste tabvolgorde die door de eigenschap tabIndex
wordt gedefinieerd, is vlak. Dit betekent dat er geen aandacht wordt besteed aan de hiërarchische relaties van objecten in het SWF-bestand. Alle objecten in het SWF-bestand met eigenschappen tabIndex
worden opgenomen in de tabvolgorde en de tabvolgorde wordt bepaald op basis van de volgorde van de waarden tabIndex
.
Opmerking: als u de tabvolgorde voor instanties TLFTextField wilt instellen, gebruikt u het onderliggende weergaveobject van TLFTextField als InteractiveObject en vervolgens stelt u de eigenschap tabIndex
in. Bijvoorbeeld:
InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;Als u de standaardtabvolgorde wilt omkeren voor de drie instanties van een object TLFTextField (
tlfInstance1
, tlfInstance2
en tlfInstance3
), gebruikt u:
InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3; InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2; InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
Implementatie
public function get tabIndex():int
public function set tabIndex(value:int):void
verticalScrollPosition | eigenschap |
appendText | () | methode |
public function appendText(text:String):void
Taalversie: | ActionScript 3.0 |
Productversie: | Flex 4.5 |
Runtimeversies: | Flash Player 10.1, AIR 2.0 |
Appends the specified text to the end of the text component, as if you had clicked at the end and typed.
An insertion point is then set after the new text. If necessary, the text will scroll to ensure that the insertion point is visible.
Parameters
text:String — The text to be appended.
|
insertText | () | methode |
public function insertText(text:String):void
Taalversie: | ActionScript 3.0 |
Productversie: | Flex 4.5 |
Runtimeversies: | Flash Player 10.1, AIR 2.0 |
Inserts the specified text into the text component as if you had typed it.
If a range was selected, the new text replaces the selected text. If there was an insertion point, the new text is inserted there.
An insertion point is then set after the new text. If necessary, the text will scroll to ensure that the insertion point is visible.
Parameters
text:String — The text to be inserted.
|
scrollToRange | () | methode |
public function scrollToRange(anchorPosition:int, activePosition:int):void
Taalversie: | ActionScript 3.0 |
Productversie: | Flex 4.5 |
Runtimeversies: | Flash Player 10.1, AIR 2.0 |
Scroll so the specified range is in view.
Parameters
anchorPosition:int — The anchor position of the selection range.
| |
activePosition:int — The active position of the selection range.
|
selectAll | () | methode |
public function selectAll():void
Taalversie: | ActionScript 3.0 |
Productversie: | Flex 4.5 |
Runtimeversies: | Flash Player 10.1, AIR 2.0 |
Selects all of the text.
selectRange | () | methode |
public function selectRange(anchorIndex:int, activeIndex:int):void
Taalversie: | ActionScript 3.0 |
Productversie: | Flex 4.5 |
Runtimeversies: | Flash Player 10.1, AIR 2.0 |
Selects a specified range of characters.
If either position is negative, it will deselect the text range.
Parameters
anchorIndex:int — The character position specifying the end
of the selection that stays fixed when the selection is extended.
| |
activeIndex:int — The character position specifying the end
of the selection that moves when the selection is extended.
|
setFocus | () | methode |
public function setFocus():void
Taalversie: | ActionScript 3.0 |
Productversie: | Flex 4.5 |
Runtimeversies: | Flash Player 10.1, AIR 2.0 |
Set focus to this text field.
Wed Jun 13 2018, 11:42 AM Z