Pakket | flash.text |
Klasse | public final class StageText |
Overerving | StageText EventDispatcher Object |
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Met deze klasse kunnen mobiele toepassingen gebruikersinvoer vergaren met gebruik van de native besturingselementen voor tekstinvoer op mobiele apparaten. Besturingselementen op mobiele apparaten hebben vaak uitgebreide gebruikersinterfaces en bieden ondersteuning voor vele functies die niet mogelijk zijn op desktops. Veel mobiele apparaten bieden bijvoorbeeld ondersteuning voor de volgende functies voor tekstinvoer:
- automatisch invullen
- automatisch corrigeren
- op aanraking gebaseerde tekstselectie
- aanpasbare schermtoetsenborden
Het onderliggende besturingssysteem (of een componentenbibliotheek die is gebundeld met het besturingssysteem) tekent native tekstinvoervelden. Native tekstinvoervelden vormen een vertrouwde ervaring voor gebruikers die andere toepassingen op hetzelfde apparaat hebben gebruikt. Het is echter niet mogelijk ingesloten lettertypen te gebruiken, aangezien de tekstinvoervelden niet door de player maar door het besturingssysteem worden getekend.
AIR-profielondersteuning: deze functie wordt ondersteund op iOS- en Android-platforms. StageText gebruikt native tekstinvoervelden op mobiele apparaten met Android of iOS. Op andere platformen maakt StageText gebruik van het Flash Runtime TextField.
Wanneer native invoer wordt gebruikt, zijn StageText-objecten geen weergaveobjecten en kunnen ze niet aan de weergavelijst van Flash worden toegevoegd. In plaats hiervan kunt u een StageText-object weergeven door het object rechtstreeks via de eigenschap stage
te koppelen aan een werkgebied. De StageText-instantie die aan een werkgebied is gekoppeld, wordt boven op andere Flash-weergaveobjecten weergegeven. Met de eigenschap viewPort
bepaalt u de grootte en de positie van het renderinggebied. De dieptevolgorde van de verschillende StageText-objecten kan niet worden ingesteld. Het wordt niet aanbevolen om twee instanties te laten overlappen.
Wanneer een StageText-object de focus heeft, heeft het object de eerste gelegenheid om toetsenbordinvoer af te handelen. Het werkgebied waaraan het StageText-object is gekoppeld, verzendt geen toetsenbordinvoergebeurtenissen.
Aangezien de StageText-klasse op elk platform een ander native besturingselementen insluit, worden de functies van deze klasse in verschillende mate ondersteund op elk platform. Functies die worden ondersteund, gedragen zich wellicht niet op elk platform hetzelfde. Wanneer u een specifieke functie op een specifiek platform probeert te gebruiken, kunt u het gedrag het best testen. Alleen op bureaubladplatformen waar native besturingselementen niet worden gebruikt, zal het StageText-gedrag overeenkomen met het Flash-runtimetekstgedrag.
Op Apple TV is de focus standaard gericht op StageText. Om de focus tussen verschillende objecten in uw toepassing te beheren, moet u rekening houden met de onderstaande punten:
- Als u de standaardfocus van StageText wilt overschrijven, of de focus wilt toewijzen aan een ander weergaveobject, gebruikt u stage.focus
- Om de focus toe te wijzen aan StageText gebruikt u stageText.assignFocus()
Eigenschap | Gedefinieerd door | ||
---|---|---|---|
autoCapitalize : String
Bepaalt hoe een apparaat automatisch hoofdlettergebruik toepast op gebruikersinvoer. | StageText | ||
autoCorrect : Boolean
Geeft aan of een apparaat fouten in de spelling of interpunctie in gebruikersinvoer automatisch corrigeert. | StageText | ||
clearButtonMode : String [alleen-schrijven]
De clearButton-modus voor het huidige StageText-object. | StageText | ||
color : uint
Geeft de tekstkleur op. | StageText | ||
constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | ||
displayAsPassword : Boolean
Geeft aan of het tekstveld een wachtwoordtekstveld is. | StageText | ||
editable : Boolean
Geeft aan of de gebruiker het tekstveld kan bewerken. | StageText | ||
fontFamily : String
Verwijst naar de naam van de huidige lettertypefamilie. | StageText | ||
fontPosture : String
Geeft de tekenstand aan met gebruik van constanten die zijn gedefinieerd in de klasse FontPosture. | StageText | ||
fontSize : int
De grootte van de huidige lettertypefamilie, uitgedrukt in pixels. | StageText | ||
fontWeight : String
Geeft de tekendikte aan door middel van constanten die zijn gedefinieerd in de klasse FontWeight. | StageText | ||
locale : String
Geeft de landinstelling van de tekst aan. | StageText | ||
maxChars : int
Hiermee wordt het maximum aantal tekens aangegeven dat een gebruiker in het tekstveld kan invoeren. | StageText | ||
multiline : Boolean [alleen-lezen]
Hiermee wordt aangegeven of het StageText-object meer dan één regel tekst kan weergeven. | StageText | ||
restrict : String
Hiermee worden beperkingen ingesteld op de set tekens die een gebruiker in het tekstveld kan invoeren. | StageText | ||
returnKeyLabel : String
Verwijst naar het etiket op de Return-toets voor apparaten met een schermtoetsenbord. | StageText | ||
selectionActiveIndex : int [alleen-lezen]
De op nul gebaseerde indexwaarde van het laatste teken in de huidige selectie. | StageText | ||
selectionAnchorIndex : int [alleen-lezen]
De op nul gebaseerde indexwaarde van het eerste teken in de huidige selectie. | StageText | ||
softKeyboardType : String
Bepaalt het uiterlijk van het schermtoetsenbord. | StageText | ||
stage : Stage
Het werkgebied waarin dit StageText-object wordt weergegeven. | StageText | ||
text : String
De huidige tekst in het tekstveld. | StageText | ||
textAlign : String
Geeft de alinea-uitlijning aan. | StageText | ||
viewPort : Rectangle
Het gedeelte van het werkgebied waarin het StageText-object wordt weergegeven. | StageText | ||
visible : Boolean
Geeft aan of het StageText-object zichtbaar is. | StageText |
Methode | Gedefinieerd door | ||
---|---|---|---|
Hiermee wordt een StageText-object gemaakt. | StageText | ||
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. | EventDispatcher | ||
Hiermee wordt de focus aan het StageText-object toegewezen. | StageText | ||
Verzendt een gebeurtenis naar de gebeurtenisstroom. | EventDispatcher | ||
Hiermee wordt het StageText-object verwijderd. | StageText | ||
Hiermee wordt de StageText-viewport als een bitmap getekend. | StageText | ||
Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis. | EventDispatcher | ||
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | ||
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | ||
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | ||
Verwijdert een listener uit het object EventDispatcher. | EventDispatcher | ||
Selecteert de tekst die is opgegeven door de indexwaarden van het eerste en laatste teken. | StageText | ||
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | ||
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | ||
Retourneert een tekenreeksrepresentatie van het opgegeven object. | Object | ||
Retourneert de primitieve waarde van het opgegeven object. | Object | ||
Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis. | EventDispatcher |
Gebeurtenis | Overzicht | Gedefinieerd door | ||
---|---|---|---|---|
[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt. | EventDispatcher | |||
Wordt verzonden nadat de tekstinhoud is gewijzigd. | StageText | |||
Wordt verzonden na het instellen van een werkgebied dat niet gelijk is aan null en van een niet-lege viewPort. | StageText | |||
[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt. | EventDispatcher | |||
Wordt verzonden wanneer de gebruiker tekst bewerkt en het besturingselement de toetsenbordfocus heeft. | StageText | |||
Wordt verzonden wanneer de gebruiker niet langer tekst bewerkt en het besturingselement niet langer de toetsenbordfocus heeft. | StageText | |||
Wordt verzonden wanneer de gebruiker op een toets drukt. | StageText | |||
Wordt verzonden wanneer de gebruiker een toets loslaat. | StageText | |||
Wordt verzonden nadat het schermtoetsenbord wordt geactiveerd omdat het StageText-object de focus krijgt. | StageText | |||
Wordt verzonden voordat het schermtoetsenbord wordt geactiveerd omdat het StageText-object de focus krijgt. | StageText | |||
Wordt verzonden nadat het schermtoetsenbord is gedeactiveerd omdat het StageText-object niet meer de focus heeft. | StageText |
autoCapitalize | eigenschap |
autoCapitalize:String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Bepaalt hoe een apparaat automatisch hoofdlettergebruik toepast op gebruikersinvoer. Geldige waarden worden gedefinieerd als constanten in de klasse AutoCapitalize:
- "none"
- "word"
- "sentence"
- "all"
Deze eigenschap is niet meer dan een hint voor het onderliggende platform, omdat niet alle apparaten en besturingssystemen deze functionaliteit ondersteunen.
Opmerking: Als u autoCapitalize
inschakelt terwijl tekst wordt bewerkt of op een andere manier de focus heeft, wordt het bijgewerkte gedrag niet toegepast totdat de focus wordt losgelaten en en opnieuw tot stand gebracht.
De standaardwaarde is AutoCapitalize.NONE.
Implementatie
public function get autoCapitalize():String
public function set autoCapitalize(value:String):void
Gegenereerde uitzondering
ArgumentError — Indien ingesteld op een waarde die geen lid is vanAutoCapitalize
|
Verwante API-elementen
autoCorrect | eigenschap |
autoCorrect:Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Geeft aan of een apparaat fouten in de spelling of interpunctie in gebruikersinvoer automatisch corrigeert.
Deze eigenschap is niet meer dan een hint voor het onderliggende platform, omdat niet alle apparaten en besturingssystemen deze functionaliteit ondersteunen.
Opmerking: Als u autoCorrect
inschakelt terwijl tekst wordt bewerkt of op een andere manier de focus heeft, wordt het bijgewerkte gedrag niet toegepast totdat de focus wordt losgelaten en en opnieuw tot stand gebracht.
De standaardwaarde is false.
Implementatie
public function get autoCorrect():Boolean
public function set autoCorrect(value:Boolean):void
clearButtonMode | eigenschap |
clearButtonMode:String
[alleen-schrijven] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 23 |
De clearButton-modus voor het huidige StageText-object. Er zijn vier modi die aan deze eigenschap zijn gekoppeld:
-
Als u clearButton wilt weergeven tijdens het bewerken:
StageTextClearButtonMode.WHILE_EDITING
-
Als u clearButton nooit wilt weergeven:
StageTextClearButtonMode.NEVER
-
Als u clearButton altijd wilt weergeven:
StageTextClearButtonMode.ALWAYS
-
Als u clearButton wilt weergeven, maar niet tijdens het bewerken:
StageTextClearButtonMode.UNLESS_EDITING
clearButtonMode
ingesteld op StageTextClearButtonMode.WHILE_EDITING.
Opmerking: Deze eigenschap wordt alleen ondersteund op iOS.
Implementatie
public function set clearButtonMode(value:String):void
color | eigenschap |
color:uint
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Geeft de tekstkleur op. U geeft de tekstkleur op als een nummer dat drie 8-bits RGB-componenten bevat. De eerste component vertegenwoordigt rood, de tweede groen en de derde blauw. Zo verwijst 0xFF0000
bijvoorbeeld naar rood, 0x00FF00
naar groen en 0x0000FF
naar blauw. De standaardkleur voor tekst is zwart (0x000000
).
De standaardwaarde is 0x000000.
Implementatie
public function get color():uint
public function set color(value:uint):void
displayAsPassword | eigenschap |
displayAsPassword:Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Geeft aan of het tekstveld een wachtwoordtekstveld is. In geval van true
vervangt het tekstveld de tekens die worden ingevoerd door een ander teken, zoals een sterretje.
Opmerking: Als u displayAsPassword
inschakelt terwijl tekst wordt bewerkt of op een andere manier de focus heeft, wordt het bijgewerkte gedrag niet toegepast totdat de focus wordt losgelaten en en opnieuw tot stand gebracht.
Belangrijk: op iOS worden in een StageText-object met meerdere regels geen vervangingstekens weergegeven, ook niet als de waarde van deze eigenschap true
is.
De standaardwaarde is false.
Implementatie
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
editable | eigenschap |
fontFamily | eigenschap |
fontFamily:String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Verwijst naar de naam van de huidige lettertypefamilie. De waarde null verwijst naar de standaardinstelling van het systeem. Gebruik flash.text.Font.enumerateFonts()
om de beschikbare lettertypen op te sommen. Als de lettertypefamilie onbekend is, wordt de standaardlettertypefamilie gebruikt.
De standaardwaarde is null.
Implementatie
public function get fontFamily():String
public function set fontFamily(value:String):void
fontPosture | eigenschap |
fontPosture:String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Geeft de tekenstand aan met gebruik van constanten die zijn gedefinieerd in de klasse FontPosture.
De standaardwaarde is FontPosture.NORMAL.
Implementatie
public function get fontPosture():String
public function set fontPosture(value:String):void
Gegenereerde uitzondering
ArgumentError — Indien ingesteld op een waarde die geen lid is van FontPosture
|
Verwante API-elementen
fontSize | eigenschap |
fontWeight | eigenschap |
fontWeight:String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Geeft de tekendikte aan door middel van constanten die zijn gedefinieerd in de klasse FontWeight.
De standaardwaarde is FontWeight.NORMAL.
Implementatie
public function get fontWeight():String
public function set fontWeight(value:String):void
Gegenereerde uitzondering
ArgumentError — Indien ingesteld op een waarde die geen lid is van FontWeight
|
Verwante API-elementen
locale | eigenschap |
locale:String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Geeft de landinstelling van de tekst aan. StageText gebruikt de standaard-id's voor landinstellingen. Bijvoorbeeld 'en', 'en_US' en 'en-US' zijn id's voor Engels, terwijl 'ja' naar Japans verwijst. Raadpleeg iso639-2 code list voor een lijst met landinstellingscodes.
De standaardwaarde is en.
Implementatie
public function get locale():String
public function set locale(value:String):void
maxChars | eigenschap |
maxChars:int
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Hiermee wordt het maximum aantal tekens aangegeven dat een gebruiker in het tekstveld kan invoeren. Een script kan meer tekens invoegen dan toegestaan door maxChars
. Wanneer maxChars
gelijk is aan nul, kan een gebruiker een onbeperkte hoeveelheid tekst invoeren in het tekstveld.
De standaardwaarde is 0.
Implementatie
public function get maxChars():int
public function set maxChars(value:int):void
multiline | eigenschap |
multiline:Boolean
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Hiermee wordt aangegeven of het StageText-object meer dan één regel tekst kan weergeven. Alleen-lezen. Deze waarde komt overeen met de waarde van de eigenschap multiline
in het object StageTextInitOptions dat tijdens de constructie wordt gebruikt.
Implementatie
public function get multiline():Boolean
Verwante API-elementen
restrict | eigenschap |
restrict:String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Hiermee worden beperkingen ingesteld op de set tekens die een gebruiker in het tekstveld kan invoeren. Het systeem scant de restrict
-tekenreeks van links naar rechts.
De waarde van restrict
geeft de volgende regels voor de beperking van tekstinvoer op:
- Wanneer de waarde
null
is, kan een gebruiker alle mogelijke tekens invoeren. - Als de waarde een lege tekenreeks is, kan een gebruiker helemaal geen tekens invoeren.
- Als de waarde een tekenreeks met tekens is, kan een gebruiker alleen de tekens uit de reeks invoeren.
- Als de waarde een invoegteken (^) bevat, kan een gebruiker na dit teken geen tekens invoeren.
- De waarde kan een bereik met toegestane invoerwaarden opgeven door gebruik te maken van het afbreekstreepje (-).
- De waarde kan de escape-reeks
\u
gebruiken voor het samenstellen van eenrestrict
-reeks.
Speciale tekens:
Gebruik een backslash om letterlijk een invoegteken (^) of afbreekstreepje (-) in te voeren. De geaccepteerde backslash-reeksen zijn \-, \^ en \\. De backslash moet een feitelijk teken in de tekenreeks zijn. Gebruik een dubbele backslash wanneer u een backslash opgeeft in ActionScript.
Voorbeelden van instellingen van de restrict
-eigenschap:
In het volgende voorbeeld mag een gebruiker alleen de afbreek- en invoegtekens invoeren (respectievelijk - en ^):
my_txt.restrict = "\\-\\^";
In het volgende voorbeeld kan een gebruiker alleen hoofdletters, spaties en nummers invoeren:
my_txt.restrict = "A-Z 0-9";
Het volgende voorbeeld sluit alleen kleine letters uit:
my_txt.restrict = "^a-z";
In het volgende voorbeeld kan een gebruiker alleen hoofdletters invoeren, maar met uitzondering van de hoofdletter Q:
my_txt.restrict = "A-Z^Q";
In het volgende voorbeeld kan een gebruiker alleen de tekens tussen ASCII 32 (spatie) en ASCII 126 (tilde) invoeren.
my_txt.restrict = "\u0020-\u007E";
Opmerking: de beperkingen zijn alleen van toepassing op gebruikersinvoer; een script kan alle mogelijke tekens invoeren in het tekstveld.
De standaardwaarde is null.
Implementatie
public function get restrict():String
public function set restrict(value:String):void
returnKeyLabel | eigenschap |
returnKeyLabel:String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Verwijst naar het etiket op de Return-toets voor apparaten met een schermtoetsenbord. De beschikbare waarden zijn de constanten die zijn gedefinieerd in de ReturnKeyLabel
-klasse:
- "default"
- "done"
- "go"
- "next"
- "search"
Deze eigenschap is niet meer dan een hint voor het onderliggende platform, omdat niet alle apparaten en besturingssystemen deze waarden ondersteunen. Deze eigenschap heeft geen effect op apparaten zonder schermtoetsenbord.
De standaardwaarde is ReturnKeyLabel.DEFAULT.
Implementatie
public function get returnKeyLabel():String
public function set returnKeyLabel(value:String):void
Gegenereerde uitzondering
ArgumentError — Indien ingesteld op een waarde die geen lid is vanReturnKeyLabel
|
Verwante API-elementen
selectionActiveIndex | eigenschap |
selectionActiveIndex:int
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
De op nul gebaseerde indexwaarde van het laatste teken in de huidige selectie. Het eerste teken is bijvoorbeeld 0, het tweede teken 1, enzovoort.
Als er geen tekst is geselecteerd, wordt met deze methode het invoegpunt geretourneerd. Als de StageText-instantie de focus niet heeft, wordt met deze methode -1 geretourneerd.
Op iOS wordt deze eigenschap niet ondersteund voor Stagetext-objecten die niet uit meerdere regels bestaan, en wordt -1 geretourneerd.
Implementatie
public function get selectionActiveIndex():int
Verwante API-elementen
selectionAnchorIndex | eigenschap |
selectionAnchorIndex:int
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
De op nul gebaseerde indexwaarde van het eerste teken in de huidige selectie. Het eerste teken is bijvoorbeeld 0, het tweede teken 1, enzovoort.
Als er geen tekst is geselecteerd, wordt met deze methode het invoegpunt geretourneerd. Als de StageText-instantie de focus niet heeft, wordt met deze methode -1 geretourneerd.
Op iOS wordt deze eigenschap niet ondersteund voor Stagetext-objecten die niet uit meerdere regels bestaan, en wordt -1 geretourneerd.
Implementatie
public function get selectionAnchorIndex():int
Verwante API-elementen
softKeyboardType | eigenschap |
softKeyboardType:String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Bepaalt het uiterlijk van het schermtoetsenbord.
Apparaten met schermtoetsenborden kunnen de knoppen van het toetsenbord aanpassen aan het verwachte type invoer. Als bijvoorbeeld numerieke invoer wordt verwacht, kan een apparaat SoftKeyboardType.NUMBER
gebruiken om alleen nummers weer te geven op het schermtoetsenbord. Geldige waarden worden gedefinieerd als constanten in de klasse SoftKeyboardType:
- "default"
- "punctuation"
- "url"
- "number"
- "contact"
- "email"
- "phone"
- "decimalpad"
Deze waarden fungeren als een hint, om een apparaat te helpen het beste toetsenbord voor de actieve bewerking weer te geven.
De standaardwaarde is SoftKeyboardType.DEFAULT.
Implementatie
public function get softKeyboardType():String
public function set softKeyboardType(value:String):void
Gegenereerde uitzondering
ArgumentError — Indien ingesteld op een waarde die geen lid is van SoftKeyboardType
|
Verwante API-elementen
stage | eigenschap |
stage:Stage
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Het werkgebied waarin dit StageText-object wordt weergegeven.
Stel stage
in op null
als u dit StageText-object wilt verbergen.
De standaardwaarde is null.
Implementatie
public function get stage():Stage
public function set stage(value:Stage):void
text | eigenschap |
text:String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
De huidige tekst in het tekstveld. Het Carriage Return-teken ('\r'
, ASCII 13) scheidt tekstregels van elkaar. De tekst in deze eigenschap is niet opgemaakt (heeft geen opmaaktags).
De standaardwaarde is null.
Implementatie
public function get text():String
public function set text(value:String):void
textAlign | eigenschap |
textAlign:String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Geeft de alinea-uitlijning aan. Geldige waarden worden gedefinieerd als constanten in de klasse TextFormatAlign:
- "left"
- "center"
- "right"
- "justify"
- "start"
- "end"
Niet alle platformen bieden ondersteuning voor elke textAlign
-waarde. Voor niet-ondersteunde textAlign
-waarden gebruiken platformen de standaardwaarde (TextFormatAlign.START
).
De standaardwaarde is TextFormatAlign.START.
Implementatie
public function get textAlign():String
public function set textAlign(value:String):void
Gegenereerde uitzondering
ArgumentError — Indien ingesteld op een waarde die geen lid is vanTextFormatAlign
|
Verwante API-elementen
viewPort | eigenschap |
viewPort:Rectangle
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Het gedeelte van het werkgebied waarin het StageText-object wordt weergegeven. De standaardwaarde is de nulrechthoek.
Implementatie
public function get viewPort():Rectangle
public function set viewPort(value:Rectangle):void
Gegenereerde uitzondering
RangeError — De Rectangle-waarde is ongeldig.
|
visible | eigenschap |
StageText | () | Constructor |
public function StageText(initOptions:flash.text:StageTextInitOptions = null)
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Hiermee wordt een StageText-object gemaakt.
Het StageText-object wordt pas zichtbaar wanneer het aan een werkgebied wordt gekoppeld en de eigenschap viewPort
is ingesteld.
initOptions:flash.text:StageTextInitOptions (default = null )
|
assignFocus | () | methode |
public function assignFocus():void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Hiermee wordt de focus aan het StageText-object toegewezen. assignFocus()
heeft geen effect op niet-bewerkbare objecten.
dispose | () | methode |
public function dispose():void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Hiermee wordt het StageText-object verwijderd.
Het aanroepen van dispose()
is optioneel. Als u geen referentie naar deze StageText-instantie bijhoudt, is het mogelijk dat dit item wordt opgeschoond. Door dispose()
aan te roepen, kunt u eerder (of op een geschikter tijdstip) opschonen.
drawViewPortToBitmapData | () | methode |
public function drawViewPortToBitmapData(bitmap:BitmapData):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3.0 |
Hiermee wordt de StageText-viewport als een bitmap getekend.
Maak de bitmap door deze vast te leggen en stel het werkgebied in op null
als u de inhoud boven het StageText-object wilt weergeven.
De bitmap heeft doorgaans dezelfde breedte en hoogte als de viewport. Vanaf AIR 15.0, wanneer de speler op HiDPI-schermen is, kunnen de breedte en hoogte van de bitmap optioneel contentsScaleFactor
maal de breedte en hoogte van de viewport zijn. Bijvoorbeeld op een Mac Retina-display is contentsScaleFactor
2, omdat de pixelresolutie van het werkgebied wordt verdubbeld, zodat de bitmap navenant tweemaal de grootte van de viewport kan zijn.
Als u deze methode aanroept vóór de gebeurtenis Event.COMPLETE
, is het mogelijk dat de viewport niet correct wordt getekend.
Parameters
bitmap:BitmapData — Het BitmapData-object waarop het zichtbare gedeelte van de StageText-weergavepoort wordt getekend.
|
Gegenereerde uitzondering
ArgumentError — De breedte of hoogte van de bitmap is anders dan de breedte of hoogte van de weergavepoort.
| |
Error — De waarde voor de bitmap is null.
|
selectRange | () | methode |
public function selectRange(anchorIndex:int, activeIndex:int):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Selecteert de tekst die is opgegeven door de indexwaarden van het eerste en laatste teken. U geeft het eerste en laatste teken van de selectie op in de parameters anchorIndex
en activeIndex
. Als de twee parameterwaarden identiek zijn, wordt met deze methode het invoegpunt ingesteld.
Op iOS wordt deze functie niet ondersteund voor StageText-objecten die niet uit meerdere regels bestaan, en wordt altijd -1 geretourneerd. Als u deze methode aanroept door de gehele tekenreeks te selecteren, is de selectie zichtbaar. Als u deze methode echter aanroept door een subset van de tekstreeks te selecteren, is de selectie niet zichtbaar.
Voor sommige apparaten of besturingssystemen is de selectie alleen zichtbaar wanneer het StageText-object de focus heeft.
Parameters
anchorIndex:int — De op nul gebaseerde indexwaarde van het eerste teken in de selectie (de indexwaarde van het eerste teken is 0).
| |
activeIndex:int — De op nul gebaseerde indexwaarde van het laatste teken in de selectie.
|
Verwante API-elementen
change | Gebeurtenis |
flash.events.Event
eigenschap Event.type =
flash.events.Event.CHANGE
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Wordt verzonden nadat de tekstinhoud is gewijzigd. Deze gebeurtenis kan na elke wijziging worden verzonden, of pas wanneer een serie wijzigingen is voltooid.
De constanteEvent.CHANGE
definieert de waarde van de eigenschap type
van een change
-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | true |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Het object waarvan de waarde is gewijzigd. Het target is niet altijd het object in het weergaveoverzicht dat in de gebeurtenislistener is geregistreerd. Gebruik de eigenschap currentTarget voor toegang tot het object in het weergaveoverzicht dat momenteel de gebeurtenis verwerkt. |
complete | Gebeurtenis |
flash.events.Event
eigenschap Event.type =
flash.events.Event.COMPLETE
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Wordt verzonden na het instellen van een werkgebied dat niet gelijk is aan null en van een niet-lege viewPort. Geeft aan dat de implementatie klaar is met de lay-out van het StageText-object en dat u nu de methode drawViewPortToBitmapData
kunt aanroepen. Deze gebeurtenis kan, afhankelijk van het platform, op synchrone of asynchrone wijze worden verzonden door stage
, viewPort
of beide in te stellen.
Event.COMPLETE
definieert de waarde van de eigenschap type
van een complete
-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Het netwerkobject dat klaar is met laden. |
focusIn | Gebeurtenis |
flash.events.FocusEvent
eigenschap FocusEvent.type =
flash.events.FocusEvent.FOCUS_IN
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Wordt verzonden wanneer de gebruiker tekst bewerkt en het besturingselement de toetsenbordfocus heeft.
Definieert de waarde van de eigenschaptype
van een gebeurtenisobject focusIn
.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | true |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
keyCode | 0; is alleen van toepassing op gebeurtenissen keyFocusChange . |
relatedObject | De aanvullende instantie InteractiveObject, die wordt beïnvloed door de gewijzigde focus. |
shiftKey | false ; is alleen van toepassing op gebeurtenissen keyFocusChange . |
target | De instantie InteractiveObject die zojuist focus heeft gekregen. Het target is niet altijd het object in het weergaveoverzicht dat in de gebeurtenislistener is geregistreerd. Gebruik de eigenschap currentTarget voor toegang tot het object in het weergaveoverzicht dat momenteel de gebeurtenis verwerkt.
|
direction | De richting van waaruit focus is toegewezen. Deze eigenschap rapporteert de waarde van de parameter direction van de methode assignFocus() van het werkgebied. Als de focus op de een of andere manier is gewijzigd, is de waarde altijd FocusDirection.NONE . Is alleen van toepassing op focusIn -gebeurtenissen. Voor alle andere focusgebeurtenissen is de waarde FocusDirection.NONE . |
focusOut | Gebeurtenis |
flash.events.FocusEvent
eigenschap FocusEvent.type =
flash.events.FocusEvent.FOCUS_OUT
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Wordt verzonden wanneer de gebruiker niet langer tekst bewerkt en het besturingselement niet langer de toetsenbordfocus heeft.
Definieert de waarde van de eigenschaptype
van een gebeurtenisobject focusOut
.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | true |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
keyCode | 0; is alleen van toepassing op gebeurtenissen keyFocusChange . |
relatedObject | De aanvullende instantie InteractiveObject, die wordt beïnvloed door de gewijzigde focus. |
shiftKey | false ; is alleen van toepassing op gebeurtenissen keyFocusChange . |
target | De instantie InteractiveObject die zojuist focus heeft verloren. Het target is niet altijd het object in het weergaveoverzicht dat in de gebeurtenislistener is geregistreerd. Gebruik de eigenschap currentTarget voor toegang tot het object in het weergaveoverzicht dat momenteel de gebeurtenis verwerkt.
|
keyDown | Gebeurtenis |
flash.events.KeyboardEvent
eigenschap KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_DOWN
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Wordt verzonden wanneer de gebruiker op een toets drukt.
Toewijzingen tussen toetsen en specifieke tekens kunnen variëren per apparaat en besturingssysteem. Dit type gebeurtenis wordt gegenereerd nadat een dergelijke toewijzing heeft plaatsgevonden en voordat een invoermethode-editor (IME) wordt verwerkt. IME's zijn handig om tekens in te voeren die op een standaard QWERTY-toetsenbord lastig te produceren zijn (zoals bijvoorbeeld Chinese ideogrammen).
Deze gebeurtenis treedt op vóór de gebeurtenis keyUp
.
Deze gebeurtenis wordt niet voor alle toetsen verzonden. De toetsen die ervoor zorgen dat deze gebeurtenis wordt verzonden, variëren per platform.
Als u deze gebeurtenis annuleert in AIR, wordt voorkomen dat het teken in een tekstveld wordt ingevoerd.
De constanteKeyboardEvent.KEY_DOWN
definieert de waarde van de eigenschap type
van een keyDown
-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | true |
cancelable | true in AIR, false in Flash Player. Als deze gebeurtenis in AIR wordt geannuleerd, wordt het teken niet ingevoegd in een tekstveld. |
charCode | De waarde van de tekencode van de toets die is ingedrukt of losgelaten. |
commandKey | true op de Mac als de Command-toets actief is. Anders is deze false |
controlKey | true onder Windows enLinux als de Ctrl-toets actief is. true op de Mac als de Control-toets actief is. Anders is deze false |
ctrlKey | true onder Windows enLinux als de Ctrl-toets actief is. true op de Macintosh als de Ctrl-toets of Command-toets actief is. Anders is deze false . |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
keyCode | De waarde van de toetscode van de toets die is ingedrukt of losgelaten. |
keyLocation | De locatie van de toets op het toetsenbord. |
shiftKey | true wanneer de Shift-toets actief is of false wanneer deze inactief is. |
target | De instantie InteractiveObject met focus. Het target is niet altijd het object in het weergaveoverzicht dat in de gebeurtenislistener is geregistreerd. Gebruik de eigenschap currentTarget voor toegang tot het object in het weergaveoverzicht dat momenteel de gebeurtenis verwerkt. |
keyUp | Gebeurtenis |
flash.events.KeyboardEvent
eigenschap KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_UP
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Wordt verzonden wanneer de gebruiker een toets loslaat.
Toewijzingen tussen toetsen en specifieke tekens kunnen variëren per apparaat en besturingssysteem. Dit type gebeurtenis wordt gegenereerd nadat een dergelijke toewijzing heeft plaatsgevonden en voordat een invoermethode-editor (IME) wordt verwerkt. IME's worden gebruikt om tekens in te voeren die op een standaard QWERTY-toetsenbord lastig te produceren zijn (zoals bijvoorbeeld Chinese ideogrammen).
Deze gebeurtenis treedt op na de gebeurtenis keyDown
.
Deze gebeurtenis wordt niet voor alle toetsen verzonden. De toetsen die ervoor zorgen dat deze gebeurtenis wordt verzonden, variëren per platform.
De constanteKeyboardEvent.KEY_UP
definieert de waarde van de eigenschap type
van een keyUp
-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | true |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
charCode | Deze bevat de waarde van de tekenreekscode van de laatste toets die is ingedrukt of losgelaten. |
commandKey | true op de Mac als de Command-toets actief is. Anders is deze false |
controlKey | true onder Windows enLinux als de Ctrl-toets actief is. true op de Mac als de Control-toets actief is. Anders is deze false |
ctrlKey | true onder Windows als de Ctrl-toets actief is. true op de Macintosh als de Ctrl-toets of Command-toets actief is. Anders is deze false . |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
keyCode | De waarde van de toetscode van de toets die is ingedrukt of losgelaten. |
keyLocation | De locatie van de toets op het toetsenbord. |
shiftKey | true wanneer de Shift-toets actief is of false wanneer deze inactief is. |
target | De instantie InteractiveObject met focus. Het target is niet altijd het object in het weergaveoverzicht dat in de gebeurtenislistener is geregistreerd. Gebruik de eigenschap currentTarget voor toegang tot het object in het weergaveoverzicht dat momenteel de gebeurtenis verwerkt. |
softKeyboardActivate | Gebeurtenis |
flash.events.SoftKeyboardEvent
eigenschap SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Wordt verzonden nadat het schermtoetsenbord wordt geactiveerd omdat het StageText-object de focus krijgt.
De constanteSoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE
definieert de waarde van de type
-eigenschap van het SoftKeyboardEvent-object wanneer een softwaretoetsenbord wordt weergegeven. Voor deze gebeurtenis geldt het volgende:cancellable = false
.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
type | SOFT_KEYBOARD_ACTIVATE |
bubbles | true |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
relatedObjectVal | Een verwijzing naar een weergaveoverzichtobject dat betrekking heeft op de gebeurtenis. |
triggerTypeVal | Geeft aan of de toetsenbordgebeurtenis is geactiveerd door een toepassing of gebruiker. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
softKeyboardActivating | Gebeurtenis |
flash.events.SoftKeyboardEvent
eigenschap SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Wordt verzonden voordat het schermtoetsenbord wordt geactiveerd omdat het StageText-object de focus krijgt.
De constanteSoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING
definieert de waarde van de type
-eigenschap van het SoftKeyboardEvent-object vlak voordat een softwaretoetsenbord wordt weergegeven. Voor deze gebeurtenis geldt het volgende:cancellable = true
.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
type | SOFT_KEYBOARD_ACTIVATING |
bubbles | true |
cancelable | true tenzij de gebeurtenis wordt verzonden door een StageText-object. Bij StageText-objecten kan de gebeurtenis niet worden geannuleerd. |
relatedObjectVal | Een verwijzing naar een weergaveoverzichtobject dat betrekking heeft op de gebeurtenis. |
triggerTypeVal | Geeft aan of de toetsenbordgebeurtenis is geactiveerd door een toepassing of gebruiker. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
softKeyboardDeactivate | Gebeurtenis |
flash.events.SoftKeyboardEvent
eigenschap SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3 |
Wordt verzonden nadat het schermtoetsenbord is gedeactiveerd omdat het StageText-object niet meer de focus heeft.
De constanteSoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE
definieert de waarde van de type
-eigenschap van het SoftKeyboardEvent-object wanneer een softwaretoetsenbord van het scherm verdwijnt. Voor deze gebeurtenis geldt het volgende:cancellable = false
.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
type | SOFT_KEYBOARD_DEACTIVATE |
bubbles | true |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
relatedObjectVal | Een verwijzing naar een weergaveoverzichtobject dat betrekking heeft op de gebeurtenis. |
triggerTypeVal | Geeft aan of de toetsenbordgebeurtenis is geactiveerd door een toepassing of gebruiker. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
Wed Jun 13 2018, 11:42 AM Z