Paket | flash.text |
Klass | public class TextField |
Arv | TextField InteractiveObject DisplayObject EventDispatcher Object |
Underklasser | FlexTextField |
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Om du vill skapa ett textfält dynamiskt använder du konstruktorn TextField()
.
Med metoderna i klassen TextField kan du ställa in, markera och hantera text i ett dynamiskt textfält eller ett textinmatningsfält som du skapar under redigering eller körning.
Med hjälp av ActionScript kan du formatera texten på olika sätt vid körning. Med TextFormat-klassen anger du tecken- och styckeformatering för TextField-objekt. Du kan använda CSS-format (Cascading Style Sheet) för textfält med egenskapen TextField.styleSheet
och klassen StyleSheet. Du kan använda CSS för att ändra inbyggda HTML-taggar, definiera nya formateringstaggar eller använda format. Du kan tilldela HTML-formaterad text, med eller utan CSS, direkt till ett textfält. HTML-text som du kopplar till ett textfält kan innehålla inbäddade medier (filmklipp, SWF-filer, GIF-filer, PNG-filer och JPEG-filer). Texten figursätts runt inbäddade medier på samma sätt som en webbläsare figursätter text runt inbäddade medier i ett HTML-dokument.
Flash Player stöder en delmängd av HTML-taggar som du kan använda vid textformatering. Se listan över de HTML-taggar som stöds i beskrivningen av htmlText
-egenskapen.
Relaterade API-element
Egenskap | Definieras med | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
Den aktuella hjälpmedelsimplementeringen (AccessibilityImplementation) för den här InteractiveObject-instansen. | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
De nuvarande hjälpmedelsalternativen för det här visningsobjektet. | DisplayObject | ||
alpha : Number
Anger det angivna objektets alfagenomskinlighetsvärde. | DisplayObject | ||
alwaysShowSelection : Boolean
Om inställningen är true och textfältet inte är i fokus markerar Flash Player markeringen i textfältet med grått. | TextField | ||
antiAliasType : String
Den typ av kantutjämning som används för det här textfältet. | TextField | ||
autoSize : String
Styr automatisk storleksinställning och justering av textfält. | TextField | ||
background : Boolean
Anger om textfältet har en bakgrundsfyllning. | TextField | ||
backgroundColor : uint
Färgen på textfältets bakgrund. | TextField | ||
blendMode : String
Ett värde från klassen BlendMode som anger vilket blandningsläge som ska användas. | DisplayObject | ||
blendShader : Shader [lässkyddad]
Ställer in en skuggning som används för blandning av förgrund och bakgrund. | DisplayObject | ||
border : Boolean
Anger om textfältet har en kantlinje. | TextField | ||
borderColor : uint
Färgen på textfältets kantlinje. | TextField | ||
bottomScrollV : int [skrivskyddad]
Ett heltal (ett 1-baserat indexvärde) som visar den nedersta raden som är synlig i textfältet som anges. | TextField | ||
cacheAsBitmap : Boolean
Om det är true, sparar Flash-miljöerna en intern bitmappsrepresentation av visningsobjektet i cache-minnet. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
Om detta inte är null definierar det här Matrix-objektet hur ett visningsobjekt återges när cacheAsBitmap har värdet true. | DisplayObject | ||
caretIndex : int [skrivskyddad]
Indexvärdet för inmatningspunkten. | TextField | ||
condenseWhite : Boolean
Ett booleskt värde som anger om extra tomrum (blanksteg, radbrytningar o.s.v.) i ett textfält med HTML-text tas bort. | TextField | ||
constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object | ||
contextMenu : NativeMenu
Anger vilken snabbmeny som är associerad med det här objektet. | InteractiveObject | ||
defaultTextFormat : flash.text:TextFormat
Anger vilket format som ska användas för nyinfogad text, till exempel text som anges av en användare eller text som infogas med metoden replaceSelectedText(). | TextField | ||
displayAsPassword : Boolean
Anger om textfältet har ett lösenord. | TextField | ||
doubleClickEnabled : Boolean
Anger om det här objektet tar emot doubleClick-händelser. | InteractiveObject | ||
embedFonts : Boolean
Anger om rendering ska göras med inbäddade teckensnittskonturer. | TextField | ||
filters : Array
En indexerad array som innehåller varje filterobjekt som är associerat med visningsobjektet. | DisplayObject | ||
focusRect : Object
Anger om det här objektet visar en fokusram. | InteractiveObject | ||
gridFitType : String
Den typ av rutnätspassning som används för det här textfältet. | TextField | ||
height : Number
Anger visningsobjektets höjd i pixlar. | DisplayObject | ||
htmlText : String
Innehåller HTML-representationen av textfältets innehåll. | TextField | ||
length : int [skrivskyddad]
Antalet tecken i ett textfält. | TextField | ||
loaderInfo : LoaderInfo [skrivskyddad]
Returnerar ett LoaderInfo-objekt som innehåller information om hur filen som visningsobjektet tillhör ska läsas in. | DisplayObject | ||
mask : DisplayObject
Det anropande visningsobjektet maskeras av det angivna visningsobjektet. | DisplayObject | ||
maxChars : int
Det maximala antal tecken som en användare kan skriva i textfältet. | TextField | ||
maxScrollH : int [skrivskyddad]
Maxvärdet för scrollH. | TextField | ||
maxScrollV : int [skrivskyddad]
Maxvärdet för scrollV. | TextField | ||
metaData : Object
Erhåller metadataobjektet för instansen DisplayObject om metadata har lagrats tillsammans med instansen för detta DisplayObject i SWF-filen via en PlaceObject4-tagg. | DisplayObject | ||
mouseEnabled : Boolean
Anger om det här objektet tar emot musmeddelanden eller annan indata från användaren. | InteractiveObject | ||
mouseWheelEnabled : Boolean
Ett booleskt värde som anger om Flash Player automatiskt ska rulla textfält med flera rader när användaren klickar i ett textfält och rullar på mushjulet. | TextField | ||
mouseX : Number [skrivskyddad]
Anger x-koordinaten för musens eller användarens indataenhets position i pixlar. | DisplayObject | ||
mouseY : Number [skrivskyddad]
Anger y-koordinaten för musens eller användarens indataenhets position i pixlar. | DisplayObject | ||
multiline : Boolean
Anger om textfältet har flera rader. | TextField | ||
name : String
Anger instansnamnet för DisplayObject. | DisplayObject | ||
needsSoftKeyboard : Boolean
Anger om ett virtuellt tangentbord (t.ex. ett skärmtangentbord) ska visas när den här InteractiveObject-instansen är i fokus. | InteractiveObject | ||
numLines : int [skrivskyddad]
Definierar antalet textrader i ett textfält med flera rader. | TextField | ||
opaqueBackground : Object
Anger om visningsobjektet är ogenomskinligt med en viss bakgrundsfärg. | DisplayObject | ||
parent : DisplayObjectContainer [skrivskyddad]
Anger DisplayObjectContainer-objektet som innehåller visningsobjektet. | DisplayObject | ||
restrict : String
Anger den teckenuppsättning en användare kan använda för att skriva i textfältet. | TextField | ||
root : DisplayObject [skrivskyddad]
För ett visningsobjekt i en inläst SWF-fil är rotegenskapen det översta visningsobjektet i den del av visningslistans trädstruktur som representeras av den SWF-filen. | DisplayObject | ||
rotation : Number
Anger DisplayObject-instansens rotation i grader från den ursprungliga orienteringen. | DisplayObject | ||
rotationX : Number
Anger x-axelsrotationen i grader för DisplayObject-instansen, från den ursprungliga orienteringen i förhållande till den överordnade 3D-behållaren. | DisplayObject | ||
rotationY : Number
Anger y-axelsrotationen i grader för DisplayObject-instansen, från den ursprungliga orienteringen i förhållande till den överordnade 3D-behållaren. | DisplayObject | ||
rotationZ : Number
Anger z-axelsrotationen i grader för DisplayObject-instansen, från den ursprungliga orienteringen i förhållande till den överordnade 3D-behållaren. | DisplayObject | ||
scale9Grid : Rectangle
Det skalningsrutnät som används för närvarande. | DisplayObject | ||
scaleX : Number
Anger vågrät skala (i procent) för objektet utifrån dess registreringspunkt. | DisplayObject | ||
scaleY : Number
Anger lodrät skala (i procent) för objektet utifrån dess registreringspunkt. | DisplayObject | ||
scaleZ : Number
Anger djupskala (procent) för objektet utifrån dess registreringspunkt. | DisplayObject | ||
scrollH : int
Den vågräta rullningspositionen. | TextField | ||
scrollRect : Rectangle
Visningsobjektets gränser för rullningsrektangeln. | DisplayObject | ||
scrollV : int
Den lodräta positionen för texten i ett textfält. | TextField | ||
selectable : Boolean
Ett booleskt värde som anger om ett textfält är markeringsbart. | TextField | ||
selectionBeginIndex : int [skrivskyddad]
Det nollbaserade teckenindexvärdet för det första tecknet i den aktuella markeringen. | TextField | ||
selectionEndIndex : int [skrivskyddad]
Det nollbaserade teckenindexvärdet för det sista tecknet i den aktuella markeringen. | TextField | ||
sharpness : Number
Skärpan på specialtecknens kanter i det här textfältet. | TextField | ||
softKeyboard : String
Kontrollerar utseendet på skärmtangentbordet. | InteractiveObject | ||
softKeyboardInputAreaOfInterest : Rectangle
Definierar det område som ska behållas på skärmen när skärmtangentbordet visas (ej tillgängligt på iOS). | InteractiveObject | ||
stage : Stage [skrivskyddad]
Visningsobjektets scen. | DisplayObject | ||
styleSheet : StyleSheet
Kopplar en formatmall till textfältet. | TextField | ||
tabEnabled : Boolean
Anger om det här objektet inkluderas i tabbordningen. | InteractiveObject | ||
tabIndex : int
Anger tabbordningen för objekt i en SWF-fil. | InteractiveObject | ||
text : String
En sträng som utgör den nuvarande texten i textfältet. | TextField | ||
textColor : uint
Färgen på texten i ett textfält, i hexadecimalt format. | TextField | ||
textHeight : Number [skrivskyddad]
Textens höjd i pixlar. | TextField | ||
textInteractionMode : String [skrivskyddad]
Egenskapen för interaktionsläge. Standardvärdet är TextInteractionMode.NORMAL. | TextField | ||
textWidth : Number [skrivskyddad]
Textens bredd i pixlar. | TextField | ||
thickness : Number
Tjockleken på specialtecknens kanter i det här textfältet. | TextField | ||
transform : flash.geom:Transform
Ett objekt med egenskaper som gäller ett visningsobjekts matris, färgomformning och pixelgränser. | DisplayObject | ||
type : String
Textfältets typ. | TextField | ||
useRichTextClipboard : Boolean
Anger om textformateringen ska kopieras och klistras in med texten. | TextField | ||
visible : Boolean
Om visingsobjektet är synligt eller inte. | DisplayObject | ||
width : Number
Anger visningsobjektets bredd i pixlar. | DisplayObject | ||
wordWrap : Boolean
Ett booleskt värde som anger om textfältet har automatisk radbrytning. | TextField | ||
x : Number
Anger x-koordinaten för DisplayObject-instansen i förhållande till de lokala koordinaterna för den överordnade DisplayObjectContainer. | DisplayObject | ||
y : Number
Anger y-koordinaten för DisplayObject-instansen i förhållande till de lokala koordinaterna för den överordnade DisplayObjectContainer. | DisplayObject | ||
z : Number
Anger z-koordinatens position längs DisplayObject-instansens z-axel i förhållande till den överordnade 3D-behållaren. | DisplayObject |
Metod | Definieras med | ||
---|---|---|---|
Skapar en ny TextField-instans. | TextField | ||
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 | ||
Lägger till strängen som angetts av parametern newText på en del av eller all text i ett textfält. | TextField | ||
Skickar en händelse till händelseflödet. | EventDispatcher | ||
Returnerar en rektangel som definierar visningsområdets område i relation till targetCoordinateSpace-objektets koordinatsystem. | DisplayObject | ||
Returnerar en rektangel som utgör tecknets begränsningsram. | TextField | ||
Returnerar det nollbaserade indexvärdet för tecknet vid den punkt som anges av parametrarna x och y. | TextField | ||
Returnerar ett givet teckenindexvärde för det första tecknet i samma stycke. | TextField | ||
Returnerar en DisplayObject-referens för det angivna ID:t för en bild eller SWF-fil som har lagts till i ett HTML-formaterat textfält med en <img>-tagg. | TextField | ||
Returnerar det nollbaserade indexvärdet för raden vid den punkt som anges av parametrarna x och y. | TextField | ||
Returnerar det nollbaserade indexvärdet för raden som innehåller tecknet som anges av parametern charIndex. | TextField | ||
Returnerar antalet tecken på en viss textrad. | TextField | ||
Returnerar måttinformation om en viss textram. | TextField | ||
Returnerar teckenindexvärdet för det första tecknet på raden som anges av parametern lineIndex. | TextField | ||
Returnerar texten på raden som anges av parametern lineIndex. | TextField | ||
Returnerar längden på det stycke som innehåller ett givet teckenindexvärde. | TextField | ||
Returnerar en rektangel som definierar visningsområdets gräns, baserat på koordinatsystemet som definieras av targetCoordinateSpace-parametern, exklusive eventuella linjer i former. | DisplayObject | ||
Returnerar ett TextFormat-objekt som innehåller formateringsinformation för textintervallet som anges av parametrarna beginIndex och endIndex. | TextField | ||
Konverterar punktobjektet från scenens (globala) koordinater till visningsobjektets (lokala) koordinater. | DisplayObject | ||
Konverterar en tvådimensionell punkt från scenens (globala) koordinater till ett tredimensionellt visningsobjekts (lokala) koordinater. | DisplayObject | ||
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 | ||
Utvärderar begränsningsramen för visningsobjektet för att kontrollera om den överlappar eller korsar begränsningsramen för obj-visningsobjektet. | DisplayObject | ||
Utvärderar visningsobjektet för att avgöra om det överlappar eller korsar den punkt som anges av x- och y-parametrarna. | DisplayObject | ||
[statisk]
Returnerar true om ett inbäddat teckensnitt är tillgängligt med angivet fontName och fontStyle, där Font.fontType är flash.text.FontType.EMBEDDED. | TextField | ||
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter. | Object | ||
Konverterar en tredimensionell punkt för det tredimensionella visningsobjektets (lokala) koordinater till en tvådimensionell punkt i scenens (globala) koordinater. | DisplayObject | ||
Konverterar punktobjektet från visningsobjektets (lokala) koordinater till scenens (globala) koordinater. | DisplayObject | ||
Anger om den angivna egenskapen finns och är uppräkningsbar. | Object | ||
Tar bort en avlyssnare från EventDispatcher-objektet. | EventDispatcher | ||
Ersätter markeringen med innehållet i parametern value. | TextField | ||
Ersätter teckenintervallet som anges av parametrarna beginIndex och endIndex med innehållet i parametern newText. | TextField | ||
Visar ett virtuellt tangentbord. | InteractiveObject | ||
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder. | Object | ||
Anges som markerad text som definierats av indexvärdena för det första och sista tecknet, som anges med parametrarna beginIndex och endIndex. | TextField | ||
Använder textformateringen som angetts av formatparametern på den angivna texten i ett textfält. | TextField | ||
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 när ett visningsobjekt läggs till i visningslistan. | DisplayObject | |||
Skickas när ett visningsobjekt läggs till i scenens visningslista, antingen direkt eller genom tillägg av ett underträd som innehåller visningsobjektet. | DisplayObject | |||
Skickas efter att ett kontrollvärde har modifierats, till skillnad från textInput-händelsen som skickas innan värdet är modifierat. | TextField | |||
Skickas när användaren väljer ”Ta bort” på textinnehållsmenyn. | InteractiveObject | |||
Skickas när en användare trycker ner och släpper upp huvudknappen på sitt pekdon över samma InteractiveObject. | InteractiveObject | |||
Skickas när en användargest utlöser den snabbmeny som är kopplad till detta interaktiva objekt i ett AIR-program. | InteractiveObject | |||
Skickas när användaren aktiverar den plattformsspecifika tangentkombinationen för funktionen Kopiera eller väljer ”Kopiera” på snabbmenyn. | InteractiveObject | |||
Skickas när användaren aktiverar den plattformsspecifika tangentkombinationen för funktionen Klipp ut eller väljer Klipp ut på snabbmenyn. | InteractiveObject | |||
[utsändningshändelse] Skickas när Flash Player eller AIR förlorar operativsystemfokus och blir inaktivt. | EventDispatcher | |||
Skickas när en användare trycker ner och släpper upp huvudknappen på ett pekdon två gånger i snabb följd över samma InteractiveObject när detta objekts doubleClickEnabled-flagga är satt till true. | InteractiveObject | |||
[utsändningshändelse] Skickas när spelhuvudet går in i en ny bildruta. | DisplayObject | |||
[utsändningshändelse] Skickas när spelhuvudet stänger den aktuella bildrutan. | DisplayObject | |||
Skickas när ett visningsobjekt fokuserats. | InteractiveObject | |||
Skickas när ett visningsobjekt tappar fokusering. | InteractiveObject | |||
[utsändningshändelse] Skickas efter att konstruktorerna för bildrutevisningsobjekt har körts men innan bildruteskript har körts. | DisplayObject | |||
Skickas när användaren skapar en kontaktpunkt längs pekytans kant med en InteractiveObject-instans (såsom att trycka längs kanten av pekytan på Siri Remote för Apple-TV). Vissa enheter kan också tolka denna kontakt som en kombination av flera pekhändelser. | InteractiveObject | |||
Skickas när användaren trycker på två kontaktpunkter över samma InteractiveObject-instans på en beröringsaktiverad enhet (som att trycka med två fingrar och sedan släppa dem över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | |||
Skickas när användaren flyttar en kontaktpunkt över InteractiveObject-instansen på en beröringsaktiverad enhet (som att flytta ett finger från vänster till höger över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | |||
Skickas när användaren utför en rotationsgest vid en kontaktpunkt med en InteractiveObject-instans (som att vidröra en skärm med två fingrar och rotera dem över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | |||
Skickas när användaren utför en svepningsgest vid en kontaktpunkt med en InteractiveObject-instans (som att vidröra en skärm med tre fingrar och sedan flytta fingrarna parallellt över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | |||
Skickas när användaren skapar en kontaktpunkt med en InteractiveObject-instans och sedan vidrör en beröringsaktiverad enhet (som att placera flera fingrar över ett visningsobjekt för att öppna en meny och sedan använda ett finger för att peka på ett menyalternativ på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | |||
Skickas när användaren utför en zoomningsgest vid en kontaktpunkt med en InteractiveObject-instans (som att vidröra en skärm med två fingrar och sedan snabbt sära på fingrarna över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | |||
Den här händelsen skickas till alla klientprogram som har stöd för indata via ett redigeringsprogram för inmatningsmetoder (IME). | InteractiveObject | |||
Skickas när användaren trycker på en tangent. | InteractiveObject | |||
Skickas när användaren försöker att ändra fokuseringen med tangentbordsnavigering. | InteractiveObject | |||
Skickas när användaren släpper upp en tangent. | InteractiveObject | |||
Skickas när en användare klickar på en hyperlänk i ett HTML-aktiverat textfält där URL-adressen börjar på "event". | TextField | |||
Skickas när en användare trycker ned och släpper upp mittenknappen på sitt pekdon över samma InteractiveObject. | InteractiveObject | |||
Skickas när en användare trycker på pekdonets mittenknapp över en InteractiveObject-instans. | InteractiveObject | |||
Skickas när en användare släpper pekdonets knapp över en InteractiveObject-instans. | InteractiveObject | |||
Skickas när en användare trycker på pekdonets knapp över en InteractiveObject-instans. | InteractiveObject | |||
Skickas när användaren försöker att ändra fokuseringen med ett pekdon. | InteractiveObject | |||
Skickas när en användare flyttar pekdonet när det befinner sig över ett InteractiveObject. | InteractiveObject | |||
Skickas när användaren flyttar bort pekdonet från en InteractiveObject-instans. | InteractiveObject | |||
Skickas när användaren flyttar pekdonet över en InteractiveObject-instans. | InteractiveObject | |||
Skickas när en användare släpper pekdonets knapp över en InteractiveObject-instans. | InteractiveObject | |||
Skickas när mushjulet rullas över en InteractiveObject-instans. | InteractiveObject | |||
Skickas av drag initiator InteractiveObject när användaren släpper dragrörelsen. | InteractiveObject | |||
Skickas av ett InteractiveObject-målobjekt när ett objekt dras till målobjektet och dragningen har accepterats med ett anrop till DragManager.acceptDragDrop(). | InteractiveObject | |||
Skickas av ett InteractiveObject-objekt när en dragrörelse går in i dess gränser. | InteractiveObject | |||
Skickas av ett InteractiveObject-objekt när en dragrörelse går utanför dess gränser. | InteractiveObject | |||
Skickas kontinuerligt av ett InteractiveObject-objekt när en dragrörelse pågår inom dess gränser. | InteractiveObject | |||
Skickas i början av en dragning av det InteractiveObject-objekt som anges som dragningsinitierare i DragManager.doDrag()-anropet. | InteractiveObject | |||
Skickas under en dragning av det InteractiveObject-objekt som anges som dragningsinitierare i DragManager.doDrag()-anropet. | InteractiveObject | |||
Skickas när användaren aktiverar den plattformsspecifika tangentkombinationen för funktionen Klistra in eller väljer Klistra in på snabbmenyn. | InteractiveObject | |||
Skickas när användaren sänker en aktiv penna förbi skärmens upptäcktströskel. | InteractiveObject | |||
Skickas när användaren lyfter en aktiv penna över skärmens upptäcktströskel. | InteractiveObject | |||
Skickas när användaren flyttar en aktiv penna över skärmen medan den behålls inom skärmens upptäcktströskel. | InteractiveObject | |||
Skickas när användaren flyttar en aktiv penna bort från detta InteractiveObject medan den behålls inom skärmens upptäcktströskel. | InteractiveObject | |||
Skickas när användaren flyttar en aktiv penna direkt över detta InteractiveObject medan den behålls inom skärmens upptäcktströskel. | InteractiveObject | |||
Skickas när användaren flyttar en aktiv penna bort från detta InteractiveObject och något av dess underordnade objekt medan den behålls inom skärmens upptäcktströskel. | InteractiveObject | |||
Skickas när användaren flyttar en aktiv penna över detta InteractiveObject från utsidan av objektets underordnade träd i visningslistan (men stannar kvar inom skärmens upptäcktströskel). | InteractiveObject | |||
Skickas när användaren släpper knappen på pekaren efter att första ha tryckt på den över en InteractiveObject-instans och sedan flyttat pekaren bort från InteractiveObject-instansen. | InteractiveObject | |||
Skickas när ett visningsobjekt ska tas bort från visningslistan. | DisplayObject | |||
Skickas när ett visningsobjekt ska tas bort från visningslistan, antingen direkt eller genom borttagning av ett underträd som innehåller visningsobjektet. | DisplayObject | |||
[utsändningshändelse] Skickas när visningslistan ska uppdateras och återges. | DisplayObject | |||
Skickas när en användare trycker ned och släpper upp högerknappen på sitt pekdon över samma InteractiveObject. | InteractiveObject | |||
Skickas när en användare trycker på pekdonets knapp över en InteractiveObject-instans. | InteractiveObject | |||
Skickas när en användare släpper pekdonets knapp över en InteractiveObject-instans. | InteractiveObject | |||
Skickas när användaren flyttar bort pekdonet från en InteractiveObject-instans. | InteractiveObject | |||
Skickas när användaren flyttar pekdonet över en InteractiveObject-instans. | InteractiveObject | |||
Skickas av ett TextField-objekt efter att användaren rullat. | TextField | |||
Skickas när användaren aktiverar den plattformsspecifika tangentkombinationen för funktionen Markera allt eller väljer Markera allt på snabbmenyn. | InteractiveObject | |||
Skickas omedelbart efter att skärmtangentbordet tas fram (visas). | InteractiveObject | |||
Skickas omedelbart innan skärmtangentbordet tas fram (visas). | InteractiveObject | |||
Skickas omedelbart efter att skärmtangentbordet döljs. | InteractiveObject | |||
Skickas när värdet på objektets tabChildren-flagga ändras. | InteractiveObject | |||
Skickas när objektets tabEnabled-flagga ändras. | InteractiveObject | |||
Skickas när värdet på objektets tabIndex-egenskap ändras. | InteractiveObject | |||
Flash Player skickar textInput-händelsen när en användare anger ett eller fler texttecken. | TextField | |||
Flash Player skickar textInteractionModeChange-händelsen när en användare ändrar interaktionsläget för ett textfält. | TextField | |||
Skickas när användaren först kontaktar en beröringsaktiverad enhet (som att vidröra en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | |||
Skickas när användaren avslutar kontakten med en beröringsaktiverad enhet (som att lyfta fingret från en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | |||
Skickas när användaren rör enheten och skickas kontinuerligt tills kontaktpunkten avlägsnas. | InteractiveObject | |||
Skickas när användaren flyttar kontaktpunkten bort från en InteractiveObject-instans på en beröringsaktiverad enhet (som att dra fingret från ett visningsobjekt till ett annat på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | |||
Skickas när användaren flyttar kontaktpunkten över en InteractiveObject-instans på en beröringsaktiverad enhet (som att dra fingret från en punkt utanför ett visningsobjekt till en punkt över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | |||
Skickas när användaren flyttar kontaktpunkten bort från en InteractiveObject-instans på en beröringsaktiverad enhet (som att dra fingret från ett visningsobjekt till en punkt utanför visningsobjektet på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | |||
Skickas när användaren flyttar kontaktpunkten över en InteractiveObject-instans på en beröringsaktiverad enhet (som att dra fingret från en punkt utanför ett visningsobjekt till en punkt över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | |||
Skickas när användaren lyfter kontaktpunkten över samma InteractiveObject-instans där kontakten initierades på en beröringsaktiverad enhet (som att trycka med fingret och sedan släppa det vid en enda kontaktpunkt över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject |
alwaysShowSelection | egenskap |
alwaysShowSelection:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Om inställningen är true
och textfältet inte är i fokus markerar Flash Player markeringen i textfältet med grått. Om inställningen är false
och textfältet inte är i fokus markerar Flash Player markeringen i textfältet med grått.
Standardvärdet är false.
Implementering
public function get alwaysShowSelection():Boolean
public function set alwaysShowSelection(value:Boolean):void
Relaterade API-element
Exempel ( Så här använder du exemplet )
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_alwaysShowSelection extends Sprite { public function TextField_alwaysShowSelection() { var label1:TextField = createCustomTextField(0, 20, 200, 20); label1.text = "This text is selected."; label1.setSelection(0, 9); label1.alwaysShowSelection = true; var label2:TextField = createCustomTextField(0, 50, 200, 20); label2.text = "Drag to select some of this text."; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
antiAliasType | egenskap |
antiAliasType:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Den typ av kantutjämning som används för det här textfältet. Använd flash.text.AntiAliasType
-konstanter för den här egenskapen. Du kan bara styra inställningen om teckensnittet är inbäddat (med egenskapen embedFonts
inställd på true
). Standardinställningen är flash.text.AntiAliasType.NORMAL
.
Använd följande strängvärden när du ska ange värden för den här egenskapen:
Strängvärde | Beskrivning |
---|---|
flash.text.AntiAliasType.NORMAL | Använder kantutjämning för vanlig text. Detta värde motsvarar den typ av kantutjämning som används i Flash Player version 7 och tidigare. |
flash.text.AntiAliasType.ADVANCED | Använder avancerad kantutjämning som gör texten mer läsbar. (Funktionen är tillgänglig i Flash Player 8.) Med avancerad kantutjämning kan typsnitt återges med mycket hög kvalitet för små teckenstorlekar. Detta fungerar bäst i program som innehåller stora mängder liten text. Avancerad kantutjämning rekommenderas inte för teckensnitt som är större än 48 punkter. |
Implementering
public function get antiAliasType():String
public function set antiAliasType(value:String):void
Relaterade API-element
autoSize | egenskap |
autoSize:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Styr automatisk storleksinställning och justering av textfält. Tillåtna värden för TextFieldAutoSize
-konstanter: TextFieldAutoSize.NONE
(standard), TextFieldAutoSize.LEFT
, TextFieldAutoSize.RIGHT
och TextFieldAutoSize.CENTER
.
Om autoSize
är inställt på TextFieldAutoSize.NONE
(standard) görs ingen storleksändring.
Om autoSize
är inställd på TextFieldAutoSize.LEFT
behandlas texten som vänsterjusterad text, vilket innebär att den vänstra sidan av textfältet förblir fast och eventuell storleksändring av en enstaka rad i textfältet sker på höger sida. Om texten innehåller en radbrytning (till exempel "\n"
eller "\r"
) ändras storleken på den nedersta delen så att den passar med nästa textrad. Om wordWrap
också är inställd på true
ändras storleken bara för den nedersta delen av textfältet, medan högersidan förblir fast.
Om autoSize
är inställd på TextFieldAutoSize.RIGHT
behandlas texten som högerjusterad text, vilket innebär att den högra sidan av textfältet förblir fast och storleksändring av en enstaka rad i textfältet sker på vänster sida. Om texten innehåller en radbrytning (till exempel "\n" eller "\r")
ändras storleken på den nedersta delen så att den passar med nästa textrad. Om wordWrap
också är inställd på true
ändras storleken bara för den nedersta delen av textfältet, medan vänstersidan förblir fast.
Om autoSize
är inställd på TextFieldAutoSize.CENTER
behandlas texten som centrerad text, vilket innebär att en storleksändring av en enstaka rad i textfältet distribueras jämnt på vänster och höger marginal. Om texten innehåller en radbrytning (till exempel "\n"
eller "\r"
) ändras storleken på den nedersta delen så att den passar med nästa textrad. Om wordWrap
också är inställd på true
ändras storleken bara för den nedersta delen av textfältet, medan höger och vänster sida förblir fasta.
Implementering
public function get autoSize():String
public function set autoSize(value:String):void
Utlöser
ArgumentError — Det angivna autoSize är inte medlem av flash.text.TextFieldAutoSize.
|
Relaterade API-element
background | egenskap |
background:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Anger om textfältet har en bakgrundsfyllning. Värdet true
innebär att textfältet har en bakgrundsfyllning. Värdet false
innebär att textfältet inte har någon bakgrundsfyllning. Använd egenskapen backgroundColor
för att ställa in bakgrundsfärgen i ett textfält.
Standardvärdet är false.
Implementering
public function get background():Boolean
public function set background(value:Boolean):void
Relaterade API-element
backgroundColor | egenskap |
backgroundColor:uint
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Färgen på textfältets bakgrund. Standardvärdet är 0xFFFFFF
(vitt). Egenskapen kan hämtas eller ställas in, även om det inte finns någon bakgrund, men färgen är bara synlig om textfältet har egenskapen background
inställd på true
.
Implementering
public function get backgroundColor():uint
public function set backgroundColor(value:uint):void
Relaterade API-element
border | egenskap |
border:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Anger om textfältet har en kantlinje. Värdet true
innebär att textfältet har en kantlinje. Värdet false
innebär att textfältet inte har en kantlinje. Använd egenskapen borderColor
för att ställa in kantlinjefärgen.
Standardvärdet är false.
Implementering
public function get border():Boolean
public function set border(value:Boolean):void
Relaterade API-element
borderColor | egenskap |
borderColor:uint
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Färgen på textfältets kantlinje. Standardvärdet är 0x000000
(svart). Egenskapen kan hämtas eller ställas in, även om det inte finns någon kantlinje, men färgen är bara synlig om textfältet har egenskapen border
inställd på true
.
Implementering
public function get borderColor():uint
public function set borderColor(value:uint):void
Relaterade API-element
bottomScrollV | egenskap |
bottomScrollV:int
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ett heltal (ett 1-baserat indexvärde) som visar den nedersta raden som är synlig i textfältet som anges. Se textfältet som ett fönster på ett textblock. Egenskapen scrollV
är det ettbaserade indexvärdet i den översta synliga raden i fönstret.
All text mellan raderna som anges av scrollV
och bottomScrollV
är synliga i textfältet.
Implementering
public function get bottomScrollV():int
Relaterade API-element
caretIndex | egenskap |
caretIndex:int
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Indexvärdet för inmatningspunkten. Om ingen inmatningspunkt visas är värdet det läge inmatningspunkten skulle ha om du återställde fokus till fältet (vanligtvis på den plats inmatningspunkten senast var, eller noll om fältet inte haft något fokus).
Index för markeringsomfång är nollbaserade (den första positionen är 0, den andra är 1 och så vidare).
Implementering
public function get caretIndex():int
Relaterade API-element
Exempel ( Så här använder du exemplet )
printCursorPosition
anropas när användaren klickar på textfältet. I det här fallet visas värdena för egenskaperna caretIndex
, selectionBeginIndex
och selectionEndIndex
.
Kör det här exemplet och försök att klicka i textfältet för att markera text. Klicka sedan i fältet utan att markera text. Om du klickar i texten utan att göra någon markering visar egenskapen caretIndex
var inmatningspunkten är, och egenskaperna selectionBeginIndex
och selectionEndIndex
är lika med egenskapsvärdet caretIndex
.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_caretIndex extends Sprite { public function TextField_caretIndex() { var tf:TextField = createCustomTextField(10, 10, 100, 100); tf.wordWrap = true; tf.type = TextFieldType.INPUT; tf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text."; tf.addEventListener(MouseEvent.CLICK, printCursorPosition); } private function printCursorPosition(event:MouseEvent):void { var tf:TextField = TextField(event.target); trace("caretIndex:", tf.caretIndex); trace("selectionBeginIndex:", tf.selectionBeginIndex); trace("selectionEndIndex:", tf.selectionEndIndex); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
condenseWhite | egenskap |
condenseWhite:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ett booleskt värde som anger om extra tomrum (blanksteg, radbrytningar o.s.v.) i ett textfält med HTML-text tas bort. Standardvärdet är false
. Egenskapen condenseWhite
påverkar bara text som anges med egenskapen htmlText
, inte med egenskapen text
. Om du anger text med egenskapen text
ignoreras condenseWhite
.
Om du ställer in condenseWhite
på true
måste du använda standard-HTML-kommandon, till exempel <BR>
och <P>
, för att placera radbrytningar i textfältet.
Ställ in egenskapen condenseWhite
innan du ställer in egenskapen htmlText
.
Implementering
public function get condenseWhite():Boolean
public function set condenseWhite(value:Boolean):void
Relaterade API-element
Exempel ( Så här använder du exemplet )
condenseWhite
på false
och på true
:
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_condenseWhite extends Sprite { public function TextField_condenseWhite() { var tf1:TextField = createCustomTextField(0, 0, 200, 50); tf1.condenseWhite = false; tf1.htmlText = "keep on\n\ttruckin'"; var tf2:TextField = createCustomTextField(0, 120, 200, 50); tf2.condenseWhite = true; tf2.htmlText = "keep on\n\ttruckin'"; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.border = true; addChild(result); return result; } } }
defaultTextFormat | egenskap |
defaultTextFormat:flash.text:TextFormat
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Anger vilket format som ska användas för nyinfogad text, till exempel text som anges av en användare eller text som infogas med metoden replaceSelectedText()
.
Obs! När tecken som ska bytas ut markeras med setSelection()
och replaceSelectedText()
, används defaultTextFormat
endast om texten har markerats upp till och med det sista tecknet. Exempel:
var my_txt:TextField new TextField(); my_txt.text = "Flash Macintosh version"; var my_fmt:TextFormat = new TextFormat(); my_fmt.color = 0xFF0000; my_txt.defaultTextFormat = my_fmt; my_txt.setSelection(6,15); // partial text selected - defaultTextFormat not applied my_txt.setSelection(6,23); // text selected to end - defaultTextFormat applied my_txt.replaceSelectedText("Windows version");
När du kommer åt egenskapen defaultTextFormat
definieras alla egenskaper för TextFormat-objektet som returneras. Ingen egenskap är null
.
Obs! Du kan inte ange den här egenskapen om en formatmall används på textfältet.
Implementering
public function get defaultTextFormat():flash.text:TextFormat
public function set defaultTextFormat(value:flash.text:TextFormat):void
Utlöser
Error — Metoden kan inte användas på ett textfält med en formatmall.
|
Relaterade API-element
displayAsPassword | egenskap |
displayAsPassword:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Anger om textfältet har ett lösenord. Om värdet för egenskapen är true
behandlas textfältet som ett password-textfält som döljer inmatningstecknen med asterisker i stället för de riktiga tecknen. Värdet false
innebär att textfältet inte behandlas som ett password-textfält. När password-läget är aktiverat fungerar inte kommandona Klipp ut och Klistra in eller deras motsvarande kortkommandon. Den här säkerhetstekniken förebygger att obehöriga användare använder genvägar för att ta reda på ett lösenord på en dator som är obevakad.
Standardvärdet är false.
Implementering
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
embedFonts | egenskap |
embedFonts:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Anger om rendering ska göras med inbäddade teckensnittskonturer. Om det är false
visar Flash Player textfältet med enhetens teckensnitt.
Om du ställer in egenskapen embedFonts
på true
för ett textfält måste du ange ett teckensnitt för den texten med hjälp av font
-egenskapen i ett TextFormat-objekt som tillämpas på textfältet. Om det angivna teckensnittet inte är inbäddat i SWF-filen visas inte texten.
Standardvärdet är false.
Implementering
public function get embedFonts():Boolean
public function set embedFonts(value:Boolean):void
Relaterade API-element
gridFitType | egenskap |
gridFitType:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Den typ av rutnätspassning som används för det här textfältet. Den här egenskapen gäller bara om textfältets flash.text.AntiAliasType
-egenskap är inställd på flash.text.AntiAliasType.ADVANCED
.
Den typ av rutnätspassning som används avgör om Flash Player tvingar tydliga vågräta och lodräta rader att passa till ett pixel- eller delpixelrutnät, eller inte alls.
För egenskapen flash.text.GridFitType
kan du använda följande strängvärden:
Strängvärde | Beskrivning |
---|---|
flash.text.GridFitType.NONE | Ingen rutnätspassning används. Vågräta och lodräta linjer i glyferna tvingas inte till pixelrutnätet. Den här inställningen rekommenderas för animering och för stora teckenstorlekar. |
flash.text.GridFitType.PIXEL | Anger att tydliga vågräta och lodräta linjer ska passas till rutnätet. Inställningen fungerar endast för vänsterjusterade textfält. Om du vill använda den här inställningen måste textfältets flash.dispaly.AntiAliasType -egenskap vara inställd på flash.text.AntiAliasType.ADVANCED . Inställningen ger normalt den bästa läsbarheten för vänsterjusterad text. |
flash.text.GridFitType.SUBPIXEL | Anger att tydliga vågräta och lodräta linjer passas till delpixelrutnätet på en LCD-skärm. Om du vill använda den här inställningen måste textfältets flash.text.AntiAliasType -egenskap vara inställd på flash.text.AntiAliasType.ADVANCED . Inställningen flash.text.GridFitType.SUBPIXEL rekommenderas vid högerjusterad och centrerad dynamisk text. Detta är ibland en praktisk kompromiss mellan animering och textkvalitet. |
Standardvärdet är pixel.
Implementering
public function get gridFitType():String
public function set gridFitType(value:String):void
Relaterade API-element
Exempel ( Så här använder du exemplet )
gridFitType
-egenskapen. Lägg märke till skillnaden i läsbarhet mellan de första två raderna när du använder det här exemplet. Lägg även märke till den optimala användningen av GridFitType.PIXEL
för vänsterjusterad text och GridFitType.SUBPIXEL
för högerjusterad text.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFormat; import flash.text.TextFieldAutoSize; import flash.text.AntiAliasType; import flash.text.GridFitType; public class gridFitTypeExample extends Sprite { public function gridFitTypeExample() { var format1:TextFormat = new TextFormat(); format1.font="Arial"; format1.size=12; var tf1:TextField = createCustomTextField(0,0,format1,"NONE",TextFieldAutoSize.LEFT,GridFitType.NONE); var tf2:TextField = createCustomTextField(0,30,format1,"PIXEL",TextFieldAutoSize.LEFT,GridFitType.PIXEL); var tf3:TextField = createCustomTextField(300,60,format1,"SUBPIXEL",TextFieldAutoSize.RIGHT,GridFitType.SUBPIXEL); } private function createCustomTextField(x:Number,y:Number,fm:TextFormat,tl:String,tfs:String,gft:String):TextField { var result:TextField = new TextField(); result.x=x; result.y=y; result.embedFonts=true; result.antiAliasType=AntiAliasType.ADVANCED; result.text="This text uses a gridFitType of " + tl; result.autoSize=tfs; result.gridFitType=gft; result.setTextFormat(fm); addChild(result); return result; } } }
htmlText | egenskap |
htmlText:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Innehåller HTML-representationen av textfältets innehåll.
Flash Player stöder följande HTML-taggar:
Tagg | Beskrivning |
---|---|
Ankartagg |
Med <a> -taggen skapas en hypertextlänk och den används med följande attribut:
|
Tagg för fetstil |
Taggen <b> visar text i fetstil. Det måste finnas ett tillgängligt typsnitt för fetstil.
|
Tagg för radbrytning |
Med <br> -taggen skapas en radbrytning i textfältet. För att använda denna tagg måste du ange att textfältet ska innehålla flera rader.
|
Tagg för teckensnitt |
Med <font> -taggen anges ett teckensnitt eller lista med flera teckensnitt för textvisningen. Teckensnittstaggen kan användas med följande attribut:
|
Tagg för bild |
Med <img> -taggen bäddar du in externa bildfiler (JPEG, GIF, PNG), SWF-filer och filmklipp i textfält. Texten visas automatiskt runt de bilder som bäddas in i textfält. Du måste ange att textfältet ska innehålla flera rader för att kunna figursätta texten runt en bild.
Med Flash visas inbäddade medier i ett textfält i full storlek. Om du vill ange dimensionerna på de medier du bäddar in använder du Normalt visas en inbäddad bild i ett textfält på raden efter För AIR-innehåll i programmets säkerhetssandlåda ignoreras |
Tagg för kursiv text |
Taggen <i> visar texten i kursiv stil. Det måste finnas ett tillgängligt teckensnitt för kursiv text.
|
Tagg för punktlista |
Med <li> -taggen placeras en punkttyp framför texten som omfattas. Obs! Eftersom Flash Player och AIR inte kan identifiera numrerade och onumrerade listtaggar (<ol> och <ul> ) påverkar de inte hur din lista visas. I listor är onumrerade och alla listobjekt använder punkter.
|
Tagg för stycke |
Med <p> -taggen skapar du ett nytt stycke. För att använda denna tagg måste textfältet ställas in så att det innehåller flera rader. <p> -taggen kan användas med följande attribut:
|
Tagg för textspann |
<span> -taggen används endast ihop med CSS-textformat. Taggen kan användas med följande attribut:
|
Tagg för textformat |
Med
|
Tagg för understruken text |
Taggen <u> visar texten understruken.
|
Flash Player och AIR stöder följande HTML-entiteter:
Entitet | Beskrivning |
---|---|
< | < (mindre än) |
> | > (större än) |
& | & (et-tecken) |
" | " (dubbla citattecken) |
' | ' (apostrof, enkelt citattecken) |
I Flash Player och AIR stöds även explicita teckenkoder, t.ex. & (et-tecken, ASCII) och € (Unicode, €-symbol).
Implementering
public function get htmlText():String
public function set htmlText(value:String):void
Relaterade API-element
Exempel ( Så här använder du exemplet )
tf1
, och en HTML-formaterad sträng kopplas till dess text
-egenskap. När egenskapen htmlText
identifieras, visas den HTML-formaterade strängen med ytterligare taggar (t.ex. <P> och <FONT>) som lagts till automatiskt av Flash Player. När egenskapsvärdet text
identifieras visas den oformaterade strängen utan HTML-taggar.
Samma steg utförs också på ett annat TextField-objekt med namnet tf2
, med det tillägget att ett StyleSheet-objekt kopplas till tf2
-objektets styleSheet
-egenskap innan dess htmlText
-egenskap anges. När htmlText
-egenskapen identifieras i detta fall, omfattas endast den exakta HTML-texten som ursprungligen kopplades till htmlText
-egenskapen, vilket visar att inga fler taggar har lagts till av Flash Player.
package { import flash.display.Sprite; import flash.text.StyleSheet; import flash.text.TextField; public class TextField_text extends Sprite { public function TextField_text() { var tf1:TextField = createCustomTextField(10, 10, 400, 22); tf1.htmlText = "<b>Lorem ipsum dolor sit amet.</b>"; // htmlText: <P ALIGN="LEFT"><FONT FACE="Times New Roman" SIZE="12" COLOR="#000000" LETTERSPACING="0" KERNING="0"><b>Lorem ipsum dolor sit amet.</b></FONT></P> trace("htmlText: " + tf1.htmlText); // text: Lorem ipsum dolor sit amet. trace("text: " + tf1.text); var tf2:TextField = createCustomTextField(10, 50, 400, 22); tf2.styleSheet = new StyleSheet(); tf2.htmlText = "<b>Lorem ipsum dolor sit amet.</b>"; // htmlText: <b>Lorem ipsum dolor sit amet.</b> trace("htmlText: " + tf2.htmlText); // text: Lorem ipsum dolor sit amet. trace("text: " + tf2.text); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
length | egenskap |
maxChars | egenskap |
maxChars:int
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Det maximala antal tecken som en användare kan skriva i textfältet. Ett skript kan infoga mer text än vad maxChars
tillåter. Egenskapen maxChars
visar bara hur mycket text som en användare kan ange. Om värdet för den här egenskapen är 0
finns det ingen gräns för hur mycket text som en användare kan ange.
Standardvärdet är 0.
Implementering
public function get maxChars():int
public function set maxChars(value:int):void
maxScrollH | egenskap |
maxScrollV | egenskap |
mouseWheelEnabled | egenskap |
mouseWheelEnabled:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Ett booleskt värde som anger om Flash Player automatiskt ska rulla textfält med flera rader när användaren klickar i ett textfält och rullar på mushjulet. Standardvärdet är true
. Egenskapen är användbar om du vill förhindra att mushjulet rullar textfält eller om du vill implementera egen rullning av textfält.
Implementering
public function get mouseWheelEnabled():Boolean
public function set mouseWheelEnabled(value:Boolean):void
multiline | egenskap |
multiline:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Anger om textfältet har flera rader. Om värdet är true
har textfältet flera rader. Om värdet är false
har textfältet en rad. I ett fält av typen TextFieldType.INPUT
avgör värdet multiline
om Enter
-tangenten skapar en ny rad (om värdet är false
ignoreras Enter
-tangenten). Om du klistrar in text i TextField
med ett multiline
-värde som är false
tas nya rader bort ur texten.
Standardvärdet är false.
Implementering
public function get multiline():Boolean
public function set multiline(value:Boolean):void
Relaterade API-element
numLines | egenskap |
numLines:int
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Definierar antalet textrader i ett textfält med flera rader. Om wordWrap
-egenskapen är inställd på true
ökar antalet rader när texten figursätts.
Implementering
public function get numLines():int
Relaterade API-element
restrict | egenskap |
restrict:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Anger den teckenuppsättning en användare kan använda för att skriva i textfältet. Om värdet för egenskapen restrict
är null
kan du skriva vilket tecken som helst. Om värdet för egenskapen restrict
är en tom sträng kan du inte skriva vilket tecken som helst. Om värdet för restrict
-egenskapen är en teckensträng kan du bara ange tecknen i strängen i textfältet. Strängen läses från vänster till höger. Du kan ange intervall med hjälp av bindestreck (-). Endast användarinteraktionen är begränsad; ett skript kan lägga in alla slags texter i textfältet. Egenskapen synkroniseras inte med alternativen Bädda in teckensnittskonturer i egenskapsinspektören.
Om strängen börjar med cirkumflexen (^) accepteras alla tecken utom de som anges i strängen. Om strängen inte börjar med cirkumflexen (^) accepteras bara de tecken som anges i strängen.
I följande exempel tillåts bara att stora bokstäver, mellanslag och siffror i ett textfält:
my_txt.restrict = "A-Z 0-9";
I följande exempel tillåts alla tecken utom små bokstäver:
my_txt.restrict = "^a-z";
Du kan använda omvänt snedstreck för att ange ett ^ eller - ordagrant. Sekvenserna med omvänt snedstreck är \-, \^ eller \\. Det omvända snedsträcket måste vara ett faktiskt tecken i strängen. Två omvända snedstreck måste användas i ActionScript. I följande kod finns bara strecket (-) och cirkumflexen (^):
my_txt.restrict = "\\-\\^";
^ kan användas var som helst i strängen för att växla mellan att inkludera och exkludera tecken. I följande exempel tillåts bara stora bokstäver, men stora Q utesluts:
my_txt.restrict = "A-Z^Q";
Du kan använda escape-sekvensen \u
för att skapa restrict
-strängar. I följande kod inkluderas bara tecknen från ASCII 32 (mellanslag) till ASCII 126 (tilde).
my_txt.restrict = "\u0020-\u007E";
Standardvärdet är null.
Implementering
public function get restrict():String
public function set restrict(value:String):void
scrollH | egenskap |
scrollH:int
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Den vågräta rullningspositionen. Om egenskapen scrollH
är 0 rullas inte texten vågrätt. Egenskapsvärdet är ett heltal som representerar den vågräta positionen i pixlar.
Enheten för vågrät rullning är pixlar, medan enheten för lodrät rullning är rader. Vågrät rullning mäts i pixlar, eftersom de flesta teckensnitten som du använder har proportionella mellanrum. Det innebär att tecknen kan ha olika bredd. Flash Player utför lodrät rullning efter rad, eftersom användare vanligtvis vill se en hel textrad i stället för en ofullständig rad. Även om det finns flera teckensnitt på en rad anpassas radens höjd för att passa det största teckensnittet som används.
Obs! Egenskapen scrollH
är nollbaserad, inte ettbaserad som den lodräta rullningsegenskapen scrollV
.
Implementering
public function get scrollH():int
public function set scrollH(value:int):void
Relaterade API-element
scrollV | egenskap |
scrollV:int
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Den lodräta positionen för texten i ett textfält. Egenskapen scrollV
är användbar när användare vill hitta ett visst stycke i en lång text eller ska skapa rullningsbara textfält.
Enheten för lodrät rullning är rader, medan enheten för vågrät rullning är pixlar. Om den första visade raden är den första raden i textfältet ställs scrollV in på 1 (inte 0). Vågrät rullning mäts i pixlar, eftersom de flesta teckensnitten har proportionella mellanrum. Det innebär att tecknen kan ha olika bredd. Flash utför lodrät rullning efter rad, eftersom användare vanligtvis vill se en hel textrad i stället för en ofullständig rad. Även om det finns flera teckensnitt på en rad anpassas radens höjd för att passa det största teckensnittet som används.
Implementering
public function get scrollV():int
public function set scrollV(value:int):void
Relaterade API-element
selectable | egenskap |
selectable:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ett booleskt värde som anger om ett textfält är markeringsbart. Värdet true
anger att texten är markeringsbar. Egenskapen selectable
kontrollerar om ett textfält är markeringsbart, inte om det är redigeringsbart. Ett dynamiskt textfält kan vara markeringsbart även om det inte är redigeringsbart. Om ett dynamiskt textfält inte är markeringsbart går det inte att markera texten i det.
Om selectable
är inställt på false
svarar inte texten i textfältet på markeringskommandon från musen eller tangentbordet, och texten kan inte kopieras med hjälp av kommandot Kopiera. Om selectable
är inställt på true
kan texten i textfältet markeras med musen eller tangentbordet, och texten kan kopieras med hjälp av kommandot Kopiera. Du kan markera text på det här sättet även om textfältet är dynamiskt i stället för ett textinmatningsfält.
Standardvärdet är true.
Implementering
public function get selectable():Boolean
public function set selectable(value:Boolean):void
Relaterade API-element
Exempel ( Så här använder du exemplet )
selectable
inställd på true
och det andra textfältet har egenskapen selectable
inställd på false
. Försök att markera texten i textfälten när du använder det här exemplet.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class selectableExample extends Sprite { public function selectableExample() { var tf1:TextField = createCustomTextField(10, 10); tf1.text="This text can be selected"; tf1.selectable=true; var tf2:TextField = createCustomTextField(10, 30); tf2.text="This text cannot be selected"; tf2.selectable=false; } private function createCustomTextField(x:Number, y:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.autoSize=TextFieldAutoSize.LEFT; addChild(result); return result; } } }
selectionBeginIndex | egenskap |
selectionBeginIndex:int
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Det nollbaserade teckenindexvärdet för det första tecknet i den aktuella markeringen. Det första tecknet är 0, det andra 1 och så vidare. Om ingen text är markerad är värdet för den här egenskapen caretIndex
.
Implementering
public function get selectionBeginIndex():int
Relaterade API-element
Exempel ( Så här använder du exemplet )
printCursorPosition
anropas när användaren klickar på textfältet. I det här fallet visas värdena för egenskaperna caretIndex
, selectionBeginIndex
och selectionEndIndex
.
Kör det här exemplet och försök att klicka i textfältet för att markera text. Klicka sedan i fältet utan att markera text. Om du klickar i texten utan att göra någon markering visar egenskapen caretIndex
var inmatningspunkten är, och egenskaperna selectionBeginIndex
och selectionEndIndex
är lika med egenskapsvärdet caretIndex
.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_caretIndex extends Sprite { public function TextField_caretIndex() { var tf:TextField = createCustomTextField(10, 10, 100, 100); tf.wordWrap = true; tf.type = TextFieldType.INPUT; tf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text."; tf.addEventListener(MouseEvent.CLICK, printCursorPosition); } private function printCursorPosition(event:MouseEvent):void { var tf:TextField = TextField(event.target); trace("caretIndex:", tf.caretIndex); trace("selectionBeginIndex:", tf.selectionBeginIndex); trace("selectionEndIndex:", tf.selectionEndIndex); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
selectionEndIndex | egenskap |
selectionEndIndex:int
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Det nollbaserade teckenindexvärdet för det sista tecknet i den aktuella markeringen. Det första tecknet är 0, det andra 1 och så vidare. Om ingen text är markerad är värdet för den här egenskapen caretIndex
.
Implementering
public function get selectionEndIndex():int
Relaterade API-element
Exempel ( Så här använder du exemplet )
printCursorPosition
anropas när användaren klickar på textfältet. I det här fallet visas värdena för egenskaperna caretIndex
, selectionBeginIndex
och selectionEndIndex
.
Kör det här exemplet och försök att klicka i textfältet för att markera text. Klicka sedan i fältet utan att markera text. Om du klickar i texten utan att göra någon markering visar egenskapen caretIndex
var inmatningspunkten är, och egenskaperna selectionBeginIndex
och selectionEndIndex
är lika med egenskapsvärdet caretIndex
.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_caretIndex extends Sprite { public function TextField_caretIndex() { var tf:TextField = createCustomTextField(10, 10, 100, 100); tf.wordWrap = true; tf.type = TextFieldType.INPUT; tf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text."; tf.addEventListener(MouseEvent.CLICK, printCursorPosition); } private function printCursorPosition(event:MouseEvent):void { var tf:TextField = TextField(event.target); trace("caretIndex:", tf.caretIndex); trace("selectionBeginIndex:", tf.selectionBeginIndex); trace("selectionEndIndex:", tf.selectionEndIndex); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
sharpness | egenskap |
sharpness:Number
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Skärpan på specialtecknens kanter i det här textfältet. Den här egenskapen gäller bara om textfältets flash.text.AntiAliasType
-egenskap är inställd på flash.text.AntiAliasType.ADVANCED
. Intervallet för sharpness
är ett tal från -400 till 400. Om du försöker ställa in sharpness
på ett värde utanför det intervallet ställer Flash in egenskapen på det närmsta värdet som är i intervallet (antingen -400 eller 400).
Standardvärdet är 0.
Implementering
public function get sharpness():Number
public function set sharpness(value:Number):void
Relaterade API-element
Exempel ( Så här använder du exemplet )
sharpness
-egenskapen för ett TextField-objekt. Du måste bädda in teckensnittet och ställa in egenskapen antiAliasType
på ADVANCED
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.text.AntiAliasType; import flash.text.GridFitType; import flash.text.TextFormat; public class sharpnessExample extends Sprite { public function sharpnessExample() { var format1:TextFormat = new TextFormat(); format1.font="Arial"; format1.size=24; var lTxt:String = "The quick brown fox"; var tf1:TextField=createCustomTextField(0,lTxt,format1,-400); var tf2:TextField=createCustomTextField(30,lTxt,format1,0); var tf3:TextField=createCustomTextField(60,lTxt,format1,400); } private function createCustomTextField(y:Number,fldTxt:String,format:TextFormat,fldSharpness:Number):TextField { var result:TextField = new TextField(); result.y=y; result.text=fldTxt; result.embedFonts=true; result.autoSize=TextFieldAutoSize.LEFT; result.antiAliasType=AntiAliasType.ADVANCED; result.gridFitType=GridFitType.PIXEL; result.sharpness=fldSharpness; result..setTextFormat(format); addChild(result); return result; } } }
styleSheet | egenskap |
styleSheet:StyleSheet
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Kopplar en formatmall till textfältet. Information om att skapa formatmallar finns i klassen StyleSheet och Utvecklarhandbok för Adobe ActionScript 3.0.
Du kan när som helst byta ut den formatmall som är kopplad till ett textfält. Om formatmallen byts ut ritas textfältet om med den nya formatmallen. Du kan ställa in formatmallen på null
eller undefined
om du vill ta bort formatmallen. Om formatmallen som används tas bort ritas textfältet om utan formatmall.
Obs! Om formatmallen tas bort ändras innehållet i både TextField.text
och TextField.htmlText
till att omfatta den formatering som tidigare använts i formatmallen. Om du vill bevara det ursprungliga TextField.htmlText
-innehållet utan formateringen sparar du värdet i en variabel innan du tar bort formatmallen.
Implementering
public function get styleSheet():StyleSheet
public function set styleSheet(value:StyleSheet):void
Relaterade API-element
Exempel ( Så här använder du exemplet )
stylesheet
-egenskapen innan du ställer in innehållet.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.StyleSheet; public class TextStylesheetExample extends Sprite { var myLabel:TextField = new TextField(); var labelText:String = "Hello world."; var newStyle:StyleSheet = new StyleSheet(); public function TextStylesheetExample() { var styleObj:Object = new Object(); styleObj.fontWeight = "bold"; styleObj.color = "#660066"; newStyle.setStyle(".defStyle", styleObj); myLabel.styleSheet=newStyle; myLabel.htmlText=labelText; addChild(myLabel); } } }
text | egenskap |
text:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
En sträng som utgör den nuvarande texten i textfältet. Rader avgränsas med vagnreturtecknet ('\r'
, ASCII 13). Den här egenskapen innehåller oformaterad text i textfältet utan HTML-taggar.
Om du vill hämta texten i HTML-format använder du egenskapen htmlText
.
Obs! Om en formatmall används på textfältet tolkas innehållet i egenskapen text
som HTML.
Implementering
public function get text():String
public function set text(value:String):void
Relaterade API-element
Exempel ( Så här använder du exemplet )
tf1
, och en HTML-formaterad sträng kopplas till dess text
-egenskap. När egenskapen htmlText
identifieras, visas den HTML-formaterade strängen med ytterligare taggar (t.ex. <P> och <FONT>) som lagts till automatiskt av Flash Player. När egenskapsvärdet text
identifieras visas den oformaterade strängen utan HTML-taggar.
Samma steg utförs också på ett annat TextField-objekt med namnet tf2
, med det tillägget att ett StyleSheet-objekt kopplas till tf2
-objektets styleSheet
-egenskap innan dess htmlText
-egenskap anges. När htmlText
-egenskapen identifieras i detta fall, omfattas endast den exakta HTML-texten som ursprungligen kopplades till htmlText
-egenskapen, vilket visar att inga fler taggar har lagts till av Flash Player.
package { import flash.display.Sprite; import flash.text.StyleSheet; import flash.text.TextField; public class TextField_text extends Sprite { public function TextField_text() { var tf1:TextField = createCustomTextField(10, 10, 400, 22); tf1.htmlText = "<b>Lorem ipsum dolor sit amet.</b>"; // htmlText: <P ALIGN="LEFT"><FONT FACE="Times New Roman" SIZE="12" COLOR="#000000" LETTERSPACING="0" KERNING="0"><b>Lorem ipsum dolor sit amet.</b></FONT></P> trace("htmlText: " + tf1.htmlText); // text: Lorem ipsum dolor sit amet. trace("text: " + tf1.text); var tf2:TextField = createCustomTextField(10, 50, 400, 22); tf2.styleSheet = new StyleSheet(); tf2.htmlText = "<b>Lorem ipsum dolor sit amet.</b>"; // htmlText: <b>Lorem ipsum dolor sit amet.</b> trace("htmlText: " + tf2.htmlText); // text: Lorem ipsum dolor sit amet. trace("text: " + tf2.text); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
textColor | egenskap |
textColor:uint
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Färgen på texten i ett textfält, i hexadecimalt format. I det hexadecimala färgsystemet används sex siffror som representerar färgvärden. Varje siffra har 16 möjliga värden eller tecken. Teckenintervallet går från 0 till -9 och sedan från A till F. Svart är till exempel 0x000000
och vitt är 0xFFFFFF
.
Standardvärdet är 0 (0x000000).
Implementering
public function get textColor():uint
public function set textColor(value:uint):void
Exempel ( Så här använder du exemplet )
textColor
-egenskap till rött (0xFF0000
).
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_textColor extends Sprite { public function TextField_textColor() { var tf:TextField = createCustomTextField(10, 10, 100, 300); tf.text = "This will be red text"; tf.textColor = 0xFF0000; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
textHeight | egenskap |
textHeight:Number
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Textens höjd i pixlar.
Implementering
public function get textHeight():Number
Relaterade API-element
Exempel ( Så här använder du exemplet )
trace
visar värdet för egenskaperna textWidth
och textHeight
. Som jämförelse visas även egenskaperna width
och height
. (Tänk på att värdena du ser för textHeight
och textWidth
kan variera beroende på vilket teckensnitt som används på din dator.)
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_textHeight extends Sprite { public function TextField_textHeight() { var tf:TextField = createCustomTextField(10, 10, 100, 150); tf.text = "Sample text"; trace("textWidth: " + tf.textWidth); // textWidth: 55.75 trace("textHeight: " + tf.textHeight); // textHeight: 13.450000000000001 trace("width: " + tf.width); // width: 100 trace("height: " + tf.height); // height: 150 } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.border = true; result.background = true; addChild(result); return result; } } }
textInteractionMode | egenskap |
textInteractionMode:String
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 11, Flash Lite 4 |
Egenskapen för interaktionsläge. Standardvärdet är TextInteractionMode.NORMAL. På mobilplattformar innebär läget normal att användaren kan rulla i texten men inte markera den. Du kan växla till ett tillgängligt läge med hjälp av den inbyggda snabbmenyn i textfältet. På en stationär dator innebär läget normal att användaren både kan rulla i texten och markera den.
Implementering
public function get textInteractionMode():String
textWidth | egenskap |
textWidth:Number
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Textens bredd i pixlar.
Implementering
public function get textWidth():Number
Relaterade API-element
Exempel ( Så här använder du exemplet )
trace
visar värdet för egenskaperna textWidth
och textHeight
. Som jämförelse visas även egenskaperna width
och height
. (Tänk på att värdena du ser för textHeight
och textWidth
kan variera beroende på vilket teckensnitt som används på din dator.)
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_textHeight extends Sprite { public function TextField_textHeight() { var tf:TextField = createCustomTextField(10, 10, 100, 150); tf.text = "Sample text"; trace("textWidth: " + tf.textWidth); // textWidth: 55.75 trace("textHeight: " + tf.textHeight); // textHeight: 13.450000000000001 trace("width: " + tf.width); // width: 100 trace("height: " + tf.height); // height: 150 } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.border = true; result.background = true; addChild(result); return result; } } }
thickness | egenskap |
thickness:Number
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Tjockleken på specialtecknens kanter i det här textfältet. Den här egenskapen gäller bara när flash.text.AntiAliasType
är inställd på flash.text.AntiAliasType.ADVANCED
.
Intervallet för thickness
är ett tal från -200 till 200. Om du försöker ställa in thickness
på ett värde utanför det intervallet ställs egenskapen in på det närmsta värdet som är i intervallet (antingen -200 eller 200).
Standardvärdet är 0.
Implementering
public function get thickness():Number
public function set thickness(value:Number):void
Relaterade API-element
Exempel ( Så här använder du exemplet )
thickness
-egenskapen för ett TextField-objekt. Du måste bädda in teckensnittet och ställa in egenskapen antiAliasType
på ADVANCED
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.text.AntiAliasType; import flash.text.GridFitType; import flash.text.TextFormat; public class thicknessExample extends Sprite { public function thicknessExample() { var format1:TextFormat = new TextFormat(); format1.font="Arial"; format1.size=24; var lTxt:String = "The quick brown fox"; var tf1:TextField=createCustomTextField(0,lTxt,format1,-200); var tf2:TextField=createCustomTextField(30,lTxt,format1,0); var tf3:TextField=createCustomTextField(60,lTxt,format1,200); } private function createCustomTextField(y:Number,fldTxt:String,format:TextFormat,fldThickness:Number):TextField { var result:TextField = new TextField(); result.y=y; result.text=fldTxt; result.embedFonts=true; result.autoSize=TextFieldAutoSize.LEFT; result.antiAliasType=AntiAliasType.ADVANCED; result.gridFitType=GridFitType.PIXEL; result.thickness=fldThickness; result.setTextFormat(format); addChild(result); return result; } } }
type | egenskap |
type:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Textfältets typ. Någon av följande TextFieldType-konstanter: TextFieldType.DYNAMIC
som anger ett dynamiskt textfält som användaren inte kan redigera, eller TextFieldType.INPUT
som anger ett inmatningsfält som användaren kan redigera.
Standardvärdet är dynamic.
Implementering
public function get type():String
public function set type(value:String):void
Utlöser
ArgumentError — Det angivna type är inte medlem av flash.text.TextFieldType.
|
Relaterade API-element
Exempel ( Så här använder du exemplet )
tfDynamic
och tfInput
. Texten anges i båda textfälten. tfDynamic
har däremot type
-egenskapen inställd på TextFieldType.DYNAMIC
och tfInput
har type
-egenskapen inställd på TextFieldType.INPUT
, så användaren kan ändra texten i tfInput
men kan bara visa den i tfDynamic
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_type extends Sprite { public function TextField_type() { var tfDynamic:TextField = createCustomTextField(10, 10, 100, 20); tfDynamic.type = TextFieldType.DYNAMIC; tfDynamic.text = "hello"; var tfInput:TextField = createCustomTextField(10, 45, 100, 20); tfInput.type = TextFieldType.INPUT; tfInput.text = "world"; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.background = true; result.border = true; addChild(result); return result; } } }
useRichTextClipboard | egenskap |
useRichTextClipboard:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Anger om textformateringen ska kopieras och klistras in med texten. Om värdet är true
kopierar och klistrar Flash Player in formatering (t.ex. justering, fetstil och kursiv stil) när du kopierar och klistrar in mellan textfält. För både original- och måltextfältet måste useRichTextClipboard
vara inställt på true
. Standardvärdet är false
.
Implementering
public function get useRichTextClipboard():Boolean
public function set useRichTextClipboard(value:Boolean):void
Exempel ( Så här använder du exemplet )
tf1
) och två dynamiska textfält (tf2
och tf3
). Koden tilldelar varje enskilt dynamiskt textfält ett TextFormat-objekt (teckensnitt Courier Bold). Textfältet tf2
har egenskapen useRichTextClipboard
inställd på false
. Textfältet tf3
har egenskapen useRichTextClipboard
inställd på true
. När du kopierar texten från textfältet tf2
och klistrar in den i textfältet tf1
följer inte formateringen med den inklistrade texten. När du kopierar texten från textfältet tf3
(som har useRichTextClipboard
inställt på true
) och klistrar in den i textfältet tf1
ingår formateringen i den inklistrade texten.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; import flash.text.TextFormat; public class useRichTextClipboard extends Sprite { public function useRichTextClipboard() { var format1:TextFormat = new TextFormat(); format1.font="Courier"; format1.bold=true; var tf1:TextField = createCustomTextField(10, 10, 200, 20); tf1.type=TextFieldType.INPUT; tf1.useRichTextClipboard=true; var tf2:TextField = createCustomTextField(220, 10, 200, 20); tf2.text="1.Text loses format"; tf2.setTextFormat(format1); tf2.useRichTextClipboard=false; var tf3:TextField = createCustomTextField(220, 50, 200, 20); tf3.text="2.Text includes format"; tf3.setTextFormat(format1); tf3.useRichTextClipboard=true; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.background = true; result.border = true; addChild(result); return result; } } }
wordWrap | egenskap |
wordWrap:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ett booleskt värde som anger om textfältet har automatisk radbrytning. Om värdet för wordWrap
är true
innehåller textfältet automatisk radbrytning. Är värdet false
innehåller textfältet inte automatisk radbrytning. Standardvärdet är false
.
Implementering
public function get wordWrap():Boolean
public function set wordWrap(value:Boolean):void
Exempel ( Så här använder du exemplet )
wordWrap
på true
och på false
: Två TextFileld-instanser skapas vars innehåll är för stort för bredden. Den första instansens wordWrap
-egenskap (med namnet tfWrap
) ställs in på true
och den andra ställs in på false
(med namnet tfNoWrap
).
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_wordWrap extends Sprite { public function TextField_wordWrap() { var tfWrap:TextField = createCustomTextField(10, 10, 100, 100); tfWrap.wordWrap = true; tfWrap.text = "(wordWrap = true):\nThis is very long text that will certainly extend beyond the width of this text field"; var tfNoWrap:TextField = createCustomTextField(10, 150, 100, 100); tfNoWrap.wordWrap = false; tfNoWrap.text = "(wordWrap = false):\nThis is very long text that will certainly extend beyond the width of this text field"; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.background = true; result.border = true; addChild(result); return result; } } }
TextField | () | Konstruktor |
public function TextField()
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Skapar en ny TextField-instans. När du har skapat en TextField-instans anropar du metoden addChild()
eller addChildAt()
i det överordnade DisplayObjectContainer-objektet och lägger till TextField-instansen i visningslistan.
Standardstorleken för ett textfält är 100 x 100 pixlar.
Exempel ( Så här använder du exemplet )
var theTextField:TextField = new TextField(); theTextField.type = TextFieldType.INPUT; theTextField.border = true; theTextField.x = 10; theTextField.y = 10; theTextField.multiline = true; theTextField.wordWrap = true; addChild(theTextField);
appendText | () | metod |
public function appendText(newText:String):void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Lägger till strängen som angetts av parametern newText
på en del av eller all text i ett textfält. Den här metoden är effektivare än additionstilldelning (+=
) på en text
-egenskap (t.ex. someTextField.text += moreText
), särskilt för ett textfält med mycket innehåll.
Parametrar
newText:String — Den sträng som ska läggas till i den befintliga texten.
|
Exempel ( Så här använder du exemplet )
Textfältet outputText
ställs automatiskt in så att texten passas och vänsterjusteras med egenskapen autoSize
. Egenskapen outputText.text
skriver den första raden innehåll och metoden appendText()
lägger till resten av innehållet. (Det är inte nödvändigt att börja med egenskapen text
. Metoden appendText()
kan också användas för att lägga till text från början.) Om egenskapen text
ställs in en andra gång skrivs den ursprungliga texten över. Använd operatorn +=
om du vill lägga till innehåll med egenskapen text
.
if
-satsen kontrollerar om datumet är lördag (6) eller söndag (0). Om det inte är det returnerar metoden toLocaleTimeString()
lokal tid och lägger till den i textfältets innehåll.
Textfältets length
-egenskap används för att avläsa antalet tecken fram tills funktionen anropas. Egenskapen numLines
används för att räkna antalet rader i textfältet. Observera att tomma rader räknas till antalet rader och att blanksteg och radbrytningar (\n) räknas till innehållets längd.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_appendTextExample extends Sprite { public function TextField_appendTextExample() { var outputText:TextField = new TextField(); var today:Date = new Date(); outputText.x = 10; outputText.y = 10; outputText.background = true; outputText.autoSize = TextFieldAutoSize.LEFT; outputText.text = "WHAT TIME IS IT?" + "\n\n"; if((today.day == 0) || (today.day == 6)) { outputText.appendText("It's the weekend."); outputText.appendText("\n\n"); } else { outputText.appendText("The time is: "); outputText.appendText(today.toLocaleTimeString() + ".\n\n"); } outputText.appendText("Number of characters including line breaks and spaces so far: "); outputText.appendText(outputText.length.toString() + "\n"); outputText.appendText("Number of lines in the outputText: "); outputText.appendText(outputText.numLines.toString()); this.addChild(outputText); } } }
getCharBoundaries | () | metod |
public function getCharBoundaries(charIndex:int):Rectangle
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Returnerar en rektangel som utgör tecknets begränsningsram.
Parametrar
charIndex:int — Det nollbaserade indexvärdet för tecknet (den första positionen är 0, den andra är 1 och så vidare).
|
Rectangle — En rektangel med de lägsta och högsta x - ochy -värdena som definierar tecknets begränsningsram.
|
Relaterade API-element
Exempel ( Så här använder du exemplet )
getCharBoundaries()
för att markera (belysa) ett tecken som användaren väljer.
I klassen definieras Shape-objektet spotlight
som används för att rita en rektangel runt varje tecken som markeras. När användaren klickar på textfältet myTextField
anropas metoden clickHandler()
.
I metoden clickHandler()
får metoden getCharIndexAtPoint()
det klickade tecknets indexvärde baserat på koordinaterna localX
och localY
för musklicket, vilket är relativt Sprite
-behållarobjektet. Metoden getCharIndexAtPoint()
returnerar -1
om punkten (musklicket) inte var över något tecken. Eftersom textfältet kan vara större än texten kontrolleras det returnerade heltalet (index
) för att bekräfta att användaren har klickat på ett tecken. Heltalet index
används också av getCharBoundaries()
för att få ett Rectangle
-objekt som innehåller tecknets gräns. Metoden clear()
tar bort Shape-objektet spotlight
om det fanns ett som visades sedan tidigare. En ny rektangel med samma storlek som tecknets höjd- och breddgränser skapas på samma ställe som tecknet (försljuten från koordinaterna (10, 10)) med den returnerade frame
-rektangelns x- och y-koordinater. Tecknet lyses upp genom att Shape-objektet spotlight
fylls med gul färg och opaciteten inställd på 35 procent så att tecknet fortfarande syns. Observera att blanksteg också räknas som tecken.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.geom.Rectangle; import flash.events.MouseEvent; import flash.text.TextFieldAutoSize; import flash.display.Shape; public class TextField_getCharBoundariesExample extends Sprite { private var myTextField:TextField = new TextField(); private var spotlight:Shape = new Shape(); public function TextField_getCharBoundariesExample() { myTextField.x = 10; myTextField.y = 10; myTextField.border = true; myTextField.selectable = false; myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.text = "Selected a character from this text by clicking on it." myTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(myTextField); this.addChild(spotlight); } private function clickHandler (e:MouseEvent):void { var index:int = myTextField.getCharIndexAtPoint(e.localX, e.localY); if (index != -1) { var frame:Rectangle = myTextField.getCharBoundaries(index); spotlight.graphics.clear(); spotlight.graphics.beginFill(0xFFFF00, .35); spotlight.graphics.drawRect((frame.x + 10), (frame.y + 10), frame.width, frame.height); spotlight.graphics.endFill(); } } } }
getCharIndexAtPoint | () | metod |
public function getCharIndexAtPoint(x:Number, y:Number):int
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Returnerar det nollbaserade indexvärdet för tecknet vid den punkt som anges av parametrarna x
och y
.
Parametrar
x:Number — Tecknets x-koordinat.
| |
y:Number — Tecknets y-koordinat.
|
int — Det nollbaserade indexvärdet för tecknet (den första positionen är 0, den andra är 1 och så vidare). Returnerar -1 om punkten inte ligger över ett tecken.
|
Exempel ( Så här använder du exemplet )
I det första textfältet finns texten användaren ska välja. För att texten ska klickas men inte markeras ställs egenskapen selectable
in på false. När användaren klickar på textfältet firstTextField
anropas metoden clickHandler()
.
I metoden clickHandler()
returnerar metoden getCharIndexAtPoint()
tecknets indexvärde baserat på koordinaterna localX
och localY
för musklicket. Eftersom textfältet kan vara större än texten kontrolleras det returnerade heltalet (index
) för att bekräfta att användaren har klickat på ett tecken. (Metoden getCharIndexAtPoint()
returnerar -1
om punkten (musklicket) inte var över något tecken.) Muskoordinaterna används för att ställa in koordinaterna för det nya textfältet där det kopierade tecknet ska placeras. Färgen för tecknet i det andra textfältet ställs in på röd. Slutligen ställs texten i det andra textfältet in på det valda tecknet, som hämtas med metoden charAt()
. Observera att om egenskapen text
används i stället för metoden appendText()
, ersätts tecknet i det andra textfältet i stället för att det nya tecknet läggs till.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.geom.Rectangle; import flash.events.MouseEvent; import flash.text.TextFieldAutoSize; public class TextField_getCharIndexAtPointExample extends Sprite { private var firstTextField:TextField = new TextField(); private var secondTextField:TextField = new TextField(); public function TextField_getCharIndexAtPointExample() { firstTextField.x = 100; firstTextField.y = 100; firstTextField.width = 260; firstTextField.height = 20; firstTextField.border = true; firstTextField.background = true; firstTextField.selectable = false; firstTextField.text = "Selected a character from this text by clicking on it." firstTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(firstTextField); this.addChild(secondTextField); } private function clickHandler (e:MouseEvent):void { var index:int = firstTextField.getCharIndexAtPoint(e.localX, e.localY); if (index != -1) { secondTextField.x = mouseX; secondTextField.y = 70; secondTextField.border = true; secondTextField.selectable = false; secondTextField.background = true; secondTextField.textColor = 0xFF0000; secondTextField.autoSize = TextFieldAutoSize.LEFT; secondTextField.text = firstTextField.text.charAt(index); } } } }
getFirstCharInParagraph | () | metod |
public function getFirstCharInParagraph(charIndex:int):int
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Returnerar ett givet teckenindexvärde för det första tecknet i samma stycke.
Parametrar
charIndex:int — Det nollbaserade indexvärdet för tecknet (det första tecknet är 0, det andra är 1 och så vidare).
|
int — Det nollbaserade indexvärdet för det första tecknet i samma stycke.
|
Utlöser
RangeError — Det angivna teckenindexvärdet är utanför intervallet.
|
Exempel ( Så här använder du exemplet )
I konstruktorn ställs textfältet myTextField
in på radbrytning. Metoden getTextFormat
returnerar det ursprungliga formatet för det första tecknet i textfältet. Formatet placeras i TextFormat-objektet originalFormat
. Ett nytt TextFormat-objekt (newFormat
) definieras också och dess align
-egenskap ställs in på högerjustering. När användaren klickar på textfältet anropas metoden clickHandler()
.
I metoden clickHandler()
returnerar metoden getCharIndexAtPoint()
tecknets indexvärde baserat på koordinaterna localX
och localY
för musklicket. Den första if
-satsen kontrollerar om användaren har klickat på något tecken. Med hjälp av heltalet clickIndex
, som returnerades av metodengetCharIndexAtPoint()
, returnerar metoden getFirstCharInParagraph()
indexvärdet för det första tecknet i stycket som användaren klickade på. Indexvärdet för det sista tecknet i stycket avgörs genom att styckets längd (fås med metoden getParagraphLength()
) läggs till indexvärdet för det första tecknet i stycket minus det sista tecknet (\n
). Den andra if
-satsen kontrollerar formatet för det första tecknet i stycket. Om dess justeringsvärde är samma som det ursprungliga formatet (vänsterjustering) tillämpas det nya formatet på alla tecken i stycket. Annars återställs styckets format till det ursprungliga formatet. Justering samt formatering som indrag, punkter, tabbstopp och vänster och höger marginal är format som är avsedda för stycken. Observera att när automatisk radbrytning eller radbrytning används, gäller bara formateringen för styckets första rad om argumentet endIndex
inte är definierat för metoden setTextFormat()
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; import flash.text.TextFormat; import flash.text.TextFormatAlign; public class TextField_getFirstCharInParagraphExample extends Sprite { private var myTextField:TextField = new TextField(); private var originalFormat:TextFormat = new TextFormat(); private var newFormat:TextFormat = new TextFormat(); public function TextField_getFirstCharInParagraphExample() { myTextField.x = 10; myTextField.y = 10; myTextField.border = true; myTextField.wordWrap = true; myTextField.width = 300; myTextField.height = 300; myTextField.background = true; myTextField.appendText("The TextField class is used to create display objects for " + "text display and input. All dynamic and input text fields in a SWF file " + "are instances of the TextField class. You can use the TextField class " + "to perform low-level text rendering. However, in Flex, you typically use " + "the Label, Text, TextArea, and TextInput controls to process text. " + "You can give a text field an instance name in the Property inspector " + "and use the methods and properties of the TextField class to manipulate it with ActionScript. " + "TextField instance names are displayed in the Movie Explorer and in the Insert " + "Target Path dialog box in the Actions panel.\n\n" + "To create a text field dynamically, use the TextField constructor.\n\n" + "The methods of the TextField class let you set, select, and manipulate " + "text in a dynamic or input text field that you create during authoring or at runtime.\n\n"); originalFormat = myTextField.getTextFormat(0); newFormat.align = TextFormatAlign.RIGHT; myTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(myTextField); } private function clickHandler(e:MouseEvent):void { var clickIndex:int = myTextField.getCharIndexAtPoint(e.localX, e.localY); if(clickIndex != -1) { var paragraphFirstIndex:int = myTextField.getFirstCharInParagraph(clickIndex); var paragraphEndIndex:int = paragraphFirstIndex + ((myTextField.getParagraphLength(clickIndex) - 1)); if (myTextField.getTextFormat(paragraphFirstIndex).align == originalFormat.align) { myTextField.setTextFormat(newFormat, paragraphFirstIndex, paragraphEndIndex); }else { myTextField.setTextFormat(originalFormat, paragraphFirstIndex, paragraphEndIndex); } } } } }
getImageReference | () | metod |
public function getImageReference(id:String):DisplayObject
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Returnerar en DisplayObject-referens för givet id
för en bild eller SWF-fil som har lagts till i ett HTML-formaterat textfält med en <img>
-tagg. Taggen <img>
har följande format:
<img src = 'filename.jpg' id = 'instanceName' >
Parametrar
id:String — Det id som ska matcha (i id -attributet för <img> -taggen).
|
DisplayObject — Visningsobjektet som motsvarar bilden eller SWF-filen med det matchande id -attributet i <img> -taggen i textfältet. För medier som lästs in från en extern källa är det här objektet ett Loader-objekt. När medieobjektet har lästs in underordnas det detta Loader-objekt. För medier som är inbäddade i SWF-filen är detta det inlästa objektet. Om det inte finns någon <img> -tagg med matchande id returnerar metoden null .
|
Relaterade API-element
Exempel ( Så här använder du exemplet )
Bilden (image.jpg
) inkluderas via HTML. (Här antas bildfilen finnas i samma katalog som SWF-filen.) Ett id
-attribut måste definieras för img
-taggen för att bilden ska bli åtkomlig för metoden getImageReference()
. Egenskapen htmlText
används för att inkludera HTML-formaterat stränginnehåll. När användaren klickar på textfältet myTextField
anropas metoden clickHandler()
.
I metoden clickHandler()
returnerar metoden getImageReference()
en referens till bilden som ett DisplayObject
. Referensen kan användas för att manipulera bilden, precis som alla DisplayObject
-objekt. Här ställs värdena alpha
(genomskinlighet) och rotation
in. Egenskapen transform
kan också användas för att hantera visningsobjektets matris, färgomformning och pixelgränser. Observera också att flash.display.DisplayObject
måste importeras.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.Event; import flash.events.MouseEvent; import flash.display.DisplayObject; import flash.text.TextFieldAutoSize; public class TextField_getImageReferenceExample extends Sprite { private var myTextField:TextField = new TextField(); public function TextField_getImageReferenceExample() { var myText1:String = "<p>Here is an image we want to mainpulate: <img src='image.jpg' id='testimage'></p>"; myTextField.x = 10; myTextField.y = 10; myTextField.width = 250; myTextField.height = 250; myTextField.background = true; myTextField.border = true; myTextField.border = true; myTextField.multiline = true; myTextField.htmlText = myText1; myTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(myTextField); } private function clickHandler(e:MouseEvent):void { var imageRef:DisplayObject = myTextField.getImageReference("testimage"); imageRef.rotation += 90; imageRef.x = 125; imageRef.y = 125; imageRef.alpha = 0.25; } } }
getLineIndexAtPoint | () | metod |
public function getLineIndexAtPoint(x:Number, y:Number):int
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Returnerar det nollbaserade indexvärdet för raden vid den punkt som anges av parametrarna x
och y
.
Parametrar
x:Number — Radens x-koordinat.
| |
y:Number — Radens y-koordinat.
|
int — Det nollbaserade indexvärdet för raden (den första raden är 0, den andra är 1 och så vidare). Returnerar -1 om punkten inte ligger över någon rad.
|
Exempel ( Så här använder du exemplet )
I konstruktorn ställs textfältet poem
in på att inte byta rad automatiskt (eftersom det är poesi). Egenskapen autoSize
används också för att ställa in texten så att den passas och skalas automatiskt som vänsterjusterad text. Textfältet poemCopy
placeras under textfältet poem
. När användaren klickar på en rad i dikten anropas metoden clickHandler()
.
I metoden clickHandler()
returnerar metoden getLineIndexAtPoint()
indexvärdet för raden användaren klickat på baserat på koordinaterna localX
och localY
för musklicket. (Eftersom den ursprungliga dikten passar i textfältet här är det inte nödvändigt att kontrollera om ett utanför intervallet-fel (RangeError
) genereras av metoden getCharIndexAtPoint()
.) Radens indexvärde används sedan för att hämta innehållet på raden som en sträng med metoden getLineText()
. Raden läggs sedan till i textfältet poemCopy
. Kopieringen kan göras flera gånger, men så småningom kommer texten att hamna utanför den del av textfältet poemCopy
som kan visas.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; import flash.text.TextFormat; import flash.text.TextFieldAutoSize; public class TextField_getLineIndexAtPointExample extends Sprite { private var poem:TextField = new TextField(); private var poemCopy:TextField = new TextField(); public function TextField_getLineIndexAtPointExample() { poem.border = true; poem.autoSize = TextFieldAutoSize.LEFT; poem.x = 10; poem.wordWrap = false; poemCopy.height = 250; poemCopy.width = 270; poemCopy.y = 230; poemCopy.x = 10; poemCopy.background = true; poemCopy.border = true; poemCopy.wordWrap = false; poem.appendText("Let me not to the marriage of true minds\n" + "Admit impediments. love is not love\n" + "Which alters when it alteration finds\n" + "Or bends with the remover to remove:\n" + "O no! it is an ever-fixed mark\n" + "That looks on tempests and is never shaken;\n" + "It is the star to every wandering bark,\n" + "Whose worth's unknown, although his height be taken.\n" + "Love's not Time's fool, though rosy lips and cheeks\n" + "Within his bending sickle's compass come:\n" + "Love alters not with his brief hours and weeks,\n" + "But bears it out even to the edge of doom.\n" + "If this be error and upon me proved,\n" + "I never writ, nor no man ever loved."); poem.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(poem); this.addChild(poemCopy); } private function clickHandler(e:MouseEvent):void { var index:int = poem.getLineIndexAtPoint(e.localX, e.localY); var s:String; s = poem.getLineText(index); poemCopy.appendText(s + "\n"); } } }
getLineIndexOfChar | () | metod |
public function getLineIndexOfChar(charIndex:int):int
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Returnerar det nollbaserade indexvärdet för raden som innehåller tecknet som anges av parametern charIndex
.
Parametrar
charIndex:int — Det nollbaserade indexvärdet för tecknet (det första tecknet är 0, det andra är 1 och så vidare).
|
int — Det nollbaserade indexvärdet för raden.
|
Utlöser
RangeError — Det angivna teckenindexvärdet är utanför intervallet.
|
Exempel ( Så här använder du exemplet )
getLineIndexOfChar()
radnumren för de 100:e och 500:e tecknen i textfältet.
Textfältet myTextField
ställs in på automatisk radbrytning och skalning som vänsterjusterad text. Metoden getLineIndexOfChar()
returnerar radindexvärdena för de angivna teckenindexvärdena (100 och 500). Informationen läggs sedan till efter stycket. Obs! Eftersom radindex börjar med 0 ska radindex (index
) ökas med 1 för att ge radnumret. Om visningsstorleken ändras kan radnumret också ändras, men informationen här ändras inte eftersom metoden bara anropas en gång.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_getLineIndexOfCharExample extends Sprite { public function TextField_getLineIndexOfCharExample() { var myTextField:TextField = new TextField(); myTextField.x = 10; myTextField.y = 10; myTextField.width = 200; myTextField.background = true; myTextField.border = true; myTextField.wordWrap = true; myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.appendText("The TextField class is used to create display objects for " + "text display and input. All dynamic and input text fields in a SWF file" + "are instances of the TextField class. You can use the TextField class " + "to perform low-level text rendering. However, in Flex, you typically use " + "the Label, Text, TextArea, and TextInput controls to process text. " + "You can give a text field an instance name in the Property inspector " + "and use the methods and properties of the TextField class to manipulate it with ActionScript. " + "TextField instance names are displayed in the Movie Explorer and in the Insert " + "Target Path dialog box in the Actions panel.\n\n"); var index:int = myTextField.getLineIndexOfChar(100); myTextField.appendText("100th character is in line: " + (index + 1) + "\n"); index = myTextField.getLineIndexOfChar(500); myTextField.appendText("500th character is in line: " + (index + 1)); this.addChild(myTextField); } } }
getLineLength | () | metod |
public function getLineLength(lineIndex:int):int
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Returnerar antalet tecken på en viss textrad.
Parametrar
lineIndex:int — Radnumret som du vill ha längden för.
|
int — Antalet tecken på raden.
|
Utlöser
RangeError — Det angivna radnumret är utanför intervallet.
|
Exempel ( Så här använder du exemplet )
För att illustrera detta ställs textfältet myTextField
, som visar den text som ska räknas, in på INPUT
så att användaren faktiskt kan ändra raderna eller lägga till rader mellan befintliga rader eller i slutet. (En tom rad skapas av radbrytning (\n
) i slutet av sista raden.) Textfältet countLines
, där resultatet av radlängdsräkningen visas, placeras nedanför textfältet myTextField
och dess text kan inte markeras. När användaren klickar på en rad i textfältet myTextField
anropas metoden clickHandler()
.
I metoden clickHandler()
returnerar metoden getLineIndexAtPoint()
indexvärdet för raden användaren klickat på med koordinaterna localX
och localY
för musklicket. if
-satsen kontrollerar om användaren har klickat på något tecken. I så fall returnerar metoden getLineLength()
antalet tecken på raden med hjälp av radens indexvärde. Observera att tomma rader mellan raderna inkluderar den andra radbrytningen (\n
) och har teckenantalet 1. Raden efter den sista raden har däremot teckenantalet 0. Blanksteg räknas också som tecken. Användaren kan skriva en ny rad eller ändra en rad och visa teckenantalet för raden genom att klicka på den. Om automatisk radbrytning används och skärmens storlek ändras kan radindexvärdena ändras.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; import flash.events.Event; import flash.events.MouseEvent; public class TextField_getLineLengthExample extends Sprite { private var myTextField:TextField = new TextField(); private var countLines:TextField = new TextField(); public function TextField_getLineLengthExample() { myTextField.x = 10; myTextField.y = 10; myTextField.width = 350; myTextField.height = 150; myTextField.background = true; myTextField.border = true; myTextField.type = TextFieldType.INPUT; myTextField.appendText("Click on the lines to count its number of characters:\n\n"); myTextField.appendText("This is a short line.\n"); myTextField.appendText("This is a longer line than the last line.\n\n"); myTextField.appendText("This one is even longer than the one before. It has two sentences.\n"); this.addChild(myTextField); countLines.border = true; countLines.x = 10; countLines.y = 180; countLines.height = 30; countLines.width = 200; countLines.background = true; countLines.selectable = false; this.addChild(countLines); myTextField.addEventListener(MouseEvent.CLICK, clickHandler); } private function clickHandler(e:MouseEvent):void { var index:int = myTextField.getLineIndexAtPoint(e.localX, e.localY); if (index != -1) { var lenght:int = myTextField.getLineLength(index); countLines.text = "Number of characters in the line is: " + lenght.toString(); } } } }
getLineMetrics | () | metod |
public function getLineMetrics(lineIndex:int):flash.text:TextLineMetrics
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Returnerar måttinformation om en viss textram.
Parametrar
lineIndex:int — Radnumret som du vill ha måttinformation om.
|
flash.text:TextLineMetrics — Ett TextLineMetrics-objekt.
|
Utlöser
RangeError — Det angivna radnumret är utanför intervallet.
|
Relaterade API-element
Exempel ( Så här använder du exemplet )
Texten är två rader från Song of Myself av Walt Whitman. Ett nytt TextFormat-objekt (newFormat
) används för att formatera den andra raden. Den första raden har standardformat. Metoden getLineMetrics()
returnerar ett TextLineMetrics
-objekt för en specifik rad. (Radindex är nollbaserade.) Med hjälp av TextLineMetrics-objekten metrics1
och metrics2
för rad ett och två hämtas och visas värden för ascent, descent, height och weight för varje rad. Resultaten konverteras till strängformat men avrundas inte. Observera att värdet är för raden och inte för specifika tecken. Det återspeglar teckenomfånget för en rad. Om en rad till exempel har olika tecken med olika höjdformat avgör det högsta tecknet värdet. Det innebär också att om något teckens format ändras kan några av mätvärdena också ändras.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextLineMetrics; import flash.text.TextFieldAutoSize; import flash.text.AntiAliasType; import flash.text.TextFormat; public class TextField_getLineMetricsExample extends Sprite { public function TextField_getLineMetricsExample() { var myTextField:TextField = new TextField(); var newFormat:TextFormat = new TextFormat(); myTextField.x = 10; myTextField.y = 10; myTextField.background = true; myTextField.wordWrap = false; myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.appendText("A child said What is the grass? fetching it to me with full hands;\n"); myTextField.appendText("How could I answer the child? I do not know what it is any more than he.\n\n"); newFormat.size = 14; newFormat.font = "Arial"; newFormat.italic = true; myTextField.setTextFormat(newFormat, 67, 139); var metrics1:TextLineMetrics = myTextField.getLineMetrics(0); myTextField.appendText("Metrics ascent for the line 1 is: " + metrics1.ascent.toString() + "\n"); myTextField.appendText("Metrics descent is: " + metrics1.descent.toString() + "\n"); myTextField.appendText("Metrics height is: " + metrics1.height.toString() + "\n"); myTextField.appendText("Metrics width is: " + metrics1.width.toString() + "\n\n"); var metrics2:TextLineMetrics = myTextField.getLineMetrics(1); myTextField.appendText("Metrics ascent for the line 2 is: " + metrics2.ascent.toString() + "\n"); myTextField.appendText("Metrics descent is: " + metrics2.descent.toString() + "\n"); myTextField.appendText("Metrics height is: " + metrics2.height.toString() + "\n"); myTextField.appendText("Metrics width is: " + metrics2.width.toString() + "\n"); addChild(myTextField); } } }
getLineOffset | () | metod |
public function getLineOffset(lineIndex:int):int
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Returnerar teckenindexvärdet för det första tecknet på raden som anges av parametern lineIndex
.
Parametrar
lineIndex:int — Det nollbaserade indexvärdet för raden (den första raden är 0, den andra är 1 och så vidare).
|
int — Det nollbaserade indexvärdet för det första tecknet på raden.
|
Utlöser
RangeError — Det angivna radnumret är utanför intervallet.
|
Exempel ( Så här använder du exemplet )
Textfältet myTextField
ställs in på automatisk radbrytning. I textfältet countField
visas det första tecknet på rad 4. När användaren klickar på textfältet myTextField
anropas metoden clickHandler()
.
I metoden clickHandler()
returnerar metoden getLineOffset()
indexvärdet för det första tecknet med radindex 3, det vill säga den fjärde textraden. (Den första raden har indexvärdet 0.) Metoden charAt()
används för att hämta tecknet med hjälp av indexvärdet för det första tecknet på fjärde raden. Innehållet i textfältet countField
uppdateras med informationen med hjälp av egenskapen text
i textfältet countField
. Att egenskapen countField.text
används innebär att innehållet i textfältet countField
skrivs över efter varje klick. Om användaren ändrar visningsstorleken görs radbrytningar automatiskt och vilket tecken som är det första på rad 4 kan ändras. När användaren klickar på fältet myTextField
igen uppdateras innehållet i textfältet countField
med det nya första tecknet på fjärde raden.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; public class TextField_getLineOffsetExample extends Sprite { private var myTextField:TextField = new TextField(); private var countField:TextField = new TextField(); public function TextField_getLineOffsetExample() { myTextField.x = 10; myTextField.y = 10; myTextField.width = 150; myTextField.height = 300; myTextField.background = true; myTextField.border = true; myTextField.wordWrap = true; countField.height = 20; countField.width = 200; countField.x = 10; countField.y = 320; countField.selectable = false; myTextField.appendText("The TextField class is used to create display objects for " + "text display and input. All dynamic and input text fields in a SWF file " + "are instances of the TextField class. You can use the TextField class " + "to perform low-level text rendering. However, in Flex, you typically use " + "the Label, Text, TextArea, and TextInput controls to process text. " + "You can give a text field an instance name in the Property inspector " + "and use the methods and properties of the TextField class to manipulate it with ActionScript."); myTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(myTextField); this.addChild(countField); } private function clickHandler(e:MouseEvent):void { var c:String; var index:int; index = myTextField.getLineOffset(3); c = myTextField.text.charAt(index); countField.text = "The first character of line 4 is: " + c; } } }
getLineText | () | metod |
public function getLineText(lineIndex:int):String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Returnerar texten på raden som anges av parametern lineIndex
.
Parametrar
lineIndex:int — Det nollbaserade indexvärdet för raden (den första raden är 0, den andra är 1 och så vidare).
|
String — Textsträngen i den angivna raden.
|
Utlöser
RangeError — Det angivna radnumret är utanför intervallet.
|
Exempel ( Så här använder du exemplet )
Textfältet poem
ställs automatiskt in så att texten passas och vänsterjusteras. Egenskapen wordWrap
ställs in på false
så att diktens rader inte bryts. I vanliga fall är detta emellertid inget problem när egenskapen autoSize
används. for
-slingan itererar genom raderna i sonetten med textfältetsnumLines
-egenskap. Metoden getLineText()
returnerar radens innehåll som en sträng. (Observera att egenskapen numLines
returnerar antalet rader från och med rad 1 medan radnumret börjar med 0 i metoden getLineText()
.) Med hjälp av mönstret för reguljära uttryck (/love/i
) identifierar if
-satsen alla delsträngar av ordet med stora eller små bokstäver. Om mönstret påträffas returnerar metoden search
indexvärdet för den första matchande delsträngen. Annars returneras -1
(om det inte finns någon matchning). Radnumret där "love" hittades ((i + 1)
) placeras sedan i strängen lineResult
. Strängmetoden konverterar sedan talargumentet ((i + 1)
) till en sträng, förutsatt att det finns ett annat argument som är en sträng (" "). Radresultatet för sökningen inkluderar rader med orden "loved" eller "Love's". Om strängen "Love was found in lines:" hade lagts till före for
-slingan skulle ordet "Love" på den här raden också ha inkluderats.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.utils.Timer; import flash.events.TimerEvent; public class TextField_getLineTextExample extends Sprite { public function TextField_getLineTextExample() { var poem:TextField = new TextField(); var lineResult:String = ""; var pattern:RegExp = /love/i; poem.x = 10; poem.y = 10; poem.background = true; poem.wordWrap = false; poem.autoSize = TextFieldAutoSize.LEFT; poem.text = "Let me not to the marriage of true minds\n" + "Admit impediments. love is not love\n" + "Which alters when it alteration finds\n" + "Or bends with the remover to remove:\n" + "O no! it is an ever-fixed mark\n" + "That looks on tempests and is never shaken;\n" + "It is the star to every wandering bark,\n" + "Whose worth's unknown, although his height be taken.\n" + "Love's not Time's fool, though rosy lips and cheeks\n" + "Within his bending sickle's compass come:\n" + "Love alters not with his brief hours and weeks,\n" + "But bears it out even to the edge of doom.\n" + "If this be error and upon me proved,\n" + "I never writ, nor no man ever loved.\n\n"; for (var i:int = 0; i < poem.numLines; i++) { var s:String = poem.getLineText(i); if(s.search(pattern) != -1) { lineResult += (i + 1) + " "; } } poem.appendText("Love was found in lines: " + lineResult); this.addChild(poem); } } }
getParagraphLength | () | metod |
public function getParagraphLength(charIndex:int):int
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Returnerar längden på det stycke som innehåller ett givet teckenindexvärde. Längden anges i förhållande till det första tecknet i stycket (som returneras av getFirstCharInParagraph()
), inte i förhållande till det teckenindexvärde som skickats.
Parametrar
charIndex:int — Det nollbaserade indexvärdet för tecknet (det första tecknet är 0, det andra är 1 och så vidare).
|
int — Returnerar antalet tecken i stycket.
|
Utlöser
RangeError — Det angivna teckenindexvärdet är utanför intervallet.
|
Relaterade API-element
Exempel ( Så här använder du exemplet )
I textfältet myTextField
visas styckena som användaren markerar. När användaren klickar på textfältet skickas händelsen MouseEvent.CLICK
och metoden clickHandler()
anropas. Styckets längd och antalet "s" visas i textfältet countField
, som placeras nedanför textfältet myTextField
.
I metoden clickHandler()
returnerar metoden getCharIndexAtPoint()
tecknets indexvärde baserat på koordinaterna localX
och localY
för musklicket. Den första if
-satsen kontrollerar om användaren har klickat på något tecken. Metoden getFirstCharInParagraph()
använder indexvärdet för att returnera indexvärdet för det första tecknet i samma stycke. Styckets längd returneras av metoden getParagraphLength()
och används tillsammans med indexvärdet för det första tecknet i stycket för att avgöra indexvärdet för styckets slut. En for
-slinga itererar genom stycket och räknar alla "s".
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; public class TextField_getParagraphLengthExample extends Sprite { private var myTextField:TextField = new TextField(); private var countField:TextField = new TextField(); public function TextField_getParagraphLengthExample() { myTextField.x = 10; myTextField.y = 10; myTextField.background = true; myTextField.border = true; myTextField.wordWrap = true; myTextField.width = 300; myTextField.height = 280; myTextField.appendText("The TextField class is used to create display objects for " + "text display and input. All dynamic and input text fields in a SWF file" + "are instances of the TextField class. You can use the TextField class " + "to perform low-level text rendering. However, in Flex, you typically use " + "the Label, Text, TextArea, and TextInput controls to process text. " + "You can give a text field an instance name in the Property inspector " + "and use the methods and properties of the TextField class to manipulate it with ActionScript. " + "TextField instance names are displayed in the Movie Explorer and in the Insert " + "Target Path dialog box in the Actions panel.\n\n" + "To create a text field dynamically, use the TextField() constructor.\n\n" + "The methods of the TextField class let you set, select, and manipulate " + "text in a dynamic or input text field that you create during authoring or at runtime."); myTextField.addEventListener(MouseEvent.CLICK, clickHandler); countField.x = 10; countField.y = 300; countField.height = 50; countField.width = 250; countField.background = true; countField.selectable = false; this.addChild(myTextField); this.addChild(countField); } private function clickHandler(e:MouseEvent):void { var index:int = myTextField.getCharIndexAtPoint(e.localX, e.localY); if(index != -1) { var beginParag:int = myTextField.getFirstCharInParagraph(index); var paragLength:int = myTextField.getParagraphLength(index); var endParag:int = beginParag + paragLength; var sCount:uint = 0; for (var i:int = beginParag; i <= endParag; i++) { if ((myTextField.text.charAt(i) == "s") || (myTextField.text.charAt(i) == "S")) { sCount++; } countField.text = "Paragraph length is: " + paragLength.toString() + "\n" + "Number of 's' characters in the paragraph: " + sCount.toString(); } } } } }
getTextFormat | () | metod |
public function getTextFormat(beginIndex:int = -1, endIndex:int = -1):flash.text:TextFormat
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Returnerar ett TextFormat-objekt som innehåller formateringsinformation för textintervallet som anges av parametrarna beginIndex
och endIndex
. Endast egenskaper som är gemensamma för hela den angivna texten ställs in i det resulterande TextFormat-objektet. Alla egenskaper som är mixed, vilket innebär att de har olika värden på olika ställen i texten, har värdet null
.
Om du inte anger värden för de här parametrarna används metoden på hela texten i textfältet.
I följande tabell beskrivs tre möjliga användningar:
Användning | Beskrivning |
---|---|
my_textField.getTextFormat() | Returnerar ett TextFormat-objekt som innehåller formateringsinformation för all text i ett textfält. Endast egenskaper som är gemensamma för all text i textfältet ställs in i det resulterande TextFormat-objektet. Alla egenskaper som är mixed, vilket innebär att de har olika värden på olika ställen i texten, har värdet null . |
my_textField.getTextFormat(beginIndex:Number) | Returnerar ett TextFormat-objekt som innehåller en kopia av tecknets textformat på positionen beginIndex . |
my_textField.getTextFormat(beginIndex:Number,endIndex:Number) | Returnerar ett TextFormat-objekt som innehåller formateringsinformation för hela textens omfång från beginIndex till endIndex-1 . Endast egenskaper som är gemensamma för all text i det angivna omfånget ställs in i det resulterande TextFormat-objektet. Alla egenskaper som är blandade (har olika värden på olika ställen i omfånget) får värdet null . |
Parametrar
beginIndex:int (default = -1 ) — Valfritt: ett heltal som anger startpositionen för ett textintervall i textfältet.
| |
endIndex:int (default = -1 ) — Valfritt. Ett heltal som anger positionen för det första tecknet efter det önskade textomfånget. Om du anger värden för beginIndex och endIndex läses texten från beginIndex till endIndex-1 .
|
flash.text:TextFormat — Det TextFormat-objekt som representerar den angivna textens formateringsegenskaper.
|
Utlöser
RangeError — beginIndex eller endIndex är utanför intervallet.
|
Relaterade API-element
Exempel
Så här använder du exemplet
Hur metoden getTextFormat() används visas i exemplen för metoderna getFirstCharInParagraph() och
setTextFormat()
.
isFontCompatible | () | metod |
public static function isFontCompatible(fontName:String, fontStyle:String):Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Returnerar true om ett inbäddat teckensnitt är tillgängligt med angivet fontName
och fontStyle
, där Font.fontType
är flash.text.FontType.EMBEDDED
. Flash Player 10 har två olika inbäddade teckensnitt som kan visas i en SWF-fil. Normalt inbäddade teckensnitt används endast med TextField-objekt. CFF-inbäddade teckensnitt används endast med klasserna flash.text.engine. De två typerna skiljer sig åt genom fontType
-egenskapen för klassen Font
, som returneras av funktionen enumerateFonts()
.
TextField kan inte använda ett teckensnitt av typen EMBEDDED_CFF
. Om embedFonts
är inställt på true
, och det enda teckensnitt som är tillgängligt vid körning med det namn och format som anges är av typen EMBEDDED_CFF
, kan Flash Player inte återge texten (som om det inte fanns något inbäddat teckensnitt med det angivna namnet och formatet).
Om både EMBEDDED
- och EMBEDDED_CFF
-teckensnitten finns tillgängliga med samma namn och stil, kommer EMBEDDED
-teckensnittet att väljas och texten kommer att renderas med teckensnittet EMBEDDED
.
Parametrar
fontName:String — Namnet på det inbäddade teckensnittet ska undersökas.
| |
fontStyle:String — Specificerar det teckensnitt som ska undersökas. Använd flash.text.FontStyle
|
Boolean — true om ett kompatibelt inbäddat teckensnitt är tillgängligt, i annat fall false .
|
Utlöser
ArgumentError — Angivet fontStyle är inte medlem av flash.text.FontStyle .
|
Relaterade API-element
replaceSelectedText | () | metod |
public function replaceSelectedText(value:String):void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ersätter markeringen med innehållet i parametern value
. Texten infogas i markeringens position med standardteckenformatet och standardstyckeformatet. Texten behandlas inte som HTML.
Du kan använda metoden replaceSelectedText()
för att infoga och ta bort text utan att störa tecken- och styckeformateringen i resten av texten.
Obs!Metoden fungerar inte om en formatmall används på textfältet.
Parametrar
value:String — Den sträng som ska ersätta den markerade texten.
|
Utlöser
Error — Metoden kan inte användas på ett textfält med en formatmall.
|
Relaterade API-element
Exempel ( Så här använder du exemplet )
Två olika TextField-objekt skapas och händelseavlyssnare läggs till för MouseEvent.MOUSE_UP
-händelserna. Händelsen inträffar när användaren släpper musknappen. Det sker vanligen efter en textmarkering. Observera att standardinställningen för ett textfält är att dess text ska vara markerad.
När en användare släpper musknappen över textfältet myTextField1
i metoden mouseHandler1()
, raderas texten genom att den ersätts med en tom sträng. Detta kan fortsätta tills all text har raderats. När en användare markerar text i textfältet myTextField2
kontrolleras egenskaperna selectionBeginIndex
och selectionEndIndex
i metoden mouseHandler2()
för att se om något tecken markerats. (Egenskaperna selectionBeginIndex
och selectionEndIndex
har inte samma värde om någon text är markerad.) Den markerade texten ersätts sedan av strängen "NEW TEXT". Detta kan fortsätta tills all ursprunglig text i det ursprungliga textfältet har ersatts av strängen "NEW TEXT".
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; public class TextField_replaceSelectedTextExample extends Sprite { private var myTextField1:TextField = new TextField(); private var myTextField2:TextField = new TextField(); public function TextField_replaceSelectedTextExample() { myTextField1.x = 10; myTextField1.width = 300; myTextField1.height = 50; myTextField1.background = true; myTextField1.border = true; myTextField1.text = "Select the text you want to remove from the line."; myTextField2.x = 10; myTextField2.y = 60; myTextField2.width = 300; myTextField2.height = 50; myTextField2.background = true; myTextField2.border = true; myTextField2.text = "Select the text you want to replace with NEW TEXT."; myTextField1.addEventListener(MouseEvent.MOUSE_UP, mouseHandler1); myTextField2.addEventListener(MouseEvent.MOUSE_UP, mouseHandler2); this.addChild(myTextField1); this.addChild(myTextField2); } private function mouseHandler1(e:MouseEvent):void { myTextField1.replaceSelectedText(""); } private function mouseHandler2(e:MouseEvent):void { if(myTextField2.selectionBeginIndex != myTextField2.selectionEndIndex) { myTextField2.replaceSelectedText("NEW TEXT"); } } } }
replaceText | () | metod |
public function replaceText(beginIndex:int, endIndex:int, newText:String):void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ersätter teckenintervallet som anges av parametrarna beginIndex
och endIndex
med innehållet i parametern newText
. Texten från beginIndex
till endIndex-1
ersätts.
Obs!Metoden fungerar inte om en formatmall används på textfältet.
Parametrar
beginIndex:int — Det nollbaserade indexvärdet för ersättningsintervallets startposition.
| |
endIndex:int — Den nollbaserade indexpositionen för det första tecknet i det önskade textomfånget.
| |
newText:String — Den text som ska användas för att ersätta det angivna teckenintervallet.
|
Utlöser
Error — Metoden kan inte användas på ett textfält med en formatmall.
|
Exempel ( Så här använder du exemplet )
replaceText()
för att ta bort, ersätta och infoga text i ett textfält.
Textfältet outputText
ställs automatiskt in så att texten passas och vänsterjusteras. I det första anropet till metoden replaceText()
ersätts den första raden ("This is the wrong heading") med "THIS IS THE HEADING FOR EVERYONE." I det andra anropet till metoden infogas texten "CORRECT" mellan "THE" och "HEADING". I det tredje anropet till metoden tas orden "FOR EVERYONE" bort. Observera att den aktuella textens start- och slutindex ändras för varje anrop till metoden appendText()
. Här visas bara den slutliga texten (efter alla ändringar).
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_replaceTextExample extends Sprite { public function TextField_replaceTextExample() { var outputText:TextField = new TextField(); outputText.x = 10; outputText.y = 10; outputText.background = true; outputText.autoSize = TextFieldAutoSize.LEFT; outputText.appendText("This is the wrong heading"); outputText.appendText("\n\n"); outputText.appendText("This is the body of the text."); outputText.replaceText(0, 25, "THIS IS THE HEADING FOR EVERYONE"); outputText.replaceText(12, 12, "CORRECT "); outputText.replaceText(27, 40, ""); this.addChild(outputText); } } }
setSelection | () | metod |
public function setSelection(beginIndex:int, endIndex:int):void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Anges som markerad text som definierats av indexvärdena för det första och sista tecknet, som anges med parametrarna beginIndex
och endIndex
. Om de två parametervärdena är desamma anger den här metoden en inmatningspunkt, precis som om egenskapen caretIndex
anges.
Parametrar
beginIndex:int — Det nollbaserade indexvärdet för det första tecknet i markeringen (det första tecknet är 0, det andra är 1 och så vidare).
| |
endIndex:int — Det nollbaserade indexvärdet för det sista tecknet i markeringen.
|
Relaterade API-element
Exempel ( Så här använder du exemplet )
Två händelseavlyssnare för textfältet myTextField
avlyssnar användarens musklick eller mussläpp. Mussläpp inträffar när användaren släpper musknappen. Det sker vanligen efter en textmarkering. Observera att standardinställningen för ett textfält är att dess text ska vara markerad. När användaren klickar på någon text anropas metoden clickHandler()
. När text har markerats och musen släpps anropas metoden mouseUpHandler()
.
I både clickHandler()
och mouseUpHandler()
ställer metoden setSelection()
bara in tecknen mellan indexvärde 54 och 70 (TEXT IN ALL CAPS) på att markeras.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_setSelectionExample extends Sprite { private var myTextField:TextField = new TextField(); public function TextField_setSelectionExample() { myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.text = "No matter where you click on this text field only the TEXT IN ALL CAPS is selected."; myTextField.addEventListener(MouseEvent.CLICK, clickHandler); myTextField.addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler); this.addChild(myTextField); } private function clickHandler(event:MouseEvent):void { myTextField.setSelection(54, 70); } private function mouseUpHandler(event:MouseEvent):void { myTextField.setSelection(54, 70); } } }
setTextFormat | () | metod |
public function setTextFormat(format:flash.text:TextFormat, beginIndex:int = -1, endIndex:int = -1):void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Använder textformateringen som angetts av format
-parametern på den angivna texten i ett textfält. Värdet för format
måste vara ett TextFormat-objekt som anger de önskade textformateringsändringarna. Endast de egenskaper som inte har värdet null i format
används på textfältet. Inga format
-egenskaper som är inställda på null
används. Som standard ställs alla egenskaper i ett nyligen skapat TextFormat-objekt in på null
.
Obs!Metoden fungerar inte om en formatmall används på textfältet.
Metoden setTextFormat()
ändrar textformateringen som används för ett intervall med tecken eller för hela texten i ett textfält. Om du vill använda formategenskaperna på all text i textfältet ska du inte ange värden för beginIndex
och endIndex
. Om du vill använda formategenskaperna på ett textintervall anger du värden för parametrarna beginIndex
och endIndex
. Du kan använda length
-egenskapen för att fastställa indexvärden.
De två typerna av formateringsinformation i ett TextFormat-objekt är formatering på teckennivå och på styckenivå. Varje tecken i ett textfält kan ha egna teckenformateringsinställningar, till exempel teckensnittsnamn, teckensnittsstorlek, fet stil och kursiv stil.
I stycken undersöks det första tecknet i stycket för att se om det finns styckeformateringsinställningar för hela stycket. Exempel på styckeformateringsinställningar är vänstermarginal, högermarginal och indrag.
All text som infogas manuellt av användaren eller ersätts med hjälp av metoden replaceSelectedText()
får textfältets standardformatering för ny text, inte formateringen som har angetts för textens inmatningspunkt. Du ställer in standardformateringen för ny text med defaultTextFormat
.
Parametrar
format:flash.text:TextFormat — Ett TextFormat-objekt som innehåller tecken och styckeformateringsinformation.
| |||||||||
beginIndex:int (default = -1 ) — Valfritt. Ett heltal som anger den nollbaserade indexpositionen som anger det första tecknet i det önskade textintervallet.
| |||||||||
endIndex:int (default = -1 ) — Valfritt. Ett heltal som anger det första tecknet efter det önskade textomfånget. Om du anger värden för beginIndex och endIndex uppdateras texten från beginIndex till endIndex-1 .
Observera att all text som infogas manuellt av användaren eller ersätts med hjälp av metoden |
Utlöser
Error — Metoden kan inte användas på ett textfält med en formatmall.
| |
RangeError — beginIndex eller endIndex är utanför intervallet.
|
Relaterade API-element
Exempel ( Så här använder du exemplet )
En händelseavlyssnare för textfältet myTextField
läggs till för att avlyssna musklick och anropa metoden clickHandler()
. I metoden clickHandler()
returnerar metoden getTextFormat()
det nuvarande formatet för ett tecken (indexvärde 55) från det avsedda textintervallet. Formatet placeras sedan i TextFormat-objektet currentTextFormat
. if
-satsen avläser textformatet currentTextFormat
för att se om tecknet i intervallet har det nya formatet (18 punkters textstorlek). Om det inte har det ändras det nya formatet till 18 punkters storlek, färgen ändras till röd och texten stryks under och görs kursiv i intervallet 54 till 70 (TEXT IN ALL CAPS). Om tecknet i intervallet har det nya formatet återställs intervallet till textfältets standardformat.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFormat; import flash.text.TextFieldAutoSize; import flash.events.MouseEvent; public class TextField_setTextFormatExample extends Sprite { private var myTextField:TextField = new TextField(); private var newFormat:TextFormat = new TextFormat(); public function TextField_setTextFormatExample() { myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.selectable = false; myTextField.background = true; myTextField.text = "No matter where you click on this text field only the TEXT IN ALL CAPS changes format."; myTextField.addEventListener(MouseEvent.CLICK, clickHandler); newFormat.color = 0xFF0000; newFormat.size = 18; newFormat.underline = true; newFormat.italic = true; this.addChild(myTextField); } private function clickHandler(event:MouseEvent):void { var currentTextFormat:TextFormat = myTextField.getTextFormat(55); if(currentTextFormat.size != 18) { myTextField.setTextFormat(newFormat, 54, 70); } else { myTextField.setTextFormat(myTextField.defaultTextFormat); } } } }
change | Händelse |
flash.events.Event
egenskap Event.type =
flash.events.Event.CHANGE
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Skickas efter att ett kontrollvärde har modifierats, till skillnad från textInput
-händelsen som skickas innan värdet är modifierat. I W3C DOM Event Model-versionen av change
-händelsen skickas händelsen när kontrollen har förlorat fokus, medan change
-händelsen i ActionScript 3.0-versionen skickas närhelst kontrollen ändras. Om till exempel en användare skriver in text i ett fält skickas en change
-händelse efter varje tangenttryckning.
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. |
Exempel ( Så här använder du exemplet )
Två textfält skapas. Det ena är för användarens indata och det andra (headingTextField
) är för kopian av användarens indata. Dessutom skapas ett TextFormat-objekt och standardtextformatet tilldelas textfältet headingTextField
. När textfältets innehåll ändras anropas metoden changeHandler()
. Den tilldelar texten i textfältet inputTextField
till textfältet headingTextField
. (Om metoden anropades för händelsen TextEvent.TEXT_INPUT
och inte för händelsen Event.CHANGE
, kopieras innehållet i användarindata först efter att användaren har angett mer text.)
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; import flash.text.TextFormat; import flash.text.TextFormatAlign; import flash.events.Event; import flash.events.TextEvent; public class TextField_Event_changeExample extends Sprite { private var inputTextField:TextField = new TextField(); private var headingTextField:TextField = new TextField(); private var newFormat:TextFormat = new TextFormat(); public function TextField_Event_changeExample() { headingTextField.x = 10; headingTextField.y = 10; headingTextField.height = 30; headingTextField.width = 400; headingTextField.background = true; headingTextField.backgroundColor = 0xF5F5DC; headingTextField.selectable = false; inputTextField.x = 10; inputTextField.y = 70; inputTextField.height = 20; inputTextField.width = 230; inputTextField.background = true; inputTextField.border = true; inputTextField.maxChars = 40; inputTextField.wordWrap = true; inputTextField.type = TextFieldType.INPUT; inputTextField.addEventListener(Event.CHANGE, changeHandler); newFormat.bold = true; newFormat.size = 18; newFormat.color = 0xFF0000; newFormat.align = TextFormatAlign.CENTER; headingTextField.defaultTextFormat = newFormat; this.addChild(inputTextField); this.addChild(headingTextField); } private function changeHandler(e:Event):void { headingTextField.text = inputTextField.text; } } }
link | Händelse |
flash.events.TextEvent
egenskap TextEvent.type =
flash.events.TextEvent.LINK
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Skickas när en användare klickar på en hyperlänk i ett HTML-aktiverat textfält där URL-adressen börjar på "event". Det som återstår av URL:en efter ”event:” placeras i textegenskapen i LINK-händelsen.
Obs! Standardbeteendet att texten läggs till i textfältet inträffar bara när Flash Player genererar händelsen, vilket i detta fall sker när en användare försöker skriva in text. Du kan inte ange text i ett textfält genom att skicka textInput
-händelser.
link
-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. |
target | Textfältet som innehåller den hyperlänk användaren har klickat på. 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. |
text | Det som återstår av URL:en efter "event:" |
Exempel ( Så här använder du exemplet )
playMP3()
. Ett TextField-objekt med namnet list
skapas och fylls i med HTML-text. Texten "Track 1"
och "Track 2"
är länkar inuti textfältet. Funktionen playMP3() anropas när användaren klickar på en av länkarna. Namnet på MP3-filen som följs av strängen "event:" i HTML-taggens href
-attribut, skickas till metoden linkHandler()
som text
-egenskap i händelseobjektet link
.
package { import flash.display.Sprite; import flash.errors.IOError; import flash.events.IOErrorEvent; import flash.events.TextEvent; import flash.media.Sound; import flash.media.SoundChannel; import flash.net.URLRequest; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_event_link extends Sprite { private var myMP3:Sound; public function TextField_event_link() { myMP3 = new Sound(); var list:TextField = new TextField(); list.autoSize = TextFieldAutoSize.LEFT; list.multiline = true; list.htmlText = "<a href=\"event:track1.mp3\">Track 1</a><br>"; list.htmlText += "<a href=\"event:track2.mp3\">Track 2</a><br>"; addEventListener(TextEvent.LINK, linkHandler); addChild(list); } private function playMP3(mp3:String):void { try { myMP3.load(new URLRequest(mp3)); myMP3.play(); } catch(err:Error) { trace(err.message); } myMP3.addEventListener(IOErrorEvent.IO_ERROR, errorHandler); } private function linkHandler(linkEvent:TextEvent):void { playMP3(linkEvent.text); } private function errorHandler(errorEvent:IOErrorEvent):void { trace(errorEvent.text); } } }
scroll | Händelse |
flash.events.Event
egenskap Event.type =
flash.events.Event.SCROLL
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Skickas av ett TextField-objekt efter att användaren rullat.
Event.SCROLL
-konstanten definierar värdet på type
-egenskapen i ett scroll
-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 TextField-objekt som har rullats. target -egenskapen ä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. |
Exempel ( Så här använder du exemplet )
mouseDown
-händelsen och den associerade mouseDownScroll
-hanteraren anropas. mouseDownScroll()
-hanteraren gör att fältet rullar. Därefter skickas scroll
-händelsen, och den associerade scrollHandler()
-hanteraren uppdaterar det andra textfältet för att visa den aktuella rullningspositionen.
package { import flash.display.Sprite; import flash.text.*; import flash.events.Event; import flash.events.TextEvent; import flash.events.MouseEvent; public class TextScrollExample extends Sprite { private var myTextBox1:TextField = new TextField(); private var myTextBox2:TextField = new TextField(); private var myText:String = "Hello world and welcome to the show. It's really nice to meet you. Take your coat off and stay a while. OK, show is over. Hope you had fun. You can go home now. Don't forget to tip your waiter. There are mints in the bowl by the door. Thank you. Please come again."; public function TextScrollExample() { myTextBox1.text = myText; myTextBox1.width = 200; myTextBox1.height = 50; myTextBox1.multiline = true; myTextBox1.wordWrap = true; myTextBox1.background = true; myTextBox1.border = true; myTextBox2.x=220; myTextBox2.text="scrolled to line: " + myTextBox1.scrollV; addChild(myTextBox1); addChild(myTextBox2); myTextBox1.addEventListener(MouseEvent.MOUSE_DOWN, mouseDownScroll); myTextBox1.addEventListener(Event.SCROLL, scrollHandler); } public function mouseDownScroll(event:MouseEvent):void { myTextBox1.scrollV++; } public function scrollHandler(event:Event):void { myTextBox2.text="scrolled to line: " + myTextBox1.scrollV; } } }
textInput | Händelse |
flash.events.TextEvent
egenskap TextEvent.type =
flash.events.TextEvent.TEXT_INPUT
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Flash Player skickar textInput
-händelsen när en användare anger ett eller fler texttecken. Olika textinmatningsmetoder kan utlösa den här händelsen, inklusive standardtangentbord, redigeringsprogram för inmatningsmetod (IME), röst- eller taligenkänningssystem och till och med åtgärden att klistra in oformaterad text utan formatinformation.
textInput
-händelseobjekts type
-egenskap.
Obs! Den här händelsen skickas inte för Delete- och backstegstangenterna.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
bubbles | true |
cancelable | true ; anropa preventDefault() -metoden för att avbryta standardbeteendet. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Det textfält som tecken anges i. Målet ä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. |
text | Det tecken eller den följd av tecken som användaren har angivit. |
Exempel ( Så här använder du exemplet )
textInput
-händelsen, textInputHandler()
-hanteraren anropas och tecknen visas i det andra textfältet. När du klistrar in ett textblock i inmatningsfältet kopierar händelsehanteraren hela blocket till det andra fältet.
package { import flash.display.Sprite; import flash.text.*; import flash.events.Event; import flash.events.TextEvent; import flash.events.MouseEvent; public class TextInputExample extends Sprite { private var myTextBox1:TextField = new TextField(); private var myTextBox2:TextField = new TextField(); public function TextInputExample() { myTextBox1.type = TextFieldType.INPUT; myTextBox1.width = 200; myTextBox1.height = 20; myTextBox1.background = true; myTextBox1.border = true; myTextBox2.x=220; addChild(myTextBox1); addChild(myTextBox2); myTextBox1.addEventListener(TextEvent.TEXT_INPUT,textInputHandler); } public function textInputHandler(event:TextEvent):void { myTextBox2.text=event.text; } } }
textInteractionModeChange | Händelse |
flash.events.Event
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 11, Flash Lite 4 |
Flash Player skickar textInteractionModeChange
-händelsen när en användare ändrar interaktionsläget för ett textfält. På Android kan du till exempel växla från läget NORMAL till SELECTION med hjälp av alternativ på snabbmenyn
TextFieldExample
för att visa ett textmeddelande. Detta sker genom följande steg:
- En
label
-egenskap av typen TextField skapas. - Klasskonstruktorn anropar funktionen
configureLabel()
. - Metoden
configureLabel()
skapar först ett nytt TextField-objekt och kopplar det till egenskapenlabel
och ställer sedan in sina parametrar på följande:- Vänsterjustera textfältet.
- Aktivera bakgrundsfyllningen.
- Aktivera kantlinjen.
- Metoden
configureLabel()
skapar variabelnformat
och kopplar den till en ny TextFormat-instans med parametrarna inställda på följande:- Font type = Verdana
- Font color = solid red
- Font size = 10
- Font underline = true
- Egenskapen
defaultTextFormat
i textfältetlabel
är inställt påformat
ochlabel
-instansen läggs till i visningslistan som först visar ett textfält utan text på scenen. - Konstruktorn anger texten i textfältet
label
till"Hello world and welcome to the show."
genom att anropa metodensetLabel()
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.text.TextFormat; public class TextFieldExample extends Sprite { private var label:TextField; private var labelText:String = "Hello world and welcome to the show."; public function TextFieldExample() { configureLabel(); setLabel(labelText); } public function setLabel(str:String):void { label.text = str; } private function configureLabel():void { label = new TextField(); label.autoSize = TextFieldAutoSize.LEFT; label.background = true; label.border = true; var format:TextFormat = new TextFormat(); format.font = "Verdana"; format.color = 0xFF0000; format.size = 10; format.underline = true; label.defaultTextFormat = format; addChild(label); } } }
Tue Jun 12 2018, 01:40 PM Z