Paket | flash.text |
Klass | public final class StageText |
Arv | StageText EventDispatcher Object |
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Den här klassen gör att mobila program kan samla in användarindata med kontroller för intern textinmatning på mobila enheter. Indatakontroller på mobila enheter har ofta omfattande användargränssnitt och stöd för beteenden som inte finns på stationära datorer. Många mobila enheter har till exempel stöd för indatafunktioner så som:
- autoavslut
- autokorrigering
- pekbaserad textmarkering
- anpassade skärmtangentbord
Det bakomliggande operativsystemet (eller ett komponentbibliotek knutet till operativsystemet) ritar upp interna textinmatningsfält. Interna textinmatningsfält skänker en upplevelse som är bekanta för alla som använt andra program på enheten. Eftersom det är operativsystemet som ritar upp indatafältet och inte spelaren, kan du inte använda inbäddade teckensnitt.
Stöd för AIR-profiler: Den här funktionen stöds på iOS- och Android-plattformar. StageText använder interna textinmatningsfält på Android- och iOS-mobilenheter. På andra plattformar använder StageText Flash Runtime TextField.
När interna inmatningar används är StageText-objekt inte visningsobjekt och du kan inte lägga till dem i Flash visningslista. Du visar i stället ett StageText-objekt genom att koppla det direkt till en scen med egenskapen stage
. En StageText-instans som kopplats till en scen visas ovanpå alla andra Flash-visningsobjekt. Du anger storleken och positionen för återgivningsområdet med egenskapen viewPort
. Det går inte att styra ordningen på färgdjupet för olika StageText-objekt. Du bör inte överlappa två instanser.
När ett StageText-objekt är i fokus har det det första tillfället att hantera tangentbordsinmatningar. Scenen som StageText-objektet är kopplat till skickar inte någon tangentbordsinmatning.
Eftersom StageText-klassen omfattar olika interna kontroller på varje plattform, kommer dess funktioner att stödjas i olika utsträckning på varje plattform. Funktioner som stöds kan uppträda olika på olika plattformar. Om du därför vill använda en speciell funktion på en viss plattform, bör du först testa hur den uppträder. Endast på stationära datorer, där interna kontroller inte används, kommer StageText-beteendet att påminna om textbeteendet i Flash-miljön.
StageText har fokus som standard på Apple TV. När du hanterar fokus mellan olika objekt i appen bör du tänka på följande:
- Om du vill åsidosätta standardfokus för StageText eller tilldela fokus till ett annat visningsobjekt ska du använda stage.focus
- Använd stageText.assignFocus() när du vill tilldela StageText fokus.
Egenskap | Definieras med | ||
---|---|---|---|
autoCapitalize : String
Kontrollerar hur en enhet tillämpar automatiskt versalläge för användarens indata. | StageText | ||
autoCorrect : Boolean
Anger om en enhet automatiskt kontrollerar användarindata för stavnings- eller interpunktionsmisstag. | StageText | ||
clearButtonMode : String [lässkyddad]
clearButton-läget för det aktuella StageText-objektet. | StageText | ||
color : uint
Anger textfärg. | StageText | ||
constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object | ||
displayAsPassword : Boolean
Anger om textfältet är ett textfält för lösenord. | StageText | ||
editable : Boolean
Anger om användaren kan redigera textfältet. | StageText | ||
fontFamily : String
Anger namnet för den aktuella teckensnittsfamiljen. | StageText | ||
fontPosture : String
Anger att konstanter som definierats i FontPosture-klassen används för teckensnittsläget. | StageText | ||
fontSize : int
Storleken i pixlar för den aktuella teckensnittsfamiljen. | StageText | ||
fontWeight : String
Anger att konstanter som definierats i FontPosture-klassen används för teckensnittsstilen. | StageText | ||
locale : String
Anger textens språk. | StageText | ||
maxChars : int
Anger maximalt antal tecken som en användare kan skriva i textfältet. | StageText | ||
multiline : Boolean [skrivskyddad]
Anger om StageText-objektet kan visa flera textrader. | StageText | ||
restrict : String
Begränsar den uppsättning tecken som en användare kan skriva i textfältet. | StageText | ||
returnKeyLabel : String
Anger etiketten för returtangenten för enheter med ett skärmtangentbord. | StageText | ||
selectionActiveIndex : int [skrivskyddad]
Det nollbaserade teckenindexvärdet för det sista tecknet i den aktuella markeringen. | StageText | ||
selectionAnchorIndex : int [skrivskyddad]
Det nollbaserade teckenindexvärdet för det första tecknet i den aktuella markeringen. | StageText | ||
softKeyboardType : String
Kontrollerar utseendet på skärmtangentbordet. | StageText | ||
stage : Stage
Den scen som det här StageText-objektet visas på. | StageText | ||
text : String
Den aktuella texten i textfältet. | StageText | ||
textAlign : String
Anger styckejustering. | StageText | ||
viewPort : Rectangle
Den del på scenen där StageText-objektet visas. | StageText | ||
visible : Boolean
Anger om StageText-objektet är synligt. | StageText |
Metod | Definieras med | ||
---|---|---|---|
Skapar ett StageText-objekt. | StageText | ||
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. | EventDispatcher | ||
Tilldelar fokus till StageText-objektet. | StageText | ||
Skickar en händelse till händelseflödet. | EventDispatcher | ||
Släpper StageText-objektet. | StageText | ||
Ritar visningsporten för StageText i en bitmapp. | StageText | ||
Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse. | EventDispatcher | ||
Anger om det finns en egenskap angiven för ett objekt. | Object | ||
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter. | Object | ||
Anger om den angivna egenskapen finns och är uppräkningsbar. | Object | ||
Tar bort en avlyssnare från EventDispatcher-objektet. | EventDispatcher | ||
Markerar text som anges i indexvärden för de första och sista tecknen. | StageText | ||
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder. | Object | ||
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner. | Object | ||
Returnerar det angivna objektets strängbeteckning. | Object | ||
Returnerar det angivna objektets primitiva värde. | Object | ||
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. | EventDispatcher |
Händelse | Sammanfattning | Definieras med | ||
---|---|---|---|---|
[utsändningshändelse] Skickas när Flash Player eller AIR får operativsystemfokus och blir aktivt. | EventDispatcher | |||
Skickas efter att textinnehållet ändrats. | StageText | |||
Skickas efter inställning av en scen som inte är null och en visningsport som inte är tom. | StageText | |||
[utsändningshändelse] Skickas när Flash Player eller AIR förlorar operativsystemfokus och blir inaktivt. | EventDispatcher | |||
Skickas när användaren redigerar text och kontrollen har tangentbordsfokus. | StageText | |||
Skickas när användaren inte längre redigerar text och kontrollen inte längre har tangentbordsfokus. | StageText | |||
Skickas när användaren trycker på en tangent. | StageText | |||
Skickas när användaren släpper upp en tangent. | StageText | |||
Skickas sedan skärmtangentbordet har aktiverats på grund av att objektet StageText kommer i fokus. | StageText | |||
Skickas innan skärmtangentbordet aktiveras på grund av att objektet StageText kommer i fokus. | StageText | |||
Skickas sedan skärmtangentbordet har inaktiverats på grund av att objektet StageText har förlorat fokus. | StageText |
autoCapitalize | egenskap |
autoCapitalize:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Kontrollerar hur en enhet tillämpar automatiskt versalläge för användarens indata. Giltiga värden definieras som konstanter i klassen AutoCapitalize:
- "none"
- "word"
- "sentence"
- ”all”
Den här egenskapen är bara ett tips till den bakomliggande plattformen eftersom inte alla enheter och operativsystem har stöd för denna funktion.
Obs! Om du aktiverar autoCapitalize
när text redigeras eller på annat sätt har fokus används inte det uppdaterade beteendet förrän texten släpper fokus och återtar det.
Standardvärdet är AutoCapitalize.NONE.
Implementering
public function get autoCapitalize():String
public function set autoCapitalize(value:String):void
Utlöser
ArgumentError — Om den anges till ett värde som inte är medlem av AutoCapitalize
|
Relaterade API-element
autoCorrect | egenskap |
autoCorrect:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Anger om en enhet automatiskt kontrollerar användarindata för stavnings- eller interpunktionsmisstag.
Den här egenskapen är bara ett tips till den bakomliggande plattformen eftersom inte alla enheter och operativsystem har stöd för denna funktion.
Obs! Om du aktiverar autoCorrect
när text redigeras eller på annat sätt har fokus används inte det uppdaterade beteendet förrän texten släpper fokus och återtar det.
Standardvärdet är false.
Implementering
public function get autoCorrect():Boolean
public function set autoCorrect(value:Boolean):void
clearButtonMode | egenskap |
clearButtonMode:String
[lässkyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 23 |
clearButton-läget för det aktuella StageText-objektet. Det finns fyra lägen som är kopplade till den här egenskapen:
-
Om du vill visa clearButton vid redigering:
StageTextClearButtonMode.WHILE_EDITING
-
Om du aldrig vill visa clearButton:
StageTextClearButtonMode.NEVER
-
Om du alltid vill visa clearButton:
StageTextClearButtonMode.ALWAYS
-
Om du vill visa clearButton när du inte redigerar:
StageTextClearButtonMode.UNLESS_EDITING
clearButtonMode
inställd på StageTextClearButtonMode.WHILE_EDITING
.
Obs! Den här egenskapen stöds bara i iOS.
Implementering
public function set clearButtonMode(value:String):void
color | egenskap |
color:uint
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Anger textfärg. Du kan ange textfärg som ett tal med tre 8-bitars RGB-komponenter. Den första komponenten representerar rött, den andra grönt och den tredje blått. Till exempel kommer 0xFF0000
att ange rött, 0x00FF00
grönt och 0x0000FF
blått. Standardtextfärgen är svart (0x000000
).
Standardvärdet är 0x000000.
Implementering
public function get color():uint
public function set color(value:uint):void
displayAsPassword | egenskap |
displayAsPassword:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Anger om textfältet är ett textfält för lösenord. Om det är true
kommer inmatade tecken att döljas med lämpligt tecken (till exempel en asterisk).
Obs! Om du aktiverar displayAsPassword
när text redigeras eller på annat sätt har fokus används inte det uppdaterade beteendet förrän texten släpper fokus och återtar det.
Viktigt! På iOS visas inte ersättningstecken för ett textobjekt på en flerradsscen även om värdet för egenskapen är true
.
Standardvärdet är false.
Implementering
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
editable | egenskap |
fontFamily | egenskap |
fontFamily:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Anger namnet för den aktuella teckensnittsfamiljen. Ett värde på null anger systemets standardvärde. Om du vill räkna upp tillgängliga teckensnitt ska du använda flash.text.Font.enumerateFonts()
. Om teckensnittsfamiljen är okänd kommer standardteckensnittesfamiljen att användas.
Standardvärdet är null.
Implementering
public function get fontFamily():String
public function set fontFamily(value:String):void
fontPosture | egenskap |
fontPosture:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Anger att konstanter som definierats i FontPosture-klassen används för teckensnittsläget.
Standardvärdet är FontPosture.NORMAL.
Implementering
public function get fontPosture():String
public function set fontPosture(value:String):void
Utlöser
ArgumentError — Om den anges till ett värde som inte är medlem av FontPosture
|
Relaterade API-element
fontSize | egenskap |
fontWeight | egenskap |
fontWeight:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Anger att konstanter som definierats i FontPosture-klassen används för teckensnittsstilen.
Standardvärdet är FontWeight.NORMAL.
Implementering
public function get fontWeight():String
public function set fontWeight(value:String):void
Utlöser
ArgumentError — Om den anges till ett värde som inte är medlem av FontWeight
|
Relaterade API-element
locale | egenskap |
locale:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Anger textens språk. För StageText används vanliga språkidentifierare. Till exempel används "en", "en_US" och "en-US" för engelska och "ja" för japanska. Den här iso639-2-kodlistan innehåller en lista över språkkoder.
Standardvärdet är en.
Implementering
public function get locale():String
public function set locale(value:String):void
maxChars | egenskap |
maxChars:int
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Anger maximalt antal tecken som en användare kan skriva i textfältet. Ett skript kan infoga mer text än vad som tillåts med maxChars
. Om maxChars
är noll, kan användaren skriva in ett obegränsat antal tecken i textfältet.
Standardvärdet är 0.
Implementering
public function get maxChars():int
public function set maxChars(value:int):void
multiline | egenskap |
multiline:Boolean
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Anger om StageText-objektet kan visa flera textrader. Skrivskyddad. Detta värde motsvarar egenskapen multiline
i StageTextInitOptions-objektet som används under konstruktionen.
Implementering
public function get multiline():Boolean
Relaterade API-element
restrict | egenskap |
restrict:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Begränsar den uppsättning tecken som en användare kan skriva i textfältet. Systemet söker igenom strängen restrict
från vänster till höger.
Med värdet för restrict
anges följande regler för textinmatningsbegränsning:
- Om värdet är
null
, kan användaren ange valfritt tecken. - Om värdet är en tom sträng kan användaren inte ange några tecken.
- Om värdet är en teckensträng kan användaren endast ange tecknen i strängen.
- Om värdet innehåller ett inskjutningstecken (^) kan användaren inte ange några tecken efter inskjutningstecknet.
- Genom att använda bindestrecket (-) kan värdet ange ett intervall med tillåta inmatningstecknen.
- Värdet kan använda escape-sekvensen
\u
för att skapa enrestrict
-sträng.
Specialtecken:
Använd ett omvänt snedstreck för att ange ett inskjutningstecken (^) eller ett bindestreck (-). Sekvenserna med omvänt snedstreck är \-, \^ eller \\. Det omvända snedstrecket kan vara ett tecken i strängen. När du anger ett omvänt snedstreck i ActionScript ska du dubblera tecknet.
Exempel på inställningar för restrict
-egenskapen:
I följande exempel tillåts användaren att endast ange bindestrecket (-) och inskjutningstecknet (^):
my_txt.restrict = "\\-\\^";
I följande exempel tillåts användaren att endast ange versaler, blanksteg och tal:
my_txt.restrict = "A-Z 0-9";
I följande exempel exkluderas endast gemener:
my_txt.restrict = "^a-z";
I följande exempel tillåts användaren endast att använda versaler, förutom versalt Q.
my_txt.restrict = "A-Z^Q";
I följande exempel tillåts användaren att endast ange tecken från ASCII 32 (blanksteg) till ASCII 126 (tilde).
my_txt.restrict = "\u0020-\u007E";
Obs! Begränsningarna gäller endast för användarinmatningar, med ett skript kan du ange vilka tecken som helst i textfältet.
Standardvärdet är null.
Implementering
public function get restrict():String
public function set restrict(value:String):void
returnKeyLabel | egenskap |
returnKeyLabel:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Anger etiketten för returtangenten för enheter med ett skärmtangentbord. Tillgängliga värden är konstanter definierade i klassen ReturnKeyLabel
:
- "default"
- "done"
- "go"
- "next"
- "search"
Den här egenskapen är bara ett tips till den bakomliggande plattformen eftersom inte alla enheter och operativsystem har stöd för dessa värden. Egenskapen har ingen effekt på enheter som inte har skärmtangentbord.
Standardvärdet är ReturnKeyLabel.DEFAULT.
Implementering
public function get returnKeyLabel():String
public function set returnKeyLabel(value:String):void
Utlöser
ArgumentError — Om den sätts till ett värde som inte är medlem av ReturnKeyLabel
|
Relaterade API-element
selectionActiveIndex | egenskap |
selectionActiveIndex:int
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
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 returnerar den här metoden inmatningspunkten. Om StageText-instansen inte har fokus returnerar den här metoden -1.
På iOS stöds den här egenskapen inte för StageText-objekt som bara har en rad och returnerar -1.
Implementering
public function get selectionActiveIndex():int
Relaterade API-element
selectionAnchorIndex | egenskap |
selectionAnchorIndex:int
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
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 returnerar den här metoden inmatningspunkten. Om StageText-instansen inte har fokus returnerar den här metoden -1.
På iOS stöds den här egenskapen inte för StageText-objekt som bara har en rad och returnerar -1.
Implementering
public function get selectionAnchorIndex():int
Relaterade API-element
softKeyboardType | egenskap |
softKeyboardType:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Kontrollerar utseendet på skärmtangentbordet.
Enheter med skärmtangentbord kan anpassa tangentbordets knappar så att de motsvarar den typ av inmatning som förväntas. Om till exempel numeriska värden förväntas kan SoftKeyboardType.NUMBER
användas på en enhet för att endast visa siffror på skärmtangentbordet. Giltiga värden definieras som konstanter i klassen SoftKeyboardType:
- "default"
- "punctuation"
- "url"
- "number"
- "contact"
- "email"
- "phone"
- "decimalpad"
Dessa värden är avsedda som tips som gör att en enhet visar det bästa tangentbordet för den aktuella tillämpningen.
Standardvärdet är SoftKeyboardType.DEFAULT.
Implementering
public function get softKeyboardType():String
public function set softKeyboardType(value:String):void
Utlöser
ArgumentError — Om den sätts till ett värde som inte är en medlem av SoftKeyboardType
|
Relaterade API-element
stage | egenskap |
text | egenskap |
text:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Den aktuella texten i textfältet. Radmatningstecknet ('\r'
, ASCII 13) avskiljer rader med text. Text som finns i den här egenskapen är inte formaterad (den saknar formateringstaggar).
Standardvärdet är null.
Implementering
public function get text():String
public function set text(value:String):void
textAlign | egenskap |
textAlign:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Anger styckejustering. Giltiga värden definieras som konstanter i klassen TextFormatAlign:
- "left"
- "center"
- "right"
- "justify"
- "start"
- "end"
Alla plattformar har inte stöd för varje textAlign
-värde. För textAlign
-värden som inte stöds används i plattformar standardvärdet (TextFormatAlign.START
).
Standardvärdet är TextFormatAlign.START.
Implementering
public function get textAlign():String
public function set textAlign(value:String):void
Utlöser
ArgumentError — Om den sätts till ett värde som inte en är medlem av TextFormatAlign
|
Relaterade API-element
viewPort | egenskap |
viewPort:Rectangle
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Den del på scenen där StageText-objektet visas. Standard är noll-rect:en.
Implementering
public function get viewPort():Rectangle
public function set viewPort(value:Rectangle):void
Utlöser
RangeError — Rectangle-värdet är inte giltigt.
|
visible | egenskap |
StageText | () | Konstruktor |
public function StageText(initOptions:flash.text:StageTextInitOptions = null)
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Skapar ett StageText-objekt.
Objektet StageText är osynligt tills det kopplats till en scen och tills egenskapen viewPort
angetts.
initOptions:flash.text:StageTextInitOptions (default = null )
|
assignFocus | () | metod |
public function assignFocus():void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Tilldelar fokus till StageText-objektet. Inget händer för icke-redigerbara objekt, assignFocus()
.
dispose | () | metod |
public function dispose():void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Släpper StageText-objektet.
Det är valfritt att anrop dispose()
. Om du inte behåller en referens till den här StageText-instansen blir den tillgänglig för skräpinsamling. Om du anropar dispose()
kan skräpinsamlingen ske tidigare eller vid en mer lämplig tidpunkt.
drawViewPortToBitmapData | () | metod |
public function drawViewPortToBitmapData(bitmap:BitmapData):void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3.0 |
Ritar visningsporten för StageText i en bitmapp.
Hämta bitmappen och ställ in att scenen ska vara null
för visning av innehållet ovanför StageText-objektet.
Bitmappen har vanligtvis samma bredd och höjd som visningsrutan. Från och med AIR 15.0 kan bitmappens bredd och höjd också vara contentsScaleFactor
gånger visningsportens bredd och höjd när spelaren använder HiDPI-bildskärmar. På en Mac Retina-skärm är contentsScaleFactor
till exempel 2, eftersom scenens pixelupplösning dubbleras, och bitmappen kan därför vara två gånger så stor som visningsporten.
Om du anropar den här metoden före händelsen Event.COMPLETE
, kan metoden rita upp visningsporten felaktigt.
Parametrar
bitmap:BitmapData — Objektet BitmapData där den synliga delen av visningsporten för StageText ska ritas.
|
Utlöser
ArgumentError — Bitmappens bredd eller höjd skiljer sig från visningsportens bredd eller höjd.
| |
Error — Bitmappen är null.
|
selectRange | () | metod |
public function selectRange(anchorIndex:int, activeIndex:int):void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Markerar text som anges i indexvärden för de första och sista tecknen. Du kan i parametrarna anchorIndex
och activeIndex
ange de första och sista tecknen i markeringen. Om båda parametrarna har samma värde, ställer den här metoden in insättningspunkten.
På iOS, för StageText-objekt med bara en rad, stöds inte den här funktionen och returnerar alltid -1. Om du anropar den här metoden med hela textsträngen markerad är markeringen synlig. Om du däremot anropar den här metoden med bara en del av textsträngen markerad är markeringen inte synlig.
För vissa enheter eller operativsystem, är markeringen bara synlig när StageText-objektet har fokus.
Parametrar
anchorIndex:int — Det nollbaserade indexvärdet för det första tecknet i markeringen (det första tecknets indexindex är 0).
| |
activeIndex:int — Det nollbaserade indexvärdet för det sista tecknet i markeringen.
|
Relaterade API-element
change | Händelse |
flash.events.Event
egenskap Event.type =
flash.events.Event.CHANGE
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Skickas efter att textinnehållet ändrats. Denna händelse kan skickas vid varje förändring, eller inte tills en uppsättning med förändringar är slutförd.
Event.CHANGE
-konstanten definierar värdet på type
-egenskapen i ett change
-händelseobjekt.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
bubbles | true |
cancelable | false ; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Objektet vars värde har modifierats. target är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen. |
complete | Händelse |
flash.events.Event
egenskap Event.type =
flash.events.Event.COMPLETE
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Skickas efter inställning av en scen som inte är null och en visningsport som inte är tom. Anger att implementationen har avslutat layouten för StageText-objektet och du kan nu anropa metoden drawViewPortToBitmapData
. Beroende på vilken plattform det är kan denna händelse skickas synkront eller asynkront med inställningen för stage
eller viewPort
, eller för båda.
Event.COMPLETE
-konstanten definierar värdet på type
-egenskapen i ett complete
-händelseobjekt.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
bubbles | false |
cancelable | false ; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Det nätverksobjekt som har lästs in. |
focusIn | Händelse |
flash.events.FocusEvent
egenskap FocusEvent.type =
flash.events.FocusEvent.FOCUS_IN
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Skickas när användaren redigerar text och kontrollen har tangentbordsfokus.
Definierar värdet för ettfocusIn
-händelseobjekts type
-egenskap.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
bubbles | true |
cancelable | false ; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
keyCode | 0; är bara tillämpligt på keyFocusChange -händelser. |
relatedObject | Den kompletterande InteractiveObject-instansen som påverkas av fokusändringen. |
shiftKey | false ; är bara tillämpligt på keyFocusChange -händelser. |
target | Den InteractiveObject-instans som just hamnat i fokus. target är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen.
|
direction | Riktningen från vilken fokus tilldelades. Den här egenskapen rapporterar värdet på direction -parametern på steget med assignFocus() -metoden. Om fokus ändrades på annat sätt kommer värdet alltid att vara FocusDirection.NONE . Gäller enbart för focusIn -händelser. För alla andra fokushändelser kommer värdet att vara FocusDirection.NONE . |
focusOut | Händelse |
flash.events.FocusEvent
egenskap FocusEvent.type =
flash.events.FocusEvent.FOCUS_OUT
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Skickas när användaren inte längre redigerar text och kontrollen inte längre har tangentbordsfokus.
Definierar värdet för ettfocusOut
-händelseobjekts type
-egenskap.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
bubbles | true |
cancelable | false ; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
keyCode | 0; är bara tillämpligt på keyFocusChange -händelser. |
relatedObject | Den kompletterande InteractiveObject-instansen som påverkas av fokusändringen. |
shiftKey | false ; är bara tillämpligt på keyFocusChange -händelser. |
target | Den InteractiveObject-instans som just hamnat ur fokus. target är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen.
|
keyDown | Händelse |
flash.events.KeyboardEvent
egenskap KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_DOWN
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Skickas när användaren trycker ned en tangent.
Mappning mellan tangenter och specifika tecken varierar mellan olika utrustningar och operativsystem. Denna händelsetyp genereras efter det att sådan mappning sker, men före behandling av ett redigeringsprogram för inmatningsmetoder (IME). IME:er används för att ange tecken som är besväriga att hantera på ett vanligt QWERTY-tangentbord (till exempel kinesiska tecken).
Denna händelse inträffar före keyUp
-händelsen.
Denna händelse skickas inte för alla nycklar. Nyckeln som får denna händelse att skickas varierar mellan olika plattformar.
I AIR går det inte att skriva tecknet i ett textfält om händelsen avbryts.
KeyboardEvent.KEY_DOWN
-konstanten definierar värdet på type
-egenskapen i ett keyDown
-händelseobjekt.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
bubbles | true |
cancelable | true i AIR, false i Flash Player. I AIR går det inte att skriva tecknet i ett textfält om händelsen avbryts. |
charCode | Innehåller värdet för teckenkoden för den senaste tangenten som trycktes ned eller släpptes upp. |
commandKey | true i Macintosh om Kommando-tangenten är aktiv. Annars false |
controlKey | true i Windows och Linux om Ctrl-tangenten är aktiv. true i Macintosh om Ctrl-tangenten är aktiv. Annars false |
ctrlKey | true i Windows och Linux om Ctrl-tangenten är aktiv. true om antingen Ctrl-tangenten eller Kommando-tangenten är aktiv i Macintosh. Annars false . |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
keyCode | Innehåller värdet för tangentkoden för den senaste tangenten som trycktes ned eller släpptes upp. |
keyLocation | Tangentens placering på tangentbordet. |
shiftKey | true om skifttangenten är aktiverad eller false om den är inaktiverad. |
target | Den InteractiveObject-instans som är i fokus. target är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen. |
keyUp | Händelse |
flash.events.KeyboardEvent
egenskap KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_UP
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Skickas när användaren släpper upp en tangent.
Mappning mellan tangenter och specifika tecken varierar mellan olika utrustningar och operativsystem. Denna händelsetyp genereras efter det att sådan mappning sker, men före behandling av ett redigeringsprogram för inmatningsmetoder (IME). IME:er används för att ange tecken som är besväriga att hantera på ett vanligt QWERTY-tangentbord (till exempel kinesiska tecken).
Den här händelsen inträffar efter en keyDown
-händelse.
Denna händelse skickas inte för alla nycklar. Nyckeln som får denna händelse att skickas varierar mellan olika plattformar.
KeyboardEvent.KEY_UP
-konstanten definierar värdet på type
-egenskapen i ett keyUp
-händelseobjekt.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
bubbles | true |
cancelable | false ; det finns inget standardbeteende att avbryta. |
charCode | Innehåller värdet för teckenkoden för den senaste tangenten som trycktes ned eller släpptes upp. |
commandKey | true i Macintosh om Kommando-tangenten är aktiv. Annars false |
controlKey | true i Windows och Linux om Ctrl-tangenten är aktiv. true i Macintosh om Ctrl-tangenten är aktiv. Annars false |
ctrlKey | true i Windows om Ctrl-tangenten är aktiv. true om antingen Ctrl-tangenten eller Kommando-tangenten är aktiv i Macintosh. Annars false . |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
keyCode | Innehåller värdet för tangentkoden för den senaste tangenten som trycktes ned eller släpptes upp. |
keyLocation | Tangentens placering på tangentbordet. |
shiftKey | true om skifttangenten är aktiverad eller false om den är inaktiverad. |
target | Den InteractiveObject-instans som är i fokus. target är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen. |
softKeyboardActivate | Händelse |
flash.events.SoftKeyboardEvent
egenskap SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Skickas sedan skärmtangentbordet har aktiverats på grund av att objektet StageText kommer i fokus.
KonstantenSoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE
definierar värdet för type
-egenskapen SoftKeyboardEvent-objekt när ett skärmtangentbord visas. För den här händelsen är cancellable = false
.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
type | SOFT_KEYBOARD_ACTIVATE |
bubbles | true |
cancelable | false ; det finns inget standardbeteende att avbryta. |
relatedObjectVal | En referens till ett visningslisteobjekt som är relaterat till händelsen. |
triggerTypeVal | Anger om tangentbordshändelsen utlöstes av ett program eller av användaren. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
softKeyboardActivating | Händelse |
flash.events.SoftKeyboardEvent
egenskap SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Skickas innan skärmtangentbordet aktiveras på grund av att objektet StageText kommer i fokus.
KonstantenSoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING
definierar värdet för type
-egenskapen SoftKeyboardEvent-objekt omedelbart innan ett skärmtangentbort visas. För den här händelsen är cancellable = true
.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
type | SOFT_KEYBOARD_ACTIVATING |
bubbles | true |
cancelable | true om inte händelsen skickas av ett StageText-objekt. För StageText-objekt kan händelsen inte avbrytas. |
relatedObjectVal | En referens till ett visningslisteobjekt som är relaterat till händelsen. |
triggerTypeVal | Anger om tangentbordshändelsen utlöstes av ett program eller av användaren. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
softKeyboardDeactivate | Händelse |
flash.events.SoftKeyboardEvent
egenskap SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Skickas sedan skärmtangentbordet har inaktiverats på grund av att objektet StageText har förlorat fokus.
KonstantenSoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE
definierar värdet för type
-egenskapen SoftKeyboardEvent-objekt när ett skärmtangentbord döljs. För den här händelsen är cancellable = false
.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
type | SOFT_KEYBOARD_DEACTIVATE |
bubbles | true |
cancelable | false ; det finns inget standardbeteende att avbryta. |
relatedObjectVal | En referens till ett visningslisteobjekt som är relaterat till händelsen. |
triggerTypeVal | Anger om tangentbordshändelsen utlöstes av ett program eller av användaren. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
Tue Jun 12 2018, 01:40 PM Z