Pakket | flash.text |
Klasse | public class TextField |
Overerving | TextField InteractiveObject DisplayObject EventDispatcher Object |
Subklassen | FlexTextField |
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wanneer u dynamisch een tekstveld wilt maken, gebruikt u de constructor TextField()
.
Met de methoden van de klasse TextField kunt u tekst in een dynamisch tekstveld of een invoertekstveld dat u tijdens het ontwerp of de uitvoering hebt gemaakt, instellen, selecteren en bewerken.
Met ActionScript kunt u tekst bij uitvoering op diverse manieren opmaken. Met de klasse TextFormat kunt u teken- en alineaopmaak instellen voor objecten TextField. U kunt CSS-stijlen (Cascading Style Sheets) op tekstvelden toepassen met de eigenschapTextField.styleSheet
en de klasse StyleSheet. U kunt CSS gebruiken voor het opmaken van ingebouwde HTML-tags, het definiëren van nieuwe opmaakcodes of het toepassen van stijlen. U kunt tekst met HTML-opmaak rechtstreeks toewijzen aan een tekstveld (met optioneel gebruik van CSS-stijlen). HTML-tekst die u toewijst aan een tekstveld kan ingesloten media bevatten (filmclips, SWF-bestanden, GIF-bestanden, PNG-bestanden en JPEG-bestanden). De tekst loopt om de ingesloten media heen, net als tekstomloop in een webbrowser bij ingesloten media in een HTML-document.
Flash Player ondersteunt een aantal HTML-tags voor de opmaak van tekst. Zie de lijst met ondersteunde HTML-tags in de beschrijving van de eigenschap htmlText
.
Verwante API-elementen
Eigenschap | Gedefinieerd door | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
De huidige toegankelijkheidsimplementatie (AccessibilityImplementation) voor deze InteractiveObject-instantie. | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
De huidige toegankelijkheidsopties voor dit weergaveobject. | DisplayObject | ||
alpha : Number
Geeft de alpha-transparantiewaarde van het opgegeven object aan. | DisplayObject | ||
alwaysShowSelection : Boolean
Wanneer ingesteld op true en het tekstveld geen focus heeft, maakt Flash Player de selectie in het tekstveld grijs. | TextField | ||
antiAliasType : String
Het type antialiasing dat wordt gebruikt voor dit tekstveld. | TextField | ||
autoSize : String
Bepaalt de automatische aanpassing van grootte en uitlijning van tekstvelden. | TextField | ||
background : Boolean
Geeft op of het tekstveld een opvulkleur voor de achtergrond heeft. | TextField | ||
backgroundColor : uint
De kleur van de tekstveldachtergrond. | TextField | ||
blendMode : String
Een waarde uit de klasse BlendMode die opgeeft welke overvloeimodus moet worden gebruikt. | DisplayObject | ||
blendShader : Shader [alleen-schrijven]
Stelt de arcering in die moet worden gebruikt om voor- en achtergrond in elkaar te laten overvloeien. | DisplayObject | ||
border : Boolean
Geeft op of het tekstveld een rand heeft. | TextField | ||
borderColor : uint
De kleur van de tekstveldrand. | TextField | ||
bottomScrollV : int [alleen-lezen]
Een geheel getal (een op 1 gebaseerde index) dat aangeeft welke regel als onderste regel wordt weergegeven in het opgegeven tekstveld. | TextField | ||
cacheAsBitmap : Boolean
Indien ingesteld op true, plaatsen Flash-runtimes een interne bitmaprepresentatie van het weergaveobject in cache. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
Als dit Matrix-object niet null is, definieert het hoe een weergaveobject wordt gerenderd als cacheAsBitmap wordt ingesteld op true. | DisplayObject | ||
caretIndex : int [alleen-lezen]
De index van de positie van het invoegpunt (invoegteken). | TextField | ||
condenseWhite : Boolean
Een booleaanse waarde die aangeeft of extra witruimte (spaties, regeleinden, enzovoort) in een tekstveld met HTML-tekst wordt verwijderd. | TextField | ||
constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | ||
contextMenu : NativeMenu
Geeft het contextmenu op dat is gekoppeld aan dit object. | InteractiveObject | ||
defaultTextFormat : flash.text:TextFormat
Geeft de opmaak op die op nieuw ingevoegde tekst wordt toegepast, zoals tekst die door de gebruiker is ingevoerd of tekst die met de methode replaceSelectedText() is ingevoegd. | TextField | ||
displayAsPassword : Boolean
Geeft aan of het tekstveld een tekstveld voor wachtwoorden is. | TextField | ||
doubleClickEnabled : Boolean
Geeft op of dit object gebeurtenissen doubleClick ontvangt. | InteractiveObject | ||
embedFonts : Boolean
Geeft op of moet worden gerenderd met ingesloten lettertypecontouren. | TextField | ||
filters : Array
Een geïndexeerde array die elk filterobject bevat dat momenteel is gekoppeld aan het weergaveobject. | DisplayObject | ||
focusRect : Object
Geeft op of dit object een focusrechthoek weergeeft. | InteractiveObject | ||
gridFitType : String
Het type rasteraanpassing dat wordt gebruikt voor dit tekstveld | TextField | ||
height : Number
Geeft de hoogte van het weergaveobject aan, in pixels. | DisplayObject | ||
htmlText : String
Bevat de HTML-representatie van de inhoud van het tekstveld. | TextField | ||
length : int [alleen-lezen]
Het aantal tekens in een tekstveld. | TextField | ||
loaderInfo : LoaderInfo [alleen-lezen]
Retourneert een object LoaderInfo dat informatie bevat over het laden van het bestand waartoe dit weergaveobject behoort. | DisplayObject | ||
mask : DisplayObject
Het aanroepende weergaveobject wordt gemaskeerd door het opgegeven object mask. | DisplayObject | ||
maxChars : int
Het maximum aantal tekens dat het tekstveld kan bevatten (ingevoerd door de gebruiker). | TextField | ||
maxScrollH : int [alleen-lezen]
De maximumwaarde van scrollH. | TextField | ||
maxScrollV : int [alleen-lezen]
De maximumwaarde van scrollV. | TextField | ||
metaData : Object
Krijgt het metagegevensobject van de DisplayObject-instantie als de metagegevens zijn opgeslagen naast de instantie van dit DisplayObject in het SWF-bestand door een PlaceObject4-markering. | DisplayObject | ||
mouseEnabled : Boolean
Geeft aan of dit object berichten van de muis of gebruikersinvoer ontvangt. | InteractiveObject | ||
mouseWheelEnabled : Boolean
Een booleaanse waarde die aangeeft of Flash Player automatisch door tekstvelden met meerdere regels schuift wanneer de gebruiker op een tekstveld klikt en het muiswiel gebruikt. | TextField | ||
mouseX : Number [alleen-lezen]
Geeft de x-coördinaat van de apparaatpositie van de muis of de gebruikersinvoer aan in pixels. | DisplayObject | ||
mouseY : Number [alleen-lezen]
Geeft de y-coördinaat van de apparaatpositie van de muis of de gebruikersinvoer aan in pixels. | DisplayObject | ||
multiline : Boolean
Hiermee wordt aangegeven of het veld een tekstveld met meerdere regels is. | TextField | ||
name : String
Geeft de instantienaam van het DisplayObject aan. | DisplayObject | ||
needsSoftKeyboard : Boolean
Geeft aan of een virtueel toetsenbord (een softwaretoetsenbord op het scherm) moet worden weergegeven wanneer deze InteractiveObject-instantie focus krijgt. | InteractiveObject | ||
numLines : int [alleen-lezen]
Definieert het aantal tekstregels in een tekstveld met meerdere regels. | TextField | ||
opaqueBackground : Object
Geeft op of het weergaveobject dekkend is met een bepaalde achtergrondkleur. | DisplayObject | ||
parent : DisplayObjectContainer [alleen-lezen]
Geeft het object DisplayObjectContainer aan dat dit weergaveobject bevat. | DisplayObject | ||
restrict : String
Geeft de set tekens aan die een gebruiker in het tekstveld kan invoeren. | TextField | ||
root : DisplayObject [alleen-lezen]
Voor een weergaveobject in een geladen SWF-bestand is de eigenschap root het bovenste weergaveobject in het gedeelte van de boomstructuur van het weergaveoverzicht dat wordt vertegenwoordigd door dat SWF-bestand. | DisplayObject | ||
rotation : Number
Geeft de rotatie van de instantie DisplayObject vanaf de oorspronkelijke oriëntatie (in graden) aan. | DisplayObject | ||
rotationX : Number
Geeft in graden de X-asrotatie van de DisplayObject-instantie aan ten opzichte van de 3D parent-container. | DisplayObject | ||
rotationY : Number
Geeft in graden de y-asrotatie van de DisplayObject-instantie aan ten opzichte van de 3D parent-container. | DisplayObject | ||
rotationZ : Number
Geeft in graden de z-asrotatie van de DisplayObject-instantie aan ten opzichte van de 3D parent-container. | DisplayObject | ||
scale9Grid : Rectangle
Het huidige schaalraster dat wordt gebruikt. | DisplayObject | ||
scaleX : Number
Bepaalt de horizontale schaal (percentage) van het object zoals deze wordt toegepast vanuit het registratiepunt. | DisplayObject | ||
scaleY : Number
Bepaalt de verticale schaal (percentage) van een object zoals deze wordt toegepast vanuit het registratiepunt van het object. | DisplayObject | ||
scaleZ : Number
Bepaalt de diepteschaal (percentage) van een object zoals deze wordt toegepast vanuit het registratiepunt van het object. | DisplayObject | ||
scrollH : int
De huidige horizontale schuifpositie. | TextField | ||
scrollRect : Rectangle
De verschuivende rechthoekgrenzen van het weergaveobject. | DisplayObject | ||
scrollV : int
De verticale positie van tekst in een tekstveld. | TextField | ||
selectable : Boolean
Een booleaanse waarde die aangeeft of het tekstveld kan worden geselecteerd. | TextField | ||
selectionBeginIndex : int [alleen-lezen]
De op nul gebaseerde indexwaarde van het eerste teken in de huidige selectie. | TextField | ||
selectionEndIndex : int [alleen-lezen]
De op nul gebaseerde indexwaarde van het laatste teken in de huidige selectie. | TextField | ||
sharpness : Number
De scherpte van de glyph-randen in dit tekstveld. | TextField | ||
softKeyboard : String
Bepaalt het uiterlijk van het schermtoetsenbord. | InteractiveObject | ||
softKeyboardInputAreaOfInterest : Rectangle
Definieert het gebied dat als scherm moet blijven fungeren wanneer een softwaretoetsenbord wordt weergegeven (niet beschikbaar op iOS). | InteractiveObject | ||
stage : Stage [alleen-lezen]
Het werkgebied van het weergaveobject. | DisplayObject | ||
styleSheet : StyleSheet
Koppelt een stijlpagina aan het tekstveld. | TextField | ||
tabEnabled : Boolean
Geeft op of dit object in de tabvolgorde is opgenomen. | InteractiveObject | ||
tabIndex : int
Geeft de tabvolgorde van objecten in een SWF-bestand op. | InteractiveObject | ||
text : String
Een tekenreeks die de huidige tekst in het tekstveld is. | TextField | ||
textColor : uint
De kleur van de tekst in een tekstveld, in hexadecimale notatie. | TextField | ||
textHeight : Number [alleen-lezen]
De hoogte van de tekst in pixels. | TextField | ||
textInteractionMode : String [alleen-lezen]
De eigenschap van de interactiemodus. De standaardwaarde is TextInteractionMode.NORMAL. | TextField | ||
textWidth : Number [alleen-lezen]
De breedte van de tekst in pixels. | TextField | ||
thickness : Number
De dikte van de glyph-randen in dit tekstveld. | TextField | ||
transform : flash.geom:Transform
Een object met eigenschappen die betrekking hebben op de matrix van een weergaveobject, de kleurtransformatie en de pixelbeperkingen. | DisplayObject | ||
type : String
Het type tekstveld. | TextField | ||
useRichTextClipboard : Boolean
Geeft aan of de tekstopmaak samen met de tekst moet worden gekopieerd en geplakt. | TextField | ||
visible : Boolean
Bepaalt of het weergaveobject zichtbaar is. | DisplayObject | ||
width : Number
Geeft de breedte van het weergaveobject aan, in pixels. | DisplayObject | ||
wordWrap : Boolean
Een booleaanse waarde die aangeeft of voor het tekstveld tekstomloop is ingesteld. | TextField | ||
x : Number
Bepaalt de x-coördinaat van de instantie DisplayObject ten opzichte van de lokale coördinaten van de bovenliggende DisplayObjectContainer. | DisplayObject | ||
y : Number
Bepaalt de y-coördinaat van de instantie DisplayObject ten opzichte van de lokale coördinaten van de bovenliggende DisplayObjectContainer. | DisplayObject | ||
z : Number
Geeft de z-coördinaatpositie langs de z-as van de DisplayObject-instantie aan ten opzichte van de bovenliggende 3D-container. | DisplayObject |
Methode | Gedefinieerd door | ||
---|---|---|---|
Maakt een nieuwe instantie TextField. | TextField | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt. | EventDispatcher | ||
Voegt de tekenreeks die is opgegeven met de parameter newText toe aan het einde van de tekst in het tekstveld. | TextField | ||
Verzendt een gebeurtenis naar de gebeurtenisstroom. | EventDispatcher | ||
Retourneert een rechthoek die het gebied van het weergaveobject aangeeft ten opzichte van het coördinatensysteem van het object targetCoordinateSpace. | DisplayObject | ||
Retourneert een rechthoek die het selectiekader van het teken vormt. | TextField | ||
Retourneert de op nul gebaseerde indexwaarde van het teken op het punt dat is opgegeven met de parameters x en y. | TextField | ||
Op basis van een tekenindex wordt hiermee de index van het eerste teken in dezelfde alinea geretourneerd. | TextField | ||
Retourneert een DisplayObject-verwijzing voor de opgegeven id voor een afbeeldings- of SWF-bestand dat is toegevoegd aan een tekstveld met HTML-opmaak met de tag <img>. | TextField | ||
Retourneert de op nul gebaseerde indexwaarde van de regel op het punt dat is opgegeven met de parameters x en y. | TextField | ||
Retourneert de op nul gebaseerde indexwaarde van de regel die het teken bevat dat door de parameter charIndex wordt opgegeven. | TextField | ||
Retourneert het aantal tekens in een opgegeven tekstregel. | TextField | ||
Geeft metrische informatie over een bepaalde tekstregel weer. | TextField | ||
Retourneert de tekenindex van het eerste teken op de regel die wordt opgegeven door de parameter lineIndex. | TextField | ||
Retourneert de tekst van de regel die wordt opgegeven door de parameter lineIndex. | TextField | ||
Op basis van een tekenindex wordt hiermee de lengte van de alinea met het opgegeven teken geretourneerd. | TextField | ||
Retourneert een rechthoek die de grens van het weergaveobject aangeeft op basis van het coördinatensysteem dat wordt gedefinieerd door de paramater targetCoordinateSpace, minus enige streken op vormen. | DisplayObject | ||
Retourneert een object TextFormat met opmaakgegevens voor de tekst die is opgegeven met de parameters beginIndex en endIndex. | TextField | ||
Hiermee worden de (algemene) werkgebiedcoördinaten van het object point omgezet in (lokale) objectcoördinaten. | DisplayObject | ||
Converteert een tweedimensionaal punt van de (algemene) werkruimtecoördinaten naar (lokale) coördinaten van een driedimensionaal weergaveobject. | DisplayObject | ||
Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis. | EventDispatcher | ||
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | ||
Evalueert het selectiekader van het weergaveobject om te zien of dit het selectiekader van het weergaveobject obj overlapt of snijdt. | DisplayObject | ||
Hiermee wordt het weergaveobject geëvalueerd om te zien of deze een punt dat is opgegeven door de parameters x en y, overlapt of doorsnijdt. | DisplayObject | ||
[statisch]
Hiermee wordt true geretourneerd als een ingesloten lettertype beschikbaar is met de opgegeven fontName en fontStyle waarbij Font.fontType flash.text.FontType.EMBEDDED is. | TextField | ||
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | ||
Converteert een driedimensionaal punt van de (lokale) coördinaten van het driedimensionale weergaveobject naar een tweedimensionaal punt in de (algemene) werkruimtecoördinaten. | DisplayObject | ||
Hiermee worden de (lokale) weergaveobjectcoördinaten van het object point omgezet in (algemene) werkgebiedcoördinaten. | DisplayObject | ||
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | ||
Verwijdert een listener uit het object EventDispatcher. | EventDispatcher | ||
Hiermee wordt de huidige selectie door de inhoud van de parameter value vervangen. | TextField | ||
Vervangt de met de parameters beginIndex en endIndex opgegeven tekenreeks door de inhoud van de parameter newText. | TextField | ||
Geeft een virtueel toetsenbord weer. | InteractiveObject | ||
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | ||
Stelt de tekst als geselecteerd in die wordt bepaald door de indexwaarden van het eerste en laatste teken, opgegeven door de parameters beginIndex en endIndex. | TextField | ||
Past de tekstopmaak die is opgegeven met de parameter format toe op de opgegeven tekst in een tekstveld. | TextField | ||
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | ||
Retourneert een tekenreeksrepresentatie van het opgegeven object. | Object | ||
Retourneert de primitieve waarde van het opgegeven object. | Object | ||
Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis. | EventDispatcher |
Gebeurtenis | Overzicht | Gedefinieerd door | ||
---|---|---|---|---|
[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt. | EventDispatcher | |||
Wordt verzonden wanneer een weergaveobject aan het weergaveoverzicht wordt toegevoegd. | DisplayObject | |||
Wordt verzonden wanneer een weergaveobject direct of via toevoeging van een subboomstructuur die het weergaveobject bevat, aan het weergaveoverzicht van het werkgebied wordt toegevoegd. | DisplayObject | |||
Wordt verzonden nadat een besturingswaarde is gewijzigd, in tegenstelling tot de gebeurtenis textInput, die wordt verzonden voordat de waarde wordt gewijzigd. | TextField | |||
Wordt verzonden wanneer de gebruiker Wissen of Verwijderen kiest in het snelmenu. | InteractiveObject | |||
Wordt verzonden wanneer een gebruiker op de hoofdknop van het aanwijsapparaat drukt en deze boven hetzelfde InteractiveObject loslaat. | InteractiveObject | |||
Wordt verzonden wanneer een handeling van de gebruiker het snelmenu opent dat aan dit interactieve object in een AIR-toepassing is gekoppeld. | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker de platformspecifieke toetsencombinatie voor een kopieerbewerking gebruikt of Kopiëren kiest in het contextmenu. | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker de platformspecifieke toetsencombinatie voor een knipbewerking gebruikt of Knippen kiest in het contextmenu. | InteractiveObject | |||
[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt. | EventDispatcher | |||
Wordt verzonden wanneer de gebruiker tweemaal snel achtereen op de hoofdknop van een aanwijsapparaat drukt en deze boven hetzelfde InteractiveObject loslaat wanneer de markering doubleClickEnabled van dit object op true is ingesteld. | InteractiveObject | |||
[uitzendgebeurtenis] Wordt verzonden wanneer de afspeelkop een nieuw frame ingaat. | DisplayObject | |||
[uitzendgebeurtenis] Wordt verzonden wanneer de afspeelkop het huidige frame verlaat. | DisplayObject | |||
Wordt verzonden nadat een weergaveobject focus heeft gekregen. | InteractiveObject | |||
Wordt verzonden nadat een weergaveobject focus heeft verloren. | InteractiveObject | |||
[uitzendgebeurtenis] Wordt verzonden nadat de constructors van frameweergaveobjecten zijn uitgevoerd, maar voordat framescripts zijn uitgevoerd. | DisplayObject | |||
Wordt verzonden wanneer de gebruiker een aanraakpunt langs de rand van het touchoppervlak maakt met een InteractiveObject-instantie (zoals wanneer u langs de rand van het touchoppervlak op Siri Extern voor Apple TV tikt). Sommige apparaten interpreteren dit contact misschien ook als een combinatie van verschillende aanraakgebeurtenissen. | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker op twee aanraakpunten drukt op dezelfde InteractiveObject-instantie op een apparaat met aanraakbediening (zoals wanneer de gebruiker met twee vingers op een weergaveobject op een gsm of tablet met aanraakscherm drukt en vervolgens weer loslaat). | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker een aanraakpunt over de InteractiveObject-instantie beweegt op een apparaat met aanraakbediening (zoals wanneer de gebruiker een vinger van links naar rechts beweegt over een weergaveobject op een gsm of tablet met aanraakscherm). | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker een zoombeweging maakt op een aanraakpunt met een InteractiveObject-instantie (zoals wanneer de gebruiker een scherm aanraakt met twee vingers en deze vervolgens roteert over een weergaveobject op een gsm of tablet met een aanraakscherm). | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker een veegbeweging maakt op een aanraakpunt met een InteractiveObject-instantie (zoals wanneer de gebruiker een scherm aanraakt met drie vingers en deze vervolgens parallel beweegt over een weergaveobject op een gsm of tablet met een aanraakscherm). | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker een aanraakpunt maakt met een InteractiveObject-instantie en vervolgens op een apparaat met aanraakbediening drukt (zoals wanneer de gebruiker een paar vingers op een weergaveobject plaatst om een menu te openen en er met een vinger op drukt om een menu-item op een gsm of tablet met een aanraakscherm te selecteren). | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker een zoombeweging maakt op een aanraakpunt met een InteractiveObject-instantie (zoals wanneer de gebruiker een scherm aanraakt met twee vingers en deze vervolgens snel spreidt over een weergaveobject op een gsm of tablet met een aanraakscherm). | InteractiveObject | |||
Deze gebeurtenis wordt verzonden naar elke clienttoepassing die inline-invoer met een IME ondersteunt. | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker op een toets drukt. | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker focus probeert te wijzigen met toetsenbordnavigatie. | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker een toets loslaat. | InteractiveObject | |||
Wordt verzonden wanneer een gebruiker op een hyperlink in een HTML-tekstveld klikt waarbij de URL begint met 'event:'. | TextField | |||
Wordt verzonden wanneer een gebruiker op de middelste knop van het aanwijsapparaat drukt en deze boven hetzelfde InteractiveObject loslaat. | InteractiveObject | |||
Wordt verzonden wanneer een gebruiker op de middelste aanwijsapparaatknop drukt over een instantie InteractiveObject. | InteractiveObject | |||
Wordt verzonden wanneer een gebruiker de aanwijsapparaatknop over een instantie InteractiveObject beweegt. | InteractiveObject | |||
Wordt verzonden wanneer een gebruiker op de aanwijsapparaatknop drukt over een instantie InteractiveObject. | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker focus probeert te wijzigen met een aanwijsapparaat. | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker het aanwijsapparaat verplaatst terwijl het zich boven een InteractiveObject bevindt. | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker een aanwijsapparaat van een instantie InteractiveObject af verplaatst. | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker een aanwijsapparaat over een instantie InteractiveObject beweegt. | InteractiveObject | |||
Wordt verzonden wanneer een gebruiker de aanwijsapparaatknop over een instantie InteractiveObject beweegt. | InteractiveObject | |||
Wordt verzonden wanneer een muiswiel over een instantie InteractiveObject wordt gedraaid. | InteractiveObject | |||
Wordt verzonden door de sleepinitiator InteractiveObject wanneer de gebruiker de sleepbeweging onderbreekt. | InteractiveObject | |||
Wordt verzonden door het doel InteractiveObject wanneer een gesleept object erop wordt neergezet en het neerzetten is geaccepteerd met een aanroep van DragManager.acceptDragDrop(). | InteractiveObject | |||
Wordt verzonden door een InteractiveObject wanneer een sleepbeweging binnen de grens komt. | InteractiveObject | |||
Wordt verzonden door een InteractiveObject wanneer een sleepbeweging buiten de grens komt. | InteractiveObject | |||
Wordt continu verzonden door een InteractiveObject zolang een sleepbeweging binnen de grenzen blijft. | InteractiveObject | |||
Wordt verzonden aan het begin van een sleepbewerking door het InteractiveObject dat in de aanroep DragManager.doDrag() is opgegeven als de sleepinitiator. | InteractiveObject | |||
Wordt verzonden tijdens een sleepbewerking door het InteractiveObject dat in de aanroep DragManager.doDrag() is opgegeven als de sleepinitiator. | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker de platformspecifieke toetsencombinatie voor een plakbewerking gebruikt of Plakken kiest in het contextmenu. | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker een actieve stylus omlaag en binnen de detectiedrempel van het scherm plaatst. | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker een actieve stylus boven de detectiedrempel van het scherm tilt. | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker een actieve stylus boven het scherm plaatst en binnen de detectiedrempel blijft. | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker een actieve stylus bij dit InteractiveObject weghaalt, maar wel binnen de detectiedrempel van het scherm blijft. | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker een actieve stylus recht boven dit InteractiveObject plaatst en binnen de detectiedrempel van het scherm blijft. | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker een actieve stylus van dit InteractiveObject en eventuele onderliggende elementen weghaalt, maar wel binnen de detectiedrempel van het scherm blijft. | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker een actieve stylus van buiten de afstammelingenstructuur van het object in de weergavelijst (maar dicht genoeg bij het scherm om binnen de detectiedrempel te blijven) boven dit InteractiveObject plaatst. | InteractiveObject | |||
Verzonden wanneer een gebruiker de knop op het aanwijsapparaat loslaat nadat hij de knop eerst boven een InteractiveObject-instantie heeft ingedrukt en het aanwijsapparaat vervolgens van deze instantie heeft verplaatst. | InteractiveObject | |||
Wordt verzonden vlak voordat een weergaveobject uit het weergaveoverzicht wordt verwijderd. | DisplayObject | |||
Wordt verzonden vlak voordat een weergaveobject uit het weergaveoverzicht wordt verwijderd. Dit kan rechtstreeks gebeuren of door de subboomstructuur te verwijderen die het weergaveobject bevat. | DisplayObject | |||
[uitzendgebeurtenis] Wordt verzonden wanneer de weergavelijst op het punt staat te worden bijgewerkt en gerenderd. | DisplayObject | |||
Wordt verzonden wanneer een gebruiker op de rechterknop van het aanwijsapparaat drukt en deze boven hetzelfde InteractiveObject loslaat. | InteractiveObject | |||
Wordt verzonden wanneer een gebruiker op de aanwijsapparaatknop drukt over een instantie InteractiveObject. | InteractiveObject | |||
Wordt verzonden wanneer een gebruiker de aanwijsapparaatknop over een instantie InteractiveObject beweegt. | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker een aanwijsapparaat van een instantie InteractiveObject af verplaatst. | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker een aanwijsapparaat over een instantie InteractiveObject beweegt. | InteractiveObject | |||
Wordt verzonden door een object TextField nadat de gebruiker schuift. | TextField | |||
Wordt verzonden wanneer de gebruiker de platformspecifieke toetsencombinatie gebruikt voor de bewerking Alles selecteren of Alles selecteren kiest in het snelmenu. | InteractiveObject | |||
Wordt meteen verzonden nadat het softwaretoetsenbord wordt weergegeven. | InteractiveObject | |||
Wordt verzonden vlak voordat het softwaretoetsenbord wordt weergegeven. | InteractiveObject | |||
Wordt meteen verzonden nadat het softwaretoetsenbord van het scherm is verdwenen. | InteractiveObject | |||
Wordt verzonden wanneer de waarde van de markering tabChildren van het object wordt gewijzigd. | InteractiveObject | |||
Wordt verzonden wanneer de markering tabEnabled van het object wordt gewijzigd. | InteractiveObject | |||
Wordt verzonden wanneer de waarde van de eigenschap tabIndex van het object wordt gewijzigd. | InteractiveObject | |||
Flash Player verzendt de gebeurtenis textInput wanneer een gebruiker een of meer tekens invoert. | TextField | |||
Flash Player verzendt de gebeurtenis textInteractionModeChange wanneer een gebruiker de interactiemodus van een tekstveld wijzigt. | TextField | |||
Wordt verzonden wanneer de gebruiker voor het eerst een apparaat met aanraakbediening aanraakt (zoals wanneer de gebruiker een gsm of tablet met aanraakscherm met een vinger aanraakt). | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker het contact met een apparaat met aanraakbediening verwijdert (zoals wanneer de gebruiker een vinger van een gsm of tablet met aanraakscherm tilt). | InteractiveObject | |||
De gebeurtenis wordt continu verzonden, vanaf het moment dat de gebruiker het apparaat aanraakt, tot het moment dat de aanraking ophoudt. | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker het contactpunt over een InteractiveObject-instantie op een apparaat met aanraakbediening beweegt (zoals wanneer de gebruiker een vinger van een weergaveobject naar een ander weergaveobject op een gsm of tablet met aanraakscherm sleept). | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker het contactpunt over een InteractiveObject-instantie op een apparaat met aanraakbediening beweegt (zoals wanneer de gebruiker een vinger van een punt buiten een weergaveobject naar een punt op een weergaveobject op een gsm of tablet met aanraakscherm versleept). | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker het aanraakpunt bij een InteractiveObject-instantie vandaan verplaatst op een apparaat met aanraakfunctionaliteit (zoals wanneer de gebruiker een vinger van een punt boven het weergaveobject naar een punt buiten het object sleept op een mobiele telefoon of een tablet met een aanraakscherm). | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker het contactpunt over een InteractiveObject-instantie op een apparaat met aanraakbediening beweegt (zoals wanneer de gebruiker een vinger van een punt buiten een weergaveobject naar een punt op een weergaveobject op een gsm of tablet met aanraakscherm versleept). | InteractiveObject | |||
Wordt verzonden wanneer de gebruiker het contactpunt op dezelfde InteractiveObject-instantie tilt waarop het contact op een apparaat met aanraakbediening was geïnitialiseerd (zoals wanneer de gebruiker een vinger op één punt van een weergaveobject drukt en vervolgens loslaat op een gsm of tablet met aanraakscherm). | InteractiveObject |
alwaysShowSelection | eigenschap |
alwaysShowSelection:Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wanneer ingesteld op true
en het tekstveld geen focus heeft, maakt Flash Player de selectie in het tekstveld grijs. Wanneer ingesteld op false
en het tekstveld geen focus heeft, wordt de selectie in het tekstveld niet gemarkeerd.
De standaardwaarde is false.
Implementatie
public function get alwaysShowSelection():Boolean
public function set alwaysShowSelection(value:Boolean):void
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
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 | eigenschap |
antiAliasType:String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Het type antialiasing dat wordt gebruikt voor dit tekstveld. Gebruikt constanten flash.text.AntiAliasType
voor deze eigenschap. U kunt deze instelling alleen beheren wanneer het lettertype is ingesloten (met de eigenschap embedFonts
op true
ingesteld). De standaardinstelling is flash.text.AntiAliasType.NORMAL
.
Wanneer u waarden voor deze eigenschap wilt instellen, gebruikt u de volgende tekenreekswaarden:
Tekenreekswaarde | Beschrijving |
---|---|
flash.text.AntiAliasType.NORMAL | Normale antialiasing van tekst wordt toegepast. Deze waarde komt overeen met het type antialiasing dat in Flash Player 7 en lagere versies werd gebruikt. |
flash.text.AntiAliasType.ADVANCED | Geavanceerde antialiasing wordt toegepast, waardoor de tekst beter leesbaar wordt. (Dit kenmerk was voor het eerst beschikbaar in Flash Player 8.) Bij geavanceerde antialiasing kunnen kleine lettertypen met zeer hoge kwaliteit worden weergegeven. U kunt deze instelling het best gebruiken bij toepassingen met een grote hoeveelheid kleine tekst. Geavanceerde antialiasing wordt niet aangeraden voor lettertypen groter dan 48 punten. |
Implementatie
public function get antiAliasType():String
public function set antiAliasType(value:String):void
Verwante API-elementen
autoSize | eigenschap |
autoSize:String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Bepaalt de automatische aanpassing van grootte en uitlijning van tekstvelden. Acceptabele waarden voor de constanten TextFieldAutoSize
zijn: TextFieldAutoSize.NONE
(de standaardwaarde), TextFieldAutoSize.LEFT
, TextFieldAutoSize.RIGHT
enTextFieldAutoSize.CENTER
.
Wanneer autoSize
is ingesteld op TextFieldAutoSize.NONE
(standaardwaarde), wordt de grootte niet gewijzigd.
Wanneer autoSize
wordt ingesteld op TextFieldAutoSize.LEFT
, wordt de tekst behandeld als links uitgevulde tekst. Dit betekent dat de linkermarge van het tekstveld een vaste positie heeft en dat een wijziging van de grootte van één regel van het tekstveld invloed heeft op de rechtermarge. Wanneer in het tekstveld een regeleinde is opgenomen (bijvoorbeeld '\n'
of '\r'
), wordt de grootte aan de onderkant ook gewijzigd zodat de volgende regel tekst past. Wanneer wordWrap
ook is ingesteld op true
, wordt alleen de grootte van de onderkant van het tekstveld aangepast en heeft de rechterzijde een vaste positie.
Wanneer autoSize
wordt ingesteld op TextFieldAutoSize.RIGHT
, wordt de tekst behandeld als rechts uitgevulde tekst. Dit betekent dat de rechtermarge van het tekstveld een vaste positie heeft en dat een wijziging van de grootte van één regel van het tekstveld invloed heeft op de linkermarge. Wanneer in het tekstveld een regeleinde is opgenomen (bijvoorbeeld '\n' of '\r'
), wordt de grootte aan de onderkant ook gewijzigd zodat de volgende regel tekst past. Wanneer wordWrap
ook is ingesteld op true
, wordt alleen de grootte van de onderkant van het tekstveld aangepast en heeft de linkerzijde een vaste positie.
Wanneer autoSize
is ingesteld op TextFieldAutoSize.CENTER
, wordt de tekst behandeld als gecentreerd uitgevulde tekst. Dit betekent dat bij een aanpassing van de grootte van één regel van een tekstveld de linker- en rechtermarge in gelijke mate worden aangepast. Wanneer in het tekstveld een regeleinde is opgenomen (bijvoorbeeld '\n'
of '\r'
), wordt de grootte aan de onderkant ook gewijzigd zodat de volgende regel tekst past. Wanneer wordWrap
ook is ingesteld op true
, wordt alleen de grootte van de onderkant van het tekstveld aangepast en hebben de linker- en rechterzijde een vaste positie.
Implementatie
public function get autoSize():String
public function set autoSize(value:String):void
Gegenereerde uitzondering
ArgumentError — De opgegeven autoSize is geen lid van flash.text.TextFieldAutoSize.
|
Verwante API-elementen
background | eigenschap |
background:Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Geeft op of het tekstveld een opvulkleur voor de achtergrond heeft. Indien true
, heeft het tekstveld een opvulkleur voor de achtergrond. Indien false
, heeft het tekstveld geen opvulkleur voor de achtergrond. Gebruik de eigenschap backgroundColor
om de achtergrondkleur van een tekstveld in te stellen.
De standaardwaarde is false.
Implementatie
public function get background():Boolean
public function set background(value:Boolean):void
Verwante API-elementen
backgroundColor | eigenschap |
backgroundColor:uint
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
De kleur van de tekstveldachtergrond. De standaardwaarde is 0xFFFFFF
(wit). Deze eigenschap kan worden opgehaald of ingesteld, zelfs wanneer momenteel geen achtergrond is ingesteld, maar de kleur is alleen zichtbaar wanneer voor het tekstveld de eigenschap background
is ingesteld op true
.
Implementatie
public function get backgroundColor():uint
public function set backgroundColor(value:uint):void
Verwante API-elementen
border | eigenschap |
border:Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Geeft op of het tekstveld een rand heeft. Indien true
, heeft het tekstveld een rand. Indien false
, heeft het tekstveld geen rand. Gebruik de eigenschap borderColor
om de randkleur in te stellen.
De standaardwaarde is false.
Implementatie
public function get border():Boolean
public function set border(value:Boolean):void
Verwante API-elementen
borderColor | eigenschap |
borderColor:uint
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
De kleur van de tekstveldrand. De standaardwaarde is 0x000000
(zwart). Deze eigenschap kan worden opgehaald of ingesteld, zelfs wanneer momenteel geen achtergrond is ingesteld, maar de kleur is alleen zichtbaar wanneer voor het tekstveld de eigenschap border
is ingesteld op true
.
Implementatie
public function get borderColor():uint
public function set borderColor(value:uint):void
Verwante API-elementen
bottomScrollV | eigenschap |
bottomScrollV:int
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Een geheel getal (een op 1 gebaseerde index) dat aangeeft welke regel als onderste regel wordt weergegeven in het opgegeven tekstveld. U kunt een tekstveld zien als een venster met uitzicht op een (gedeelte van een) blok tekst. De eigenschap scrollV
is de op één gebaseerde index van de regel die als bovenste regel wordt weergegeven in het venster.
De tekst tussen de regels die worden aangegeven door scrollV
en bottomScrollV
wordt momenteel weergegeven in het tekstveld.
Implementatie
public function get bottomScrollV():int
Verwante API-elementen
caretIndex | eigenschap |
caretIndex:int
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
De index van de positie van het invoegpunt (invoegteken). Wanneer geen invoegpunt wordt weergegeven, wordt als waarde de positie ingesteld die het invoegpunt inneemt als u de focus weer instelt op het veld (doorgaans de laatste positie van het invoegpunt of 0 als het veld nog geen focus heeft gehad).
Selectiebereikindexen zijn gebaseerd op nul (de eerste positie is bijvoorbeeld 0, de tweede positie 1, enzovoort).
Implementatie
public function get caretIndex():int
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
printCursorPosition
wordt aangeroepen. In dat geval worden de waarden van de eigenschappen caretIndex
, selectionBeginIndex
en selectionEndIndex
uitgevoerd.
Voer dit voorbeeld uit en probeer in het tekstveld te klikken om tekst te selecteren. Klik vervolgens in het veld zonder tekst te selecteren. Wanneer u zonder een selectie te maken in het tekstveld klikt, geeft de eigenschap caretIndex
aan waar het invoegpunt zich bevindt en komen de eigenschappen selectionBeginIndex
en selectionEndIndex
overeen met de waarde van de eigenschap 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 | eigenschap |
condenseWhite:Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Een booleaanse waarde die aangeeft of extra witruimte (spaties, regeleinden, enzovoort) in een tekstveld met HTML-tekst wordt verwijderd. De standaardwaarde is false
. De eigenschap condenseWhite
heeft uitsluitend invloed op tekst die is ingesteld met de eigenschap htmlText
, niet met de eigenschap text
. Wanneer u tekst instelt met de eigenschap text
, wordt condenseWhite
genegeerd.
Als condenseWhite
is ingesteld op true
, moet u standaard-HTML-opdrachten zoals <BR>
en <P>
gebruiken om regeleinden in het tekstveld op te nemen.
Stel de eigenschap condenseWhite
in voordat u de eigenschap htmlText
instelt.
Implementatie
public function get condenseWhite():Boolean
public function set condenseWhite(value:Boolean):void
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
condenseWhite
op false
en op 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 | eigenschap |
defaultTextFormat:flash.text:TextFormat
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Geeft de opmaak op die op nieuw ingevoegde tekst wordt toegepast, zoals tekst die door de gebruiker is ingevoerd of tekst die met de methode replaceSelectedText()
is ingevoegd.
Opmerking: wanneer u met setSelection()
en replaceSelectedText()
de tekens selecteert die u wilt vervangen, wordt de eigenschap defaultTextFormat
alleen toegepast als de tekst is geselecteerd tot en met het laatste teken. Hier volgt een voorbeeld:
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");
Wanneer u de eigenschap defaultTextFormat
benadert, zijn alle eigenschappen van het geretourneerde object TextFormat gedefinieerd. Voor geen enkele eigenschap is de waarde null
ingesteld.
Opmerking: u kunt deze eigenschap niet instellen als er een stijlpagina op het tekstveld wordt toegepast.
Implementatie
public function get defaultTextFormat():flash.text:TextFormat
public function set defaultTextFormat(value:flash.text:TextFormat):void
Gegenereerde uitzondering
Error — Deze methode kan niet worden gebruikt voor een tekstveld met een stijlpagina.
|
Verwante API-elementen
displayAsPassword | eigenschap |
displayAsPassword:Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Geeft aan of het tekstveld een tekstveld voor wachtwoorden is. Wanneer de waarde van deze eigenschap true
is, wordt het tekstveld behandeld als een tekstveld voor wachtwoorden en worden de invoertekens weergegeven als sterretjes om de echte tekens te verbergen. Wanneer de waarde false
is, wordt het tekstveld niet behandeld als een tekstveld voor wachtwoorden. Wanneer de wachtwoordmodus is ingeschakeld, werken de opdrachten Knippen en Kopiëren en de bijbehorende sneltoetsen niet. Met dit beveiligingsmechanisme wordt voorkomen dat een kwaadwillende gebruiker de sneltoetsen gebruikt om achter een wachtwoord te komen op een onbeheerde computer.
De standaardwaarde is false.
Implementatie
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
embedFonts | eigenschap |
embedFonts:Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Geeft op of moet worden gerenderd met ingesloten lettertypecontouren. Indien false
, rendert Flash Player het tekstveld met apparaatlettertypen.
Als u de eigenschap embedFonts
op true
instelt voor een tekstveld, moet u voor die tekst een lettertype opgeven met de eigenschap font
van een object TextFormat dat is toegepast op het tekstveld. Wanneer het opgegeven lettertype niet is opgenomen in het SWF-bestand, wordt de tekst niet weergegeven.
De standaardwaarde is false.
Implementatie
public function get embedFonts():Boolean
public function set embedFonts(value:Boolean):void
Verwante API-elementen
gridFitType | eigenschap |
gridFitType:String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Het type rasteraanpassing dat wordt gebruikt voor dit tekstveld Deze eigenschap is alleen van toepassing wanneer de eigenschap flash.text.AntiAliasType
van het tekstveld op flash.text.AntiAliasType.ADVANCED
is ingesteld.
Het type rasteraanpassing dat wordt gebruikt, bepaalt of in Flash Player krachtige horizontale en verticale lijnen wel of niet passend worden gemaakt op een pixel- of subpixelraster.
U kunt de volgende tekenreekswaarden voor de eigenschap flash.text.GridFitType
gebruiken:
Tekenreekswaarde | Beschrijving |
---|---|
flash.text.GridFitType.NONE | Passend op raster wordt niet toegepast. Horizontale en verticale lijnen in de glyphs worden niet gedwongen passend gemaakt op het pixelraster. Deze instelling wordt aanbevolen voor animaties en grote lettertypen. |
flash.text.GridFitType.PIXEL | Krachtige horizontale en verticale lijnen worden passend gemaakt op het pixelraster. Deze instelling werkt alleen voor tekstvelden met linkse uitlijning. Wanneer u deze instelling wilt gebruiken, moet de eigenschap flash.display.AntiAliasType van het tekstveld op flash.text.AntiAliasType.ADVANCED worden ingesteld. Deze instelling resulteert doorgaans in de beste leesbaarheid voor links uitgelijnde tekst. |
flash.text.GridFitType.SUBPIXEL | Krachtige horizontale en verticale lijnen worden passend gemaakt op het subpixelraster van een LCD-scherm. Wanneer u deze instelling wilt gebruiken, moet de eigenschap flash.text.AntiAliasType van het tekstveld op flash.text.AntiAliasType.ADVANCED worden ingesteld. De instelling flash.text.GridFitType.SUBPIXEL is meestal geschikt voor rechts uitgelijnde en gecentreerde dynamische tekst en kan helpen bij de keuze tussen animatie- en tekstkwaliteit. |
De standaardwaarde is pixel.
Implementatie
public function get gridFitType():String
public function set gridFitType(value:String):void
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
gridFitType
. Wanneer u dit voorbeeld gebruikt, let u dan op het verschil in leesbaarheid tussen de eerste twee regels. Let ook op het optimale gebruik van GridFitType.PIXEL
voor links uitgevulde tekst en GridFitType.SUBPIXEL
voor rechts uitgevulde tekst.
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 | eigenschap |
htmlText:String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Bevat de HTML-representatie van de inhoud van het tekstveld.
Flash Player ondersteunt de volgende HTML-tags:
Tag | Beschrijving |
---|---|
Tag voor anker |
De tag <a> maakt een hyperlink en ondersteunt de volgende kenmerken:
|
Tag voor vette tekst |
Met de tag <b> wordt tekst vet weergegeven. Er moet wel een vet lettertype beschikbaar zijn voor de weergave van de tekst.
|
Tag voor regeleinde |
De tag <br> voegt een regeleinde in het tekstveld in. Stel het tekstveld in op een tekstveld met meerdere regels om deze tag te gebruiken.
|
Tag voor lettertype |
De tag <font> geeft een lettertype of lijst met lettertypen op voor weergave van de tekst. De tag font ondersteunt de volgende kenmerken:
|
Tag voor afbeelding |
Met de tag <img> kunt u externe afbeeldingsbestanden (JPEG, GIF, PNG), SWF-bestanden en filmclips in tekstvelden insluiten. Tekst wordt automatisch rond ingesloten afbeeldingen in tekstvelden weergegeven. U moet het tekstveld instellen op een tekstveld met meerdere regels zodat tekst om een afbeelding heen loopt.
De tag
In Flash worden ingesloten media in een tekstveld op volledige grootte weergegeven. Wanneer u de afmetingen wilt opgeven van de media die u insluit, gebruikt u de kenmerken Over het algemeen wordt een ingesloten afbeelding weergegeven in een tekstveld op de regel na de tag Voor AIR-inhoud in de beveiligingssandbox van de toepassing, negeert AIR |
Tag voor cursieve tekst |
Met de tag <i> wordt de tekst tussen tags cursief weergegeven. Er moet wel een cursief lettertype beschikbaar zijn voor de weergave van de tekst.
|
Tag voor lijstitem |
Met de tag <li> wordt een opsommingsteken voorafgaand aan de aangeduide tekst geplaatst. Opmerking: omdat tags voor gesorteerde en niet-gesorteerde lijsten (<ol> en <ul> ) niet worden herkend in Flash Player en AIR, hebben deze geen invloed op de wijze waarop uw lijst wordt weergegeven. Alle lijsten zijn niet-gesorteerd en alle lijstitems gebruiken opsommingstekens.
|
Tag voor alinea |
De tag <p> voegt een nieuwe alinea in. U kunt deze tag alleen gebruiken als het tekstveld is ingesteld op een tekstveld met meerdere regels. De tag <p> ondersteunt de volgende kenmerken:
|
Tag voor bereik |
De tag <span> is alleen beschikbaar voor gebruik met CSS-tekststijlen. De tag ondersteunt het volgende kenmerk:
|
Tag voor tekstopmaak |
Met de tag De tag
|
Tag voor onderstreping |
Met de tag <u> wordt de tekst tussen tags onderstreept weergegeven.
|
Flash Player en AIR ondersteunen de volgende HTML-entiteiten:
Entiteit | Beschrijving |
---|---|
< | < (kleiner dan) |
> | > (groter dan) |
& | & (en-teken) |
" | " (dubbele aanhalingstekens) |
' | ' (apostrof, enkel aanhalingsteken) |
Flash Player en AIR ondersteunen tevens expliciete tekencodes, zoals & (ASCII-ampersand) en € (€-teken Unicode).
Implementatie
public function get htmlText():String
public function set htmlText(value:String):void
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
tf1
gemaakt en wordt een tekenreeks met HTML-opmaak toegewezen aan de eigenschap text
. Wanneer de eigenschap htmlText
wordt getraceerd, is de uitvoer de tekenreeks met HTML-opmaak, waarbij extra tags (zoals <P> en <FONT>) automatisch zijn toegevoegd door Flash Player. Wanneer de waarde van text
wordt getraceerd, wordt de niet-opgemaakte tekenreeks zonder HTML-tags weergegeven.
Ter vergelijking worden dezelfde stappen ook uitgevoerd op een ander object TextField met de naam tf2
. In dit geval wordt echter een object StyleSheet toegewezen aan de eigenschap styleSheet
van tf2
voordat de eigenschap htmlText
wordt ingesteld. Wanneer in dit geval de eigenschap htmlText
wordt getraceerd, bevat deze alleen de exacte HTML-tekst die oorspronkelijk was toegewezen aan de eigenschap htmlText
en zijn geen extra tags toegevoegd door 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 | eigenschap |
maxChars | eigenschap |
maxChars:int
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Het maximum aantal tekens dat het tekstveld kan bevatten (ingevoerd door de gebruiker). Een script kan meer tekst invoegen dan maxChars
toestaat. Met de eigenschap maxChars
wordt slechts aangegeven hoeveel tekst een gebruiker kan invoeren. Wanneer de waarde van deze eigenschap 0
is, kan een gebruiker een onbeperkte hoeveelheid tekst invoeren.
De standaardwaarde is 0.
Implementatie
public function get maxChars():int
public function set maxChars(value:int):void
maxScrollH | eigenschap |
maxScrollV | eigenschap |
mouseWheelEnabled | eigenschap |
mouseWheelEnabled:Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Een booleaanse waarde die aangeeft of Flash Player automatisch door tekstvelden met meerdere regels schuift wanneer de gebruiker op een tekstveld klikt en het muiswiel gebruikt. Deze waarde is standaard ingesteld op true
. Deze eigenschap is nuttig wanneer u wilt voorkomen dat met het muiswiel door tekstvelden wordt geschoven of u uw eigen schuifmethode voor tekstvelden wilt implementeren.
Implementatie
public function get mouseWheelEnabled():Boolean
public function set mouseWheelEnabled(value:Boolean):void
multiline | eigenschap |
multiline:Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Hiermee wordt aangegeven of het veld een tekstveld met meerdere regels is. Wanneer de waarde true
is, bevat het tekstveld meerdere regels. Wanneer de waarde false
is, bevat het tekstveld slechts één regel. In een veld van het type TextFieldType.INPUT
bepaalt de waarde multiline
of met de toets Enter
een nieuwe regel kan worden gemaakt (wanneer de waarde false
is, wordt de toets Enter
genegeerd). Als u tekst plakt in een TextField
waarvan de waarde multiline
is ingesteld op false
, worden nieuwe regels uit de tekst verwijderd.
De standaardwaarde is false.
Implementatie
public function get multiline():Boolean
public function set multiline(value:Boolean):void
Verwante API-elementen
numLines | eigenschap |
numLines:int
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Definieert het aantal tekstregels in een tekstveld met meerdere regels. Wanneer de eigenschap wordWrap
op true
is ingesteld, neemt het aantal regels toe bij tekstomloop.
Implementatie
public function get numLines():int
Verwante API-elementen
restrict | eigenschap |
restrict:String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Geeft de set tekens aan die een gebruiker in het tekstveld kan invoeren. Wanneer de waarde van de eigenschap restrict
null
is, kunt u een willekeurig teken invoeren. Wanneer de waarde van de eigenschap restrict
een lege tekenreeks is, kunt u geen willekeurig teken invoeren. Wanneer de waarde van de eigenschap restrict
een reeks tekens is, kunt u alleen tekens in die reeks in het tekstveld invoeren. De tekenreeks wordt van links naar rechts gescand. U kunt een bereik opgeven met het koppelteken (-). Alleen gebruikersinteractie is beperkt; een script kan alle mogelijke tekst in het tekstveld plaatsen. Deze eigenschap synchroniseert niet met de opties voor het insluiten van lettertypen in Eigenschapcontrole.
Wanneer de tekenreeks begint met een invoegteken (^), worden alle tekens eerst geaccepteerd, maar worden de tekens na het invoegteken in de tekenreeks uitgesloten van de set met geaccepteerde tekens. Wanneer de tekenreeks niet begint met een invoegteken (^), worden eerst geen tekens geaccepteerd, maar worden alle tekens in de tekenreeks opgenomen in de set met geaccepteerde tekens.
In het volgende voorbeeld kunnen alleen hoofdletters, spaties en getallen worden ingevoerd in een tekstveld:
my_txt.restrict = "A-Z 0-9";
In het volgende voorbeeld worden alle tekens opgenomen, maar worden twee kleine letters uitgesloten:
my_txt.restrict = "^a-z";
U kunt een backslash gebruiken om de letterlijke tekens ^ of - op te geven. De geaccepteerde backslash-reeksen zijn \-, \^ en \\. De backslash moet een echt teken in de tekenreeks zijn. In ActionScript-code moet dus een dubbele backslash worden gebruikt. De volgende code bevat bijvoorbeeld alleen het streepje (-) en invoegpunt (^):
my_txt.restrict = "\\-\\^";
Het invoegpunt ^ kan overal in de tekenreeks worden gebruikt om te schakelen tussen het opnemen en uitsluiten van tekens. Met de volgende code worden alleen hoofdletters opgenomen, maar wordt de hoofdletter Q uitgesloten:
my_txt.restrict = "A-Z^Q";
Met de escape-reeks \u
kunt u restrict
-tekenreeksen maken. Met de volgende code worden alleen tekens vanaf ASCII 32 (spatie) tot ASCII 126 (tilde) opgenomen.
my_txt.restrict = "\u0020-\u007E";
De standaardwaarde is null.
Implementatie
public function get restrict():String
public function set restrict(value:String):void
scrollH | eigenschap |
scrollH:int
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
De huidige horizontale schuifpositie. Wanneer de eigenschap scrollH
is ingesteld op 0, wordt de tekst niet horizontaal geschoven. Deze eigenschapwaarde is een geheel getal dat de horizontale positie in pixels vertegenwoordigt.
Horizontaal schuiven wordt uitgedrukt in pixels, verticaal schuiven in regels. Horizontaal schuiven wordt in pixels gemeten omdat de meeste lettertypen die u doorgaans gebruikt proportioneel gespatieerd zijn. Dit betekent dat de tekens verschillende breedten kunnen hebben. In Flash Player wordt verticaal schuiven in regels gemeten omdat gebruikers doorgaans een tekstregel in zijn geheel willen zien. Zelfs wanneer een regel meerdere lettertypen bevat, wordt de hoogte van de regel aangepast aan het grootste lettertype.
Opmerking: de eigenschap scrollH
is op nul gebaseerd, niet op één zoals de eigenschap scrollV
voor verticaal schuiven.
Implementatie
public function get scrollH():int
public function set scrollH(value:int):void
Verwante API-elementen
scrollV | eigenschap |
scrollV:int
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
De verticale positie van tekst in een tekstveld. De eigenschap scrollV
is nuttig om gebruikers naar een bepaalde alinea in een lange passage te leiden of tekstvelden te maken waarin kan worden geschoven.
Verticaal schuiven wordt uitgedrukt in regels, horizontaal schuiven in pixels. Wanneer de eerste regel die wordt weergegeven ook de eerste regel in het tekstveld is, is scrollV ingesteld op 1 (niet op 0). Horizontaal schuiven wordt in pixels gemeten omdat de meeste lettertypen proportioneel gespatieerd zijn. Dit betekent dat de tekens verschillende breedten kunnen hebben. In Flash wordt verticaal schuiven in regels gemeten omdat gebruikers doorgaans een tekstregel in zijn geheel willen zien. Zelfs wanneer een regel meerdere lettertypen bevat, wordt de hoogte van de regel aangepast aan het grootste lettertype.
Implementatie
public function get scrollV():int
public function set scrollV(value:int):void
Verwante API-elementen
selectable | eigenschap |
selectable:Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Een booleaanse waarde die aangeeft of het tekstveld kan worden geselecteerd. De waarde true
geeft aan dat de tekst kan worden geselecteerd. Met de eigenschap selectable
wordt bepaald of een tekstveld kan worden geselecteerd, niet of een tekstveld kan worden bewerkt. Een dynamisch tekstveld kan ook selecteerbaar zijn wanneer het niet bewerkbaar is. Wanneer een dynamisch tekstveld niet selecteerbaar is, kan de gebruiker de tekst niet selecteren.
Wanneer selectable
is ingesteld op false
, reageert de tekst in het tekstveld niet op selectieopdrachten van de muis of het toetsenbord en kan de tekst niet worden gekopieerd met de opdracht Kopiëren. Wanneer selectable
is ingesteld op true
, kan de tekst in het tekstveld worden geselecteerd met de muis of het toetsenbord en kan de tekst worden gekopieerd met de opdracht Kopiëren. U kunt tekst ook op deze manier selecteren als het tekstveld een dynamisch tekstveld is in plaats van een invoertekstveld.
De standaardwaarde is true.
Implementatie
public function get selectable():Boolean
public function set selectable(value:Boolean):void
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
selectable
ingesteld op true
en het andere tekstveld met de eigenschap selectable
ingesteld op false
. Wanneer u dit voorbeeld gebruikt, probeert u dan de tekst in deze velden te selecteren met de muis of het toetsenbord.
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 | eigenschap |
selectionBeginIndex:int
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
De op nul gebaseerde indexwaarde van het eerste teken in de huidige selectie. Het eerste teken is bijvoorbeeld 0, het tweede teken 1, enzovoort. Wanneer geen tekst wordt geselecteerd, heeft deze eigenschap de waarde caretIndex
.
Implementatie
public function get selectionBeginIndex():int
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
printCursorPosition
wordt aangeroepen. In dat geval worden de waarden van de eigenschappen caretIndex
, selectionBeginIndex
en selectionEndIndex
uitgevoerd.
Voer dit voorbeeld uit en probeer in het tekstveld te klikken om tekst te selecteren. Klik vervolgens in het veld zonder tekst te selecteren. Wanneer u zonder een selectie te maken in het tekstveld klikt, geeft de eigenschap caretIndex
aan waar het invoegpunt zich bevindt en komen de eigenschappen selectionBeginIndex
en selectionEndIndex
overeen met de waarde van de eigenschap 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 | eigenschap |
selectionEndIndex:int
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
De op nul gebaseerde indexwaarde van het laatste teken in de huidige selectie. Het eerste teken is bijvoorbeeld 0, het tweede teken 1, enzovoort. Wanneer geen tekst wordt geselecteerd, heeft deze eigenschap de waarde caretIndex
.
Implementatie
public function get selectionEndIndex():int
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
printCursorPosition
wordt aangeroepen. In dat geval worden de waarden van de eigenschappen caretIndex
, selectionBeginIndex
en selectionEndIndex
uitgevoerd.
Voer dit voorbeeld uit en probeer in het tekstveld te klikken om tekst te selecteren. Klik vervolgens in het veld zonder tekst te selecteren. Wanneer u zonder een selectie te maken in het tekstveld klikt, geeft de eigenschap caretIndex
aan waar het invoegpunt zich bevindt en komen de eigenschappen selectionBeginIndex
en selectionEndIndex
overeen met de waarde van de eigenschap 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 | eigenschap |
sharpness:Number
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
De scherpte van de glyph-randen in dit tekstveld. Deze eigenschap is alleen van toepassing wanneer de eigenschap flash.text.AntiAliasType
van het tekstveld op flash.text.AntiAliasType.ADVANCED
is ingesteld. Het bereik voor sharpness
is een getal tussen -400 en 400. Wanneer u sharpness
probeert in te stellen op een waarde buiten dat bereik, wordt voor de eigenschap de dichtstbijzijnde waarde in het bereik ingesteld (-400 of 400).
De standaardwaarde is 0.
Implementatie
public function get sharpness():Number
public function set sharpness(value:Number):void
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
sharpness
voor een TextField-object. U moet het lettertype insluiten en de eigenschap antiAliasType
instellen op 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 | eigenschap |
styleSheet:StyleSheet
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Koppelt een stijlpagina aan het tekstveld. Zie de StyleSheet-klasse en de Adobe ActionScript 3.0-ontwikkelaarsgids voor informatie over het maken van stijlpagina's.
U kunt de stijlpagina die aan tekstveld is gekoppeld op elk moment wijzigen. Wanneer u de stijlpagina in gebruik wijzigt, wordt het tekstveld opnieuw getekend met de nieuwe stijlpagina. U kunt de stijlpagina op null
of undefined
instellen om de stijlpagina te verwijderen. Wanneer de stijlpagina in gebruik is verwijderd, wordt het tekstveld opnieuw getekend zonder een stijlpagina.
Opmerking: wanneer de stijlpagina wordt verwijderd, wordt de inhoud van zowel TextField.text
als TextField.htmlText
gewijzigd om de opmaak op te nemen die eerder door de stijlpagina is toegepast. Wanneer u de oorspronkelijke inhoud TextField.htmlText
zonder de opmaak wilt behouden, slaat u de waarde in een variabele op voordat u de stijlpagina verwijdert.
Implementatie
public function get styleSheet():StyleSheet
public function set styleSheet(value:StyleSheet):void
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
stylesheet
in voordat u de inhoud instelt.
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 | eigenschap |
text:String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Een tekenreeks die de huidige tekst in het tekstveld is. Regels worden gescheiden door het Enter-teken ('\r'
, ASCII 13). Deze eigenschap bevat niet-opgemaakte tekst in het tekstveld, zonder HTML-tags
Wanneer u de tekst in HTML-notatie wilt weergeven, gebruikt u de eigenschap htmlText
.
Opmerking: Als een stijlpagina wordt toegepast op het tekstveld, wordt de inhoud van de eigenschap text
geïnterpreteerd als HTML.
Implementatie
public function get text():String
public function set text(value:String):void
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
tf1
gemaakt en wordt een tekenreeks met HTML-opmaak toegewezen aan de eigenschap text
. Wanneer de eigenschap htmlText
wordt getraceerd, is de uitvoer de tekenreeks met HTML-opmaak, waarbij extra tags (zoals <P> en <FONT>) automatisch zijn toegevoegd door Flash Player. Wanneer de waarde van text
wordt getraceerd, wordt de niet-opgemaakte tekenreeks zonder HTML-tags weergegeven.
Ter vergelijking worden dezelfde stappen ook uitgevoerd op een ander object TextField met de naam tf2
. In dit geval wordt echter een object StyleSheet toegewezen aan de eigenschap styleSheet
van tf2
voordat de eigenschap htmlText
wordt ingesteld. Wanneer in dit geval de eigenschap htmlText
wordt getraceerd, bevat deze alleen de exacte HTML-tekst die oorspronkelijk was toegewezen aan de eigenschap htmlText
en zijn geen extra tags toegevoegd door 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 | eigenschap |
textColor:uint
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
De kleur van de tekst in een tekstveld, in hexadecimale notatie. In het hexadecimale kleurensysteem worden zes cijfers gebruikt voor kleurwaarden. Elk cijfer heeft 16 mogelijke waarden of tekens. Als tekens kunt u 0 tot en met -9 en A-F gebruiken. Zwart is bijvoorbeeld 0x000000
, wit is 0xFFFFFF
.
De standaardwaarde is 0 (0x000000).
Implementatie
public function get textColor():uint
public function set textColor(value:uint):void
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
textColor
ervan gewijzigd in rood (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 | eigenschap |
textHeight:Number
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
De hoogte van de tekst in pixels.
Implementatie
public function get textHeight():Number
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
trace
geeft de waarden van de eigenschappen textWidth
en textHeight
weer. Ter vergelijking worden tevens de eigenschappen width
en height
weergegeven. (De waarden voor textHeight
en textWidth
kunnen variëren, afhankelijk van het lettertype dat op uw computer wordt gebruikt).
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 | eigenschap |
textInteractionMode:String
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 11, Flash Lite 4 |
De eigenschap van de interactiemodus. De standaardwaarde is TextInteractionMode.NORMAL. Op mobiele platformen impliceert de normale modus dat er door de tekst kan worden geschoven, maar dat de tekst niet kan worden geselecteerd. Via het ingebouwde contextmenu in het tekstveld kan worden geschakeld naar de selectiemodus. Op bureaubladsystemen impliceert de normale modus dat er door de tekst kan worden geschoven en dat de tekst ook kan worden geselecteerd.
Implementatie
public function get textInteractionMode():String
textWidth | eigenschap |
textWidth:Number
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
De breedte van de tekst in pixels.
Implementatie
public function get textWidth():Number
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
trace
geeft de waarden van de eigenschappen textWidth
en textHeight
weer. Ter vergelijking worden tevens de eigenschappen width
en height
weergegeven. (De waarden voor textHeight
en textWidth
kunnen variëren, afhankelijk van het lettertype dat op uw computer wordt gebruikt).
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 | eigenschap |
thickness:Number
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
De dikte van de glyph-randen in dit tekstveld. Deze eigenschap wordt alleen toegepast wanneer flash.text.AntiAliasType
op flash.text.AntiAliasType.ADVANCED
is ingesteld.
Het bereik voor thickness
is een getal tussen -200 en 200. Wanneer u thickness
probeert in te stellen op een waarde buiten dat bereik, wordt voor de eigenschap de dichtstbijzijnde waarde in het bereik ingesteld (-200 of 200).
De standaardwaarde is 0.
Implementatie
public function get thickness():Number
public function set thickness(value:Number):void
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
thickness
voor een TextField-object. U moet het lettertype insluiten en de eigenschap antiAliasType
instellen op 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 | eigenschap |
type:String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Het type tekstveld. Een van de volgende TextFieldType-constanten: TextFieldType.DYNAMIC
, die een dynamisch tekstveld opgeeft dat niet kan worden bewerkt door een gebruiker, of TextFieldType.INPUT
, dat een invoertekstveld opgeeft dat wel kan worden bewerkt door een gebruiker.
De standaardwaarde is dynamic.
Implementatie
public function get type():String
public function set type(value:String):void
Gegenereerde uitzondering
ArgumentError — Het opgegeven type is geen lid van flash.text.TextFieldType.
|
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
tfDynamic
entfInput
. In beide tekstvelden wordt tekst ingevoerd. Voor tfDynamic
is de eigenschap type
echter op TextFieldType.DYNAMIC
ingesteld en voor tfInput
is de eigenschap type
op TextFieldType.INPUT
ingesteld, zodat de gebruiker de tekst in tfInput
kan wijzigen maar de tekst in tfDynamic
alleen kan bekijken.
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 | eigenschap |
useRichTextClipboard:Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Geeft aan of de tekstopmaak samen met de tekst moet worden gekopieerd en geplakt. Indien true
wordt opmaak (zoals uitlijning en vette en cursieve tekst) in Flash Player ook gekopieerd en geplakt wanneer u kopieert en plakt tussen tekstvelden. Voor de procedure voor kopiëren en plakken moet zowel voor het oorspronkelijke tekstveld als voor het tekstveld van bestemming useRichTextClipboard
op true
worden ingesteld. De standaardwaarde is false
.
Implementatie
public function get useRichTextClipboard():Boolean
public function set useRichTextClipboard(value:Boolean):void
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
tf1
) en twee dynamische tekstvelden (tf2
en tf3
) gemaakt. Aan elk dynamisch tekstveld wordt door de code een TextFormat-object (lettertype Courier Bold) toegewezen. Voor het tekstveld tf2
is de eigenschap useRichTextClipboard
ingesteld op false
. Voor het tekstveld tf3
is de eigenschap useRichTextClipboard
ingesteld op true
. Wanneer u de tekst uit tekstveld tf2
kopieert en in tekstveld tf1
plakt, is de geplakte tekst niet opgemaakt. Wanneer u de tekst uit tekstveld tf3
kopieert (waarvoor useRichTextClipboard
is ingesteld op true
) en deze in tekstveld tf1
plakt, is de geplakte tekst wel opgemaakt.
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 | eigenschap |
wordWrap:Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Een booleaanse waarde die aangeeft of voor het tekstveld tekstomloop is ingesteld. Wanneer de waarde van wordWrap
true
is, heeft het tekstveld tekstomloop. Wanneer de waarde false
is, heeft het veld geen tekstomloop. De standaardwaarde is false
.
Implementatie
public function get wordWrap():Boolean
public function set wordWrap(value:Boolean):void
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
wordWrap
op true
en het instellen ervan op false
: Er worden twee instanties TextField gemaakt met inhoud die te groot is voor de breedte. De eigenschap wordWrap
van de eerste instantie (tfWrap
genoemd) is op true
ingesteld. Voor de tweede instantie (tfNoWrap
) wordt deze eigenschap op false
ingesteld.
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 | () | Constructor |
public function TextField()
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Maakt een nieuwe instantie TextField. Wanneer u een object Bitmap hebt gemaakt, roept u de methode addChild()
of addChildAt()
aan van het bovenliggende object DisplayObjectContainer om de instantie TextField in het weergaveoverzicht op te nemen.
De standaardgrootte voor een tekstveld is 100 x 100 pixels.
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
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 | () | methode |
public function appendText(newText:String):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Voegt de tekenreeks die is opgegeven met de parameter newText
toe aan het einde van de tekst in het tekstveld. Deze methode is efficiënter dan het toewijzen van (+=
) aan een eigenschap text
(bijvoorbeeld someTextField.text += moreText
), met name wanneer een tekstveld een aanzienlijke hoeveelheid inhoud bevat.
Parameters
newText:String — De tekenreeks die moet worden toegevoegd aan de bestaande tekst.
|
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
De grootte van het tekstveld outputText
wordt automatisch gewijzigd zodat de tekst erin past en de tekst wordt ingesteld op links uitvullen met de eigenschap autoSize
. De eigenschap outputText.text
schrijft de eerste regel van de inhoud en de methode appendText()
voegt de rest van de inhoud toe. (U hoeft niet te beginnen met de eigenschap text
. De methode appendText()
kan ook worden gebruikt om tekst vanaf het begin toe te voegen.) Wanneer u de eigenschap text
nogmaals instelt, wordt de oorspronkelijke tekst overschreven. Gebruik de operator voor optellen en toewijzen (+=
) om inhoud toe te voegen met de eigenschap text
.
De instructie if
controleert of de datum zaterdag (6) of zondag (0) is. Wanneer dit niet het geval is, retourneert de methode toLocaleTimeString()
de lokale tijd, die aan de inhoud van het tekstveld wordt toegevoegd.
De eigenschap length
van het tekstveld wordt gebruikt om het aantal tekens te lezen net voordat de functie wordt aangeroepen. De eigenschap numLines
wordt gebruikt om het aantal regels in het tekstveld te tellen. De lege regels worden meegenomen in het aantal regels en de lege spaties en regeleinden (\n) worden meegenomen bij het bepalen van de lengte van de inhoud.
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 | () | methode |
public function getCharBoundaries(charIndex:int):Rectangle
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retourneert een rechthoek die het selectiekader van het teken vormt.
Parameters
charIndex:int — De op nul gebaseerde indexwaarde voor het teken (de eerste positie is bijvoorbeeld 0, de tweede positie 1, enzovoort).
|
Rectangle — Een rechthoek met minimum- en maximumwaarden voor x en y die het selectiekader van het teken definiëren.
|
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
getCharBoundaries()
gebruikt om een teken te markeren (er een spotlight op te zetten) dat door de gebruiker is geselecteerd.
De klasse definieert het Shape-object spotlight
dat wordt gebruikt om een rechthoek te tekenen rondom elk teken dat is geselecteerd. Wanneer de gebruiker op het tekstveld myTextField
klikt, wordt de methode clickHandler()
aangeroepen.
Bij de methode clickHandler()
haalt de methode getCharIndexAtPoint()
de index op van het teken waarop is geklikt op basis van de coördinaten localX
en localY
van de muisklik, die relatief is ten opzichte van de bevattende Sprite
. De methode getCharIndexAtPoint()
retourneert -1
wanneer het punt (de muisklik) zich niet op een teken bevond. Aangezien het tekstveld groter kan zijn dan de tekst, wordt het geretourneerde gehele getal (index
) gecontroleerd om er zeker van te zijn dat de gebruiker op een teken heeft geklikt. Het gehele getal index
wordt ook gebruikt doorgetCharBoundaries()
om een object Rectangle
op te halen dat de grens van het teken bevat. De methode clear()
wist een eventueel eerder weergegeven Shape-object spotlight
. Op de locatie van het teken (verschoven van de coördinaten (10, 10)) wordt een nieuwe rechthoek gemaakt ter grootte van de breedte- en hoogtegrenzen van het teken met behulp van het geretourneerde frame
op de x- en y-coördinaten van de rechthoek. Om het spotlight op het teken te zetten, wordt het Shape-object spotlight
gevuld met een gele kleur en wordt de dekking op 35 procent ingesteld, zodat het teken zichtbaar is. Spaties worden ook als een teken beschouwd.
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 | () | methode |
public function getCharIndexAtPoint(x:Number, y:Number):int
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retourneert de op nul gebaseerde indexwaarde van het teken op het punt dat is opgegeven met de parameters x
en y
.
Parameters
x:Number — De x-coördinaat van het teken.
| |
y:Number — De y-coördinaat van het teken.
|
int — De op nul gebaseerde indexwaarde van het teken (de eerste positie is bijvoorbeeld 0, de tweede positie 1, enzovoort). Retourneert -1 wanneer het punt zich niet op een teken bevindt.
|
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
Het eerste tekstveld bevat de tekst die de gebruiker zal selecteren. Om te zorgen dat op de tekst wordt geklikt maar deze niet wordt geselecteerd, wordt de eigenschap selectable
op false ingesteld. Wanneer de gebruiker op het tekstveld firstTextField
klikt, wordt de methode clickHandler()
aangeroepen.
Bij de methode clickHandler()
retourneert de methode getCharIndexAtPoint()
de index van het teken op basis van de coördinaten localX
en localY
van de muisklik. Aangezien het tekstveld groter kan zijn dan de tekst, wordt het geretourneerde gehele getal (index
) gecontroleerd om er zeker van te zijn dat de gebruiker op een teken heeft geklikt. (De methode getCharIndexAtPoint()
retourneert -1
wanneer het punt (de muisklik) zich niet op een teken bevond.) De muiscoördinaten worden gebruikt om de coördinaten van het nieuwe tekstveld in te stellen waar het gekopieerde teken wordt geplaatst. De kleur van het teken in het tweede tekstveld wordt op rood ingesteld. Ten slotte wordt de tekst in het tweede veld op het geselecteerde teken ingesteld, dat met de methode charAt()
wordt opgehaald. Wanneer de eigenschap text
wordt gebruikt in plaats van de methode appendText()
, wordt het teken in het tweede tekstveld overschreven, niet toegevoegd.
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 | () | methode |
public function getFirstCharInParagraph(charIndex:int):int
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Op basis van een tekenindex wordt hiermee de index van het eerste teken in dezelfde alinea geretourneerd.
Parameters
charIndex:int — De op nul gebaseerde indexwaarde van het teken (het eerste teken is bijvoorbeeld 0, het tweede teken 1, enzovoort).
|
int — De op nul gebaseerde indexwaarde van het eerste teken in dezelfde alinea.
|
Gegenereerde uitzondering
RangeError — De opgegeven tekenindex bevindt zich buiten het bereik.
|
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
In de constructor wordt het tekstveld myTextField
ingesteld op tekstomloop. De methode getTextFormat
retourneert de oorspronkelijke opmaak van het eerste teken van de inhoud van het tekstveld, dat in het TextFormat-object originalFormat
wordt geplaatst. Er wordt ook een nieuw TextFormat-object (newFormat
) gedefinieerd en de eigenschap align
ervan wordt toegewezen aan rechts uitvullen. Wanneer de gebruiker op het tekstveld klikt, wordt de methode clickHandler()
aangeroepen.
Bij de methode clickHandler()
retourneert de methode getCharIndexAtPoint()
de index van het teken op basis van de coördinaten localX
en localY
van de muisklik. De eerste instructie if
controleert of de gebruiker op een teken heeft geklikt. Met het gehele getal clickIndex
dat door de methode getCharIndexAtPoint()
is geretourneerd, retourneert de methode getFirstCharInParagraph()
de index van het eerste teken in de alinea waarop de gebruiker heeft geklikt. De index van het laatste teken in de alinea wordt bepaald door de lengte van de alinea (met de methode getParagraphLength()
) toe te voegen aan de index van het eerste teken in de alinea, min het laatste teken (\n
). De tweede instructie if
controleert de opmaak van het eerste teken in de alinea. Wanneer de uitlijningswaarde gelijk is aan die van de oorspronkelijke opmaak (links uitvullen), wordt de nieuwe opmaak toegepast op alle tekens in de alinea. Anders wordt de opmaak van de alinea teruggezet naar de oorspronkelijke opmaak. Uitlijning, samen met opmaak zoals inspringen, opsommingsteken, tabstop, linker- en rechtermarge, zijn opmaakvormen voor alinea's. Zodra tekstomloop of regeleinde wordt gebruikt, is de opmaak alleen van toepassing op de eerste regel van de alinea wanneer het argument endIndex
niet is gedefinieerd voor de methode 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 | () | methode |
public function getImageReference(id:String):DisplayObject
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retourneert een referentie DisplayObject voor de opgegeven id
voor een afbeeldings- of SWF-bestand dat aan een tekstveld met HTML-opmaak is toegevoegd met een tag <img>
. De tag <img>
heeft de volgende indeling:
<img src = 'filename.jpg' id = 'instanceName' >
Parameters
id:String — De id die moet overeenkomen (in het kenmerk id van de tag <img> ).
|
DisplayObject — Het weergaveobject dat overeenkomt met het afbeeldings- of SWF-bestand met het overeenkomende kenmerk id in de tag <img> van het tekstveld. Voor media die worden geladen vanaf een externe bron, is dit object een object Loader; na het laden is het mediaobject een onderliggend object van dat object Loader. Voor media die zijn ingesloten in het SWF-bestand is dit het geladen object. Als er geen tag <img> met de overeenkomendeid bestaat, retourneert de methode null .
|
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
De afbeelding image.jpg
) wordt via de HTML opgenomen. (Hier wordt aangenomen dat een afbeeldingsbestand zich in dezelfde map bevindt als het SWF-bestand.) Er moet een kenmerk id
worden gedefinieerd voor de tag img
om de afbeelding te kunnen benaderen met behulp van de methode getImageReference()
. De eigenschap htmlText
wordt gebruikt om tekenreeksinhoud met HTML-opmaak op te nemen. Wanneer de gebruiker op het tekstveld myTextField
klikt, wordt de methode clickHandler()
aangeroepen.
Bij de methode clickHandler()
retourneert de methode getImageReference()
een verwijzing naar de afbeelding als een DisplayObject
. Deze verwijzing kan worden gebruikt om de afbeelding te manipuleren, net als elk object DisplayObject
. Hier worden de eigenschappen alpha
(transparantie) en rotation
ingesteld. De eigenschap transform
kan ook worden gebruik om de matrix, de kleurentransformatie en de pixelbeperkingen van het weergaveobject te benaderen. flash.display.DisplayObject
moet worden geïmporteerd.
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 | () | methode |
public function getLineIndexAtPoint(x:Number, y:Number):int
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retourneert de op nul gebaseerde indexwaarde van de regel op het punt dat is opgegeven met de parameters x
en y
.
Parameters
x:Number — De x-coördinaat van de regel.
| |
y:Number — De y-coördinaat van de regel.
|
int — De op nul gebaseerde indexwaarde van de regel (de eerste regel is bijvoorbeeld 0, de tweede regel 1, enzovoort). Retourneert -1 wanneer het punt zich niet op een regel bevindt.
|
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
In de constructor wordt het tekstveld poem
ingesteld op geen tekstomloop (aangezien het een gedicht is). De eigenschap autoSize
wordt ook gebruikt om de tekst in te stellen op automatische grootte en links uitvullen. Het tekstveld poemCopy
wordt onder het tekstveld poem
geplaatst. Wanneer de gebruiker op een regel in het gedicht klikt, wordt de methode clickHandler()
aangeroepen.
Bij de methode clickHandler()
retourneert de methode getLineIndexAtPoint()
de index van de regel waarop de gebruiker heeft geklikt op basis van de coördinaten localX
en localY
van de muisklik. (Aangezien het oorspronkelijke gedicht hier in het formaat van het tekstveld past, is het niet nodig te controleren op buiten-bereikfouten (RangeError
), gegenereerd door de methodegetCharIndexAtPoint()
.) De index van de regel wordt vervolgens gebruikt om de inhoud van de regel met de methode getLineText()
op te halen als een tekenreeks, waarna deze aan de inhoud van het tekstveld poemCopy
wordt toegevoegd. Het kopiëren kan eindeloos doorgaan, maar op een gegeven moment zal de tekst zich buiten het bereik van het zichtbare tekstveld poemCopy
bevinden
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 | () | methode |
public function getLineIndexOfChar(charIndex:int):int
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retourneert de op nul gebaseerde indexwaarde van de regel die het teken bevat dat door de parameter charIndex
wordt opgegeven.
Parameters
charIndex:int — De op nul gebaseerde indexwaarde van het teken (het eerste teken is bijvoorbeeld 0, het tweede teken 1, enzovoort).
|
int — De op nul gebaseerde indexwaarde van de regel.
|
Gegenereerde uitzondering
RangeError — De opgegeven tekenindex bevindt zich buiten het bereik.
|
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
getLineIndexOfChar()
het regelnummer voor het 100e en 500e teken in het tekstveld.
Het tekstveld myTextField
is gedefinieerd op tekstomloop en de tekst wordt ingesteld op links uitlijnen. De methode getLineIndexOfChar()
retourneert de index van de regel voor de opgegeven tekenindexen (100 en 500). Deze informatie wordt vervolgens na de alinea toegevoegd. Aangezien de index van de regel met 0 begint, wordt de index van de regel index
) met 1 opgehoogd om het regelnummer te bepalen. Wanneer de grootte van de weergave wordt gewijzigd, kan het regelnummer veranderen maar de informatie blijft gelijk aangezien de methode slechts eenmaal wordt aangeroepen.
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 | () | methode |
public function getLineLength(lineIndex:int):int
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retourneert het aantal tekens in een opgegeven tekstregel.
Parameters
lineIndex:int — Het nummer van de regel waarvan u de lengte wilt weten.
|
int — Het aantal tekens op de regel.
|
Gegenereerde uitzondering
RangeError — Het opgegeven regelnummer bevindt zich buiten het bereik.
|
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
Als voorbeeld wordt het tekstveld myTextField
, dat de tekst bevat die zal worden geteld, op INPUT
ingesteld, zodat gebruikers regels kunnen wijzigen of regels tussen de regels of aan het eind kunnen toevoegen. (Er wordt een lege regel gemaakt door een regeleinde (\n
) te gebruiken aan het einde van de laatste regel.) Het tekstveld countLines
, waarin het resultaat van de telling van de regellengte wordt weergegeven, wordt onder het tekstveld myTextField
geplaatst en de tekst ervan kan niet worden geselecteerd. Wanneer de gebruiker op een regel in het tekstveld myTextField
klikt, wordt de methode clickHandler()
aangeroepen.
Bij de methode clickHandler()
retourneert de methode getLineIndexAtPoint()
de index van de regel waarop de gebruiker heeft geklikt door gebruik te maken van de coördinaten localX
en localY
van de muisklik. De instructie if
controleert of de gebruiker op een teken heeft geklikt. Zo ja, dan retourneert de methode getLineLength()
, met gebruikmaking van de index van de regel, het aantal tekens in de regel. De lege regels tussen de regels omvatten het tweede regeleinde (\n
) en hebben een telling van 1; de regel na de laatste regel heeft een telling van 0. Spaties tellen als één teken. De gebruiker kan een nieuwe regel schrijven of een regel wijzigen en de tekentelling van de regel opvragen door erop te klikken. Wanneer tekstomloop wordt gebruikt en de grootte van het scherm is gewijzigd, kan de index van de regel veranderen.
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 | () | methode |
public function getLineMetrics(lineIndex:int):flash.text:TextLineMetrics
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Geeft metrische informatie over een bepaalde tekstregel weer.
Parameters
lineIndex:int — Het nummer van de regel waarover u metrische informatie wilt krijgen.
|
flash.text:TextLineMetrics — Een object TextLineMetrics.
|
Gegenereerde uitzondering
RangeError — Het opgegeven regelnummer bevindt zich buiten het bereik.
|
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
De toegevoegde tekst is twee regels van Song of Myself van Walt Whitman. Een nieuw object TextFormat (newFormat
) wordt gebruikt om de opmaak van de tweede regel in te stellen. De eerste regel bevat de standaardopmaak. De methode getLineMetrics()
retourneert een object TextLineMetrics
voor een specifieke regel. (Index van de regel begint met 0.) Met de TextLineMetrics-objecten metrics1
en metrics2
voor respectievelijk regel één en twee worden de waarden ascent, descent, height en weight van de regel opgehaald en weergegeven. De resultaatgetallen worden omgezet in een tekenreeks, maar niet afgerond. Deze waarde is van toepassing op de regel en niet op een specifiek teken. De waarde weerspiegelt de reeks tekens voor een regel. Wanneer een regel bijvoorbeeld verschillende tekens bevat met verschillende hoogten, zal het teken met de hoogste hoogte de waarde bepalen. Dit houdt tevens in dat wanneer de opmaak van een teken wordt gewijzigd, een aantal cijferwaarden ook kan wijzigen.
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 | () | methode |
public function getLineOffset(lineIndex:int):int
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retourneert de tekenindex van het eerste teken op de regel die wordt opgegeven door de parameter lineIndex
.
Parameters
lineIndex:int — De op nul gebaseerde indexwaarde van de regel (de eerste regel is bijvoorbeeld 0, de tweede regel 1, enzovoort).
|
int — De op nul gebaseerde indexwaarde van het eerste teken in de regel.
|
Gegenereerde uitzondering
RangeError — Het opgegeven regelnummer bevindt zich buiten het bereik.
|
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
Het tekstveld myTextField
wordt op tekstomloop ingesteld. Het tekstveld countField
bevat het eerste teken van regel 4. Wanneer de gebruiker op het tekstveld myTextField
klikt, wordt de methode clickHandler()
aangeroepen.
Bij de methode clickHandler()
retourneert de methode getLineOffset()
de index van het eerste teken in regelindex 3 (de vierde regel van de tekst). (De eerste regel heeft een index 0.) De methode charAt()
wordt gebruikt om het teken op te halen met de index van het eerste teken van de vierde regel. De inhoud van het tekstveld countField
wordt bijgewerkt met deze informatie via de eigenschap text
van het tekstveld countField
. Door gebruik te maken van de eigenschap countField.text
, wordt de inhoud van het tekstveld countField
telkens overschreven nadat is geklikt. Wanneer de gebruiker de grootte van het scherm wijzigt, wordt tekstomloop toegepast en kan het eerste teken van regel 4 veranderen. Door nogmaals te klikken op het veld myTextField
wordt de inhoud van het tekstveld countField
bijgewerkt met het eerste nieuwe teken voor de vierde regel.
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 | () | methode |
public function getLineText(lineIndex:int):String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retourneert de tekst van de regel die wordt opgegeven door de parameter lineIndex
.
Parameters
lineIndex:int — De op nul gebaseerde indexwaarde van de regel (de eerste regel is bijvoorbeeld 0, de tweede regel 1, enzovoort).
|
String — De tekstreeks in de opgegeven regel.
|
Gegenereerde uitzondering
RangeError — Het opgegeven regelnummer bevindt zich buiten het bereik.
|
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
Het tekstveld poem
wordt automatisch gewijzigd zodat de tekst erin past en de tekst wordt ingesteld op links uitvullen. De eigenschap wordWrap
wordt op false
ingesteld, zodat de regels van het gedicht niet omlopen, hoewel dit normaalgesproken geen probleem moet zijn bij gebruik van de eigenschap autoSize
. De lus for
doorloopt de regels van het sonnet met de eigenschap numLines
van het tekstveld. De methode getLineText()
retourneert de inhoud van de regel als een tekenreeks. (De eigenschap numLines
retourneert het aantal regels beginnend met regel 1, terwijl bij de methode getLineText()
het regelnummer begint met 0.) Bij gebruik van het reguliere-expressiepatroon (/love/i
) zoekt de instructie if
naar elke subtekenreeks van het woord in hoofdletters of kleine letters. Wanneer het patroon wordt gevonden, retourneert de methode search
de index van de eerste overeenkomende subtekenreeks; anders wordt -1
geretourneerd (wanneer er geen overeenkomst is). Het regelnummer waar 'love' werd gevonden ((i + 1)
) wordt vervolgens in de tekenreeks lineResult
geplaatst. De tekenreeksmethode zet het getalsargument ((i + 1)
) om in een tekenreeks zolang er een ander argument is dat een tekenreeks is (' '). Het regelresultaat van de zoekopdracht bevat regels met de woorden 'loved' of 'Love's'. Wanneer de tekenreeks 'Love was found in lines:' was toegevoegd voor de lus for
, zou het woord 'Love' in deze regel ook zijn opgenomen.
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 | () | methode |
public function getParagraphLength(charIndex:int):int
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Op basis van een tekenindex wordt hiermee de lengte van de alinea met het opgegeven teken geretourneerd. De lengte is relatief ten opzichte van het eerste teken in de alinea (zoals wordt geretourneerd door getFirstCharInParagraph()
), niet ten opzichte van de doorgegeven tekenindex.
Parameters
charIndex:int — De op nul gebaseerde indexwaarde van het teken (het eerste teken is bijvoorbeeld 0, het tweede teken 1, enzovoort).
|
int — Retourneert het aantal tekens in de alinea.
|
Gegenereerde uitzondering
RangeError — De opgegeven tekenindex bevindt zich buiten het bereik.
|
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
Het tekstveld myTextField
bevat de alinea's die de gebruiker zal selecteren. Wanneer de gebruiker op het tekstveld klikt, wordt de gebeurtenis MouseEvent.CLICK
verzonden en wordt de methode clickHandler()
aangeroepen. De lengte van de alinea en het aantal 's'- tekens worden weergegeven in het tekstveld countField
dat onder het tekstveld myTextField
wordt geplaatst.
Bij de methode clickHandler()
retourneert de methode getCharIndexAtPoint()
de index van het teken op basis van de coördinaten localX
en localY
van de muisklik. De eerste instructie if
controleert of de gebruiker op een teken heeft geklikt. De methode getFirstCharInParagraph()
gebruikt deze index om de index van het eerste teken in dezelfde alinea te retourneren. De lengte van de alinea die wordt geretourneerd door de methode getParagraphLength()
, wordt gebruikt met de index van het eerste teken in de alinea om de index voor het einde van de alinea te bepalen. Een lus for
doorloopt de alinea en zoekt naar het aantal 's'-tekens.
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 | () | methode |
public function getTextFormat(beginIndex:int = -1, endIndex:int = -1):flash.text:TextFormat
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retourneert een object TextFormat met opmaakgegevens voor het tekstbereik dat is opgegeven met de parameters beginIndex
en endIndex
. Alleen eigenschappen die worden gedeeld door de volledige opgegeven tekst, worden ingesteld in het resulterende object TextFormat. Voor elke variërende eigenschap (verschillende waarden op verschillende punten in de tekst) wordt de waarde ingesteld op null
.
Wanneer u geen waarden voor deze parameters opgeeft, wordt deze methode toegepast op de volledige tekst van het tekstveld.
In de volgende tabel worden drie mogelijke toepassingen beschreven:
Gebruik | Beschrijving |
---|---|
my_textField.getTextFormat() | Retourneert een object TextFormat met opmaakgegevens voor alle tekst in een tekstveld. Alleen eigenschappen die worden gedeeld door alle tekst in het tekstveld, worden ingesteld in het resulterende object TextFormat. Voor elke variërende eigenschap (verschillende waarden op verschillende punten in de tekst) wordt de waarde ingesteld op null . |
my_textField.getTextFormat(beginIndex:Number) | Retourneert een object TextFormat met een kopie van de tekstopmaak van het teken op de positie beginIndex . |
my_textField.getTextFormat(beginIndex:Number,endIndex:Number) | Retourneert een object TextFormat met opmaakgegevens voor de tekst van beginIndex tot endIndex-1 . Alleen eigenschappen die worden gedeeld door alle tekst in het opgegeven bereik, worden ingesteld in het resulterende object TextFormat. Voor elke variërende eigenschap (verschillende waarden op verschillende punten in het bereik) wordt de waarde ingesteld op null . |
Parameters
beginIndex:int (default = -1 ) — Optioneel: een geheel getal waarmee de beginlocatie van een tekstbereik in het tekstveld wordt opgegeven.
| |
endIndex:int (default = -1 ) — Optioneel: een geheel getal dat de positie van het eerste teken na het gewenste tekstbereik opgeeft. Wanneer u waarden opgeeft voor beginIndex en endIndex , wordt de tekst van beginIndex tot endIndex-1 gelezen.
|
flash.text:TextFormat — Het object TextFormat dat de opmaakeigenschappen voor de opgegeven tekst vertegenwoordigt.
|
Gegenereerde uitzondering
RangeError — De opgegeven parameter beginIndex of endIndex bevindt zich buiten het bereik.
|
Verwante API-elementen
Voorbeeld
Hoe dit voorbeeld te gebruiken
Zie het voorbeeld van de methode getFirstCharInParagraph() of setTextFormat() voor een toelichting op het gebruik van de methode
getTextFormat()
.
isFontCompatible | () | methode |
public static function isFontCompatible(fontName:String, fontStyle:String):Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Hiermee wordt true geretourneerd als er een ingesloten lettertype beschikbaar is met de opgegeven fontName
en fontStyle
waarbij Font.fontType
flash.text.FontType.EMBEDDED
is. Vanaf Flash Player 10 kunnen twee ingesloten lettertypen in een SWF-bestand worden weergegeven. Gewone ingesloten lettertypen worden alleen gebruikt bij TextField-objecten. Ingesloten CFF-lettertypen worden alleen gebruikt bij de klassen flash.text.engine. Het verschil tussen de twee typen is de eigenschap fontType
van de klasse Font
, zoals geretourneerd door de functie enumerateFonts()
.
TextField kan geen lettertype van het type EMBEDDED_CFF
gebruiken. Als embedFonts
is ingesteld op true
en EMBEDDED_CFF
het enige lettertype met de opgegeven naam en opmaak dat tijdens runtime beschikbaar is, kan de tekst niet in Flash Player worden weergegeven, alsof er geen ingesloten lettertype met de opgegeven naam en opmaak beschikbaar is.
Als de lettertypen EMBEDDED
en EMBEDDED_CFF
beide beschikbaar zijn met dezelfde naam en opmaak, wordt het lettertype EMBEDDED
geselecteerd en wordt de tekst met het lettertype EMBEDDED
weergegeven.
Parameters
fontName:String — De naam van het ingesloten lettertype dat moet worden gecontroleerd.
| |
fontStyle:String — Hiermee wordt de tekenopmaak weergegeven die gecontroleerd moet worden. flash.text.FontStyle gebruiken
|
Boolean — true als er een compatibel ingesloten lettertype beschikbaar is, anders false .
|
Gegenereerde uitzondering
ArgumentError — De opgegeven fontStyle is geen lid van flash.text.FontStyle .
|
Verwante API-elementen
replaceSelectedText | () | methode |
public function replaceSelectedText(value:String):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Vervangt de huidige selectie door de inhoud van de parameter value
. De tekst wordt met de huidige standaardinstellingen voor teken- en alineaopmaak ingevoegd op de positie van de huidige selectie. De tekst wordt niet beschouwd als HTML.
U kunt de methode replaceSelectedText()
gebruiken om tekst in te voegen en te verwijderen zonder de teken- en alineaopmaak van de rest van de tekst te wijzigen.
Opmerking: Deze methode werkt niet wanneer een stijlpagina op het tekstveld wordt toegepast.
Parameters
value:String — De tekenreeks die de geselecteerde tekst moet vervangen.
|
Gegenereerde uitzondering
Error — Deze methode kan niet worden gebruikt voor een tekstveld met een stijlpagina.
|
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
Er worden twee verschillende objecten TextField gemaakt en er worden gebeurtenislisteners toegevoegd voor de gebeurtenissenMouseEvent.MOUSE_UP
. MouseUp vindt plaats wanneer de gebruiker de muis loslaat, een gebeurtenis die normaalgesproken plaatsvindt nadat tekst is geselecteerd. De standaardinstelling voor een tekstveld is dat de tekst ervan moet worden geselecteerd.
Wanneer een gebruiker de muisknop loslaat in het tekstveld myTextField1
, wordt bij de methode mouseHandler1()
de tekst gewist door deze te vervangen door een lege tekenreeks. Dit kan worden gedaan totdat alle tekst is gewist. Wanneer een gebruiker tekst selecteert in het tekstveld myTextField2
, worden bij de methode mouseHandler2()
de eigenschappen selectionBeginIndex
en selectionEndIndex
gecontroleerd om na te gaan of een teken is geselecteerd. (De eigenschappen selectionBeginIndex
en selectionEndIndex
hebben niet dezelfde waarde wanneer enige tekst is geselecteerd.) De geselecteerde tekst wordt vervolgens vervangen door de tekenreeks NEW TEXT. Dit kan worden gedaan totdat alle oorspronkelijke tekst in het tweede tekstveld is vervangen door de tekenreeks 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 | () | methode |
public function replaceText(beginIndex:int, endIndex:int, newText:String):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Vervangt de met de parameters beginIndex
en endIndex
opgegeven tekenreeks door de inhoud van de parameter newText
. De tekst van beginIndex
tot endIndex-1
wordt vervangen.
Opmerking: Deze methode werkt niet wanneer een stijlpagina op het tekstveld wordt toegepast.
Parameters
beginIndex:int — De op nul gebaseerde indexwaarde voor de beginpositie van het vervangingsbereik.
| |
endIndex:int — De op nul gebaseerde indexpositie van het eerste teken na het gewenste tekstbereik.
| |
newText:String — De tekst die moet worden gebruikt om het opgegeven tekenbereik te vervangen.
|
Gegenereerde uitzondering
Error — Deze methode kan niet worden gebruikt voor een tekstveld met een stijlpagina.
|
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
replaceText()
gebruikt om enige tekst in een tekstveld te verwijderen, te vervangen en in te voegen.
Het tekstveld outputText
wordt automatisch gewijzigd zodat de tekst erin past en de tekst wordt ingesteld op links uitvullen. Bij de eerste aanroep van de methode replaceText()
wordt de eerste regel (This is the wrong heading) vervangen door THIS IS THE HEADING FOR EVERYONE. Bij de tweede aanroep van de methode wordt de tekst CORRECT ingevoegd tussen THE en HEADING. Bij de derde aanroep van de methode worden de woorden FOR EVERYONE verwijderd. Bij elke aanroep van de methode appendText()
worden de huidige begin- en eindindex van de tekst gewijzigd. Hier wordt alleen de uiteindelijke tekst weergegeven (nadat de wijzigingen zijn doorgevoerd).
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 | () | methode |
public function setSelection(beginIndex:int, endIndex:int):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Stelt de tekst in als geselecteerd die wordt bepaald door de indexwaarden van het eerste en laatste teken, opgegeven door de parameters beginIndex
en endIndex
. Wanneer de twee parameterwaarden hetzelfde zijn, stelt deze methode het invoegpunt in, net als wanneer u de eigenschap caretIndex
instelt.
Parameters
beginIndex:int — De op nul gebaseerde indexwaarde van het eerste teken in de selectie (het eerste teken is bijvoorbeeld 0, het tweede teken 1, enzovoort).
| |
endIndex:int — De op nul gebaseerde indexwaarde van het laatste teken in de selectie.
|
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
Twee gebeurtenislisteners voor het tekstveld myTextField
reageren op de muisklikken of mouseUp-gebeurtenissen van de gebruiker. MouseUp vindt plaats wanneer de gebruiker de muis loslaat, een gebeurtenis die normaalgesproken plaatsvindt nadat tekst is geselecteerd. De standaardinstelling voor een tekstveld is dat de tekst ervan moet worden geselecteerd. Wanneer op tekst wordt geklikt, wordt de methode clickHandler()
aangeroepen. Wanneer enige tekst wordt geselecteerd en de muis wordt losgelaten, wordt de methode mouseUpHandler()
aangeroepen
Bij de methoden clickHandler()
en mouseUpHandler()
stelt de methode setSelection()
alleen de tekens in tussen index 54 en 70 (TEXT IN ALL CAPS) die moeten worden geselecteerd.
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 | () | methode |
public function setTextFormat(format:flash.text:TextFormat, beginIndex:int = -1, endIndex:int = -1):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Past de tekstopmaak die is opgegeven met de parameter format
toe op de opgegeven tekst in een tekstveld. De waarde van format
moet een object TextFormat zijn dat de gewenste wijzigingen in de tekstopmaak opgeeft. Alleen de niet-null-eigenschappen van format
worden toegepast op het tekstveld. Een eigenschap van format
die is ingesteld op null
, wordt niet toegepast. Alle eigenschappen van een nieuw object TextFormat worden standaard ingesteld op null
.
Opmerking: Deze methode werkt niet wanneer een stijlpagina op het tekstveld wordt toegepast.
De methode setTextFormat()
wijzigt de tekstopmaak die op een reeks tekens of op een gehele tekst in een tekstveld wordt toegepast. Wanneer u de opmaakeigenschappen wilt toepassen op alle tekst in het tekstveld, moet u geen waarden opgeven voor beginIndex
en endIndex
. Wanneer u de opmaakeigenschappen op een reeks tekens wilt toepassen, geeft u waarden op voor de parameters beginIndex
en endIndex
. U kunt de eigenschap length
gebruiken om de indexwaarden te bepalen.
De twee typen opmaakgegevens in een object TextFormat zijn opmaak op tekenniveau en opmaak op alineaniveau. Voor elk teken in een tekstveld kan aparte tekenopmaak worden ingesteld, zoals een lettertypenaam, tekengrootte, vet en cursief.
Voor alinea's wordt het eerste teken van de alinea gecontroleerd voor de instellingen voor alineaopmaak voor de hele alinea. Voorbeelden van alineaopmaak zijn linkermarge, rechtermarge en inspringing.
Op tekst die handmatig wordt ingevoerd door de gebruiker of wordt vervangen met de methode replaceSelectedText()
, wordt de standaardopmaak voor nieuwe tekst toegepast, niet de opmaak die is opgegeven voor het tekstinvoegpunt. Gebruik defaultTextFormat
om de standaardopmaak voor nieuwe tekst in te stellen.
Parameters
format:flash.text:TextFormat — Een object TextFormat dat informatie over tekenopmaak en alineaopmaak bevat.
| |||||||||
beginIndex:int (default = -1 ) — Optioneel: een geheel getal dat de op nul gebaseerde indexpositie opgeeft waarmee het eerste teken van de gewenste tekenreeks wordt opgegeven.
| |||||||||
endIndex:int (default = -1 ) — Optioneel: een geheel getal dat het eerste teken na het gewenste tekstbereik opgeeft. Wanneer u waarden opgeeft voor beginIndex en endIndex , wordt de tekst van beginIndex tot endIndex-1 bijgewerkt.
Op tekst die handmatig wordt ingevoerd door de gebruiker of wordt vervangen door de methode |
Gegenereerde uitzondering
Error — Deze methode kan niet worden gebruikt voor een tekstveld met een stijlpagina.
| |
RangeError — De opgegeven parameter beginIndex of endIndex bevindt zich buiten het bereik.
|
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
Er wordt een gebeurtenislistener voor het tekstveld myTextField
toegevoegd om te reageren op de muisklikken door de methode clickHandler()
aan te roepen. Bij de methode clickHandler()
retourneert de methode getTextFormat()
de huidige opmaak van een teken (index 55) uit het bedoelde bereik van de tekst, waarna deze in het TextFormat-object currentTextFormat
wordt geplaatst. De instructie if
controleert de tekstopmaak currentTextFormat
om na te gaan of het teken in het bereik de nieuwe opmaak gebruikt (puntgrootte is ingesteld op 18). Als dat niet het geval is, wijzigt de nieuwe opmaak de grootte in 18, wijzigt de kleur in rood en past onderstrepen en cursief maken toe op het tekstbereik tussen 54-70 (TEXT IN ALL CAPS). Wanneer het teken in het bereik de nieuwe opmaak gebruikt, wordt de opmaak van het bereik teruggezet naar de standaardopmaak (oorspronkelijke opmaak) van het tekstveld.
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 | Gebeurtenis |
flash.events.Event
eigenschap Event.type =
flash.events.Event.CHANGE
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wordt verzonden nadat een besturingswaarde is gewijzigd, in tegenstelling tot de gebeurtenis textInput
, die wordt verzonden voordat de waarde wordt gewijzigd. In tegenstelling tot het W3C DOM-gebeurtenismodel van de gebeurtenis change
dat de gebeurtenis pas verzendt nadat de opties focus verliest, wordt de ActionScript 3.0-versie van de gebeurtenis change
verzonden zodra de optie wordt gewijzigd. Wanneer een gebruiker bijvoorbeeld tekst in een tekstveld typt, wordt de gebeurtenis change
na elke toetsdruk verzonden.
Event.CHANGE
definieert de waarde van de eigenschap type
van een change
-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | true |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Het object waarvan de waarde is gewijzigd. Het target is niet altijd het object in het weergaveoverzicht dat in de gebeurtenislistener is geregistreerd. Gebruik de eigenschap currentTarget voor toegang tot het object in het weergaveoverzicht dat momenteel de gebeurtenis verwerkt. |
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
Er worden twee tekstvelden gemaakt, een voor de gebruikersinvoer en een (headingTextField
) voor de kopie van de gebruikersinvoer. Er wordt tevens een object TextFormat gemaakt en toegewezen aan de standaardtekstopmaak van het tekstveld headingTextField
. Wanneer de inhoud van het tekstveld wordt gewijzigd, wordt de methode changeHandler()
aangeroepen. Hiermee wordt de tekst in het tekstveld inputTextField
toegewezen aan het tekstveld headingTextField
. (Wanneer de methode wordt aangeroepen voor de gebeurtenis TextEvent.TEXT_INPUT
in plaats van voor de gebeurtenis Event.CHANGE
, wordt de inhoud van de gebruikersinvoer alleen gekopieerd nadat de gebruiker meer tekst heeft ingevoerd.)
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 | Gebeurtenis |
flash.events.TextEvent
eigenschap TextEvent.type =
flash.events.TextEvent.LINK
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wordt verzonden wanneer een gebruiker op een hyperlink in een HTML-tekstveld klikt waarbij de URL begint met 'event:'. De rest van de URL na 'event:' wordt in de teksteigenschap van de gebeurtenis LINK geplaatst.
Opmerking: het standaardgedrag (de tekst aan het tekstveld toevoegen) vindt alleen plaats wanneer Flash Player de gebeurtenis genereert, wat in dit geval gebeurt wanneer een gebruiker probeert tekst in te voeren. U kunt geen tekst in een tekstveld opnemen door hiernaar gebeurtenissen textInput
te verzenden.
type
van een gebeurtenisobject link
.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | true |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Het tekstveld dat de hyperlink bevat die is aangeklikt. Het target is niet altijd het object in het weergaveoverzicht dat in de gebeurtenislistener is geregistreerd. Gebruik de eigenschap currentTarget voor toegang tot het object in het weergaveoverzicht dat momenteel de gebeurtenis verwerkt. |
text | De rest van de URL na 'event:' |
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
playMP3()
gedefinieerd. Een object TextField met de naam list
wordt gemaakt en gevuld met HTML-tekst. De teksten Track 1
en Track 2
zijn koppelingen binnen het tekstveld. De functie playMP3() wordt aangeroepen wanneer de gebruiker op één van de koppelingen klikt. De naam van het MP3-bestand, die volgt op de tekenreeks 'event:' in het kenmerk href
van de HTML-tag, wordt doorgegeven aan de methode linkHandler()
als de eigenschap text
van het gebeurtenisobject 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 | Gebeurtenis |
flash.events.Event
eigenschap Event.type =
flash.events.Event.SCROLL
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wordt door een object TextField verzonden nadat de gebruiker schuift.
De constanteEvent.SCROLL
definieert de waarde van de eigenschap type
van een scroll
-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Het object TextField dat is geschoven. De eigenschap target is niet altijd het object in het weergaveoverzicht dat in de gebeurtenislistener is geregistreerd. Gebruik de eigenschap currentTarget voor toegang tot het object in het weergaveoverzicht dat momenteel de gebeurtenis verwerkt. |
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
mouseDown
verzonden en wordt de gekoppelde mouseDownScroll
-handler aangeroepen. De mouseDownScroll()
-handler zorgt ervoor dat het veld kan schuiven. Vervolgens wordt de gebeurtenis scroll
verzonden en werkt de scrollHandler()
-handler het tweede tekstveld bij en wordt de huidige verschuivingspositie weergegeven.
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 | Gebeurtenis |
flash.events.TextEvent
eigenschap TextEvent.type =
flash.events.TextEvent.TEXT_INPUT
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Flash Player verzendt de gebeurtenis textInput
wanneer een gebruiker een of meer tekens invoert. Deze gebeurtenis kan door een verschillende tekstinvoermethoden worden gegenereerd, inclusief standaardtoetsenborden, invoermethode-editors (IME's), stem- of spraakherkenningssystemen en zelfs het plakken van onbewerkte tekst zonder opmaak- of stijlinformatie.
type
van een gebeurtenisobject textInput
.
Opmerking: deze gebeurtenis wordt niet verzonden voor de toetsen Delete of Backspace.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | true |
cancelable | true ; roep de methode preventDefault() aan om het standaardgedrag te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Het tekstveld waarin de tekens worden ingevoerd. Het doel is niet altijd het object in het weergaveoverzicht dat in de gebeurtenislistener is geregistreerd. Gebruik de eigenschap currentTarget voor toegang tot het object in het weergaveoverzicht dat momenteel de gebeurtenis verwerkt. |
text | Het teken of de tekenreeks dat/die door de gebruiker is ingevoerd. |
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
textInput
verzonden, de textInputHandler()
-handler aangeroepen en worden de tekens in het tweede tekstveld weergegeven. Wanneer u een blok tekst in het invoerveld plakt, kopieert de gebeurtenishandler het hele blok naar het andere veld.
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 | Gebeurtenis |
flash.events.Event
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 11, Flash Lite 4 |
Flash Player verzendt de gebeurtenis textInteractionModeChange
wanneer een gebruiker de interactiemodus van een tekstveld wijzigt. Op Android-systemen kunt u bijvoorbeeld met de opties in contextmenu's schakelen tussen de modus NORMAL en de modus SELECTION.
TextFieldExample
gebruikt om een tekstbericht weer te geven. Hierbij moeten de volgende stappen worden uitgevoerd:
- Een eigenschap
label
van het type TextField wordt gemaakt. - De klasseconstructor roept de functie
configureLabel()
aan. - De methode
configureLabel()
maakt eerst een nieuw object TextField en wijst dit toe aan de eigenschaplabel
. Vervolgens worden de parameters ervan als volgt ingesteld:- Het tekstveld wordt links uitgevuld.
- De opvulkleur voor de achtergrond wordt ingeschakeld.
- De rand wordt ingeschakeld.
- De methode
configureLabel()
maakt de variabeleformat
en wijst deze toe aan een nieuwe instantie TextFormat met de volgende parameterinstellingen:- Font type = Verdana
- Font color = solid red
- Font size = 10
- Font underline = true
- De eigenschap
defaultTextFormat
van het tekstveldlabel
wordt ingesteld opformat
en de instantielabel
wordt toegevoegd aan het weergaveoverzicht, waarin eerst een tekstveld zonder tekst wordt weergegeven in het werkgebied. - De constructor stelt de tekst van het tekstveld
label
in op'Hello world and welcome to the show.'
door de methodesetLabel()
aan te roepen.
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); } } }
Wed Jun 13 2018, 11:42 AM Z