TLFTextField  - AS3 Flash

Wanneer ingesteld op true en het tekstveld geen focus heeft, maakt Flash Player de selectie in het tekstveld lichtblauw. Wanneer ingesteld op false en het tekstveld geen focus heeft, wordt de selectie in het tekstveld niet gemarkeerd.

Voorbeeld:

		package 
		{
		    import flash.display.Sprite;
		    import fl.text.TLFTextField;
		    import flash.text.TextFieldType;
		
    	    public class TLFTextField_alwaysShowSelection extends Sprite 
		    {
		
		        public function TLFTextField_alwaysShowSelection() 
		        {
		            var label1:TLFTextField = createTLFTextField(0, 20, 200, 20);
		            label1.text = "This text is selected.";
		            label1.setSelection(0, 9);
		            label1.alwaysShowSelection = true;
		
		            var label2:TLFTextField = createTLFTextField(0, 50, 200, 20);
		            label2.text = "Drag to select some of this text.";
		        }
		
		        private function createTLFTextField(x:Number, y:Number, width:Number, height:Number):TLFTextField 
		        {
		            var result:TLFTextField = new TLFTextField();
		            result.x = x; 
		            result.y = y;
		            result.width = width; 
		            result.height = height;
		            addChild(result);
		            return result;
		        }
		    }
		}
		

De standaardwaarde is false.

Verwante API-elementen

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).

Wanneer u waarden voor deze eigenschap wilt instellen, gebruikt u de volgende tekenreekswaarden:

De standaardwaarde is flash.text.AntiAliasType.NORMAL.

Verwante API-elementen

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.

Verwante API-elementen

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.

Verwante API-elementen

Geeft de alfawaarde van de tekstveldachtergrond aan. De alfa van de achtergrond kan op elke waarde tussen 0(onzichtbaar) en 1 (effen) worden ingesteld. Deze eigenschap kan worden opgehaald of ingesteld, zelfs wanneer momenteel geen achtergrond is ingesteld, maar het alfa-effect is alleen zichtbaar wanneer voor het tekstveld de eigenschap background is ingesteld op true.

De standaardwaarde is 1.0.

Verwante API-elementen

Geeft de kleur van de tekstveldachtergrond aan. 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.

De standaardwaarde is 0xFFFFFF (white).

Verwante API-elementen

Geeft een verticale of horizontale voortgang van lijnplaatsing aan. De regels worden van boven naar beneden geplaatst (BlockProgression.TB bij horizontale tekst) en van rechts naar links (BlockProgression.RL bij verticale tekst).

Geldige waarden zijn flashx.textLayout.formats.BlockProgression.RL, flashx.textLayout.formats.BlockProgression.TB, flashx.textLayout.formats.FormatValue.INHERIT.

Als de waarde niet is gedefinieerd tijdens de trapsgewijze opmaak, neemt deze eigenschap de waarde van een voorouder over. Als er voor deze eigenschap geen voorouder is ingesteld, heeft deze de waarde TB.

De standaardwaarde is undefined (indicates not set).

Verwante API-elementen

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.

Verwante API-elementen

Geeft de alfawaarde van de rand aan. De alfa van de rand kan op elke waarde tussen 0(onzichtbaar) en 1 (effen) worden ingesteld. Deze eigenschap kan worden opgehaald of ingesteld, zelfs wanneer momenteel geen rand is ingesteld, maar het alfa-effect is alleen zichtbaar wanneer voor het tekstveld de eigenschap border is ingesteld op true.

De standaardwaarde is 1.0.

Verwante API-elementen

Geeft de kleur van de tekstveldrand aan. 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.

Verwante API-elementen

Geeft de breedte van de rand aan. De breedte van de rand kan op elke waarde tussen 1 en 100 worden ingesteld. Deze eigenschap kan worden opgehaald of ingesteld, zelfs wanneer momenteel geen achtergrond is ingesteld, maar de breedte is alleen zichtbaar wanneer voor het tekstveld de eigenschap border is ingesteld op true.

Bij het berekenen van de breedte of hoogte van het tekstveld wordt er rekening gehouden met de breedte van de rand. Om de breedte of hoogte van de tekstcontainer zonder rand te berekenen, trekt u tweemaal de borderWidth van de breedte- of hoogtewaarde af.

Bijvoorbeeld, txtHeight = tlf.height - (2 tlf.borderwidth);.

De standaardwaarde is 1.

Verwante API-elementen

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 scrollV-eigenschap is de op 1 gebaseerde index van de bovenste zichtbare regel in het venster en bottomScroll is de laatst zichtbare regel in het venster.

De tekst tussen de regels die worden aangegeven door scrollV en bottomScrollV wordt momenteel weergegeven in het tekstveld.

Verwante API-elementen

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).

Voorbeeld:

		package 
		{
			import flash.display.Sprite;
			import flash.events.MouseEvent;
			import fl.text.TLFTextField;
			import flash.text.TextFieldType;
		
			public class TLFTextField_caretIndex extends Sprite 
			{
				public function TLFTextField_caretIndex() 
				{
					var tlf:TLFTextField = createTLFTextField(10, 10, 100, 100);
					tlf.wordWrap = true;
					tlf.type = TextFieldType.INPUT;
					tlf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text.";
					tlf.addEventListener(MouseEvent.CLICK, printCursorPosition);
				}
		
				private function printCursorPosition(event:MouseEvent):void 
				{
					var tlf:TLFTextField = TLFTextField(event.currentTarget);
					trace("caretIndex:", tlf.caretIndex);
					trace("selectionBeginIndex:", tlf.selectionBeginIndex);
					trace("selectionEndIndex:", tlf.selectionEndIndex);
				}
		
				private function createTLFTextField(x:Number, y:Number, width:Number, height:Number):TLFTextField 
				{
					var result:TLFTextField = new TLFTextField();
					result.x = x;
					result.y = y;
					result.width = width;
					result.height = height;
					addChild(result);
					return result;
				}
			}
		}		 
		

Verwante API-elementen

Het aantal tekstkolommen (neemt de standaardwaarde over als deze tijdens de trapsgewijze opmaak niet is gedefinieerd). De waarde voor het aantal tekstkolommen overschrijft alle andere kolominstellingen. De waarde is een geheel getal of FormatValue.AUTO (indien niet opgegeven). Als columnCount niet is opgegeven, wordt columnWidth gebruikt om zoveel mogelijk kolommen te maken die in de container passen.

Geldige tekenreekswaarden zijn flashx.textLayout.formats.FormatValue.AUTO, flashx.textLayout.formats.FormatValue.INHERIT en ints van 1 tot 50.

Als deze eigenschap niet tijdens de trapsgewijze opmaak gedefinieerd is, heeft deze de waarde AUTO.

De standaardwaarde is undefined (indicates not set).

Verwante API-elementen

Geeft de waarde van de tussenruimte tussen de kolommen in pixels op (neemt de standaardwaarde over als deze tijdens de trapsgewijze opmaak niet gedefinieerd is).

Een geldige waarde is een getal tussen 0 en 1000 of flashx.textLayout.formats.FormatValue.INHERIT.

Als deze eigenschap niet tijdens de trapsgewijze opmaak gedefinieerd is, heeft deze de waarde 20.

De standaardwaarde is undefined (indicates not set).

Verwante API-elementen

Kolombreedte in pixels (neemt de standaardwaarde over als deze tijdens de trapsgewijze opmaak niet gedefinieerd is). Als u de kolombreedte opgeeft maar niet het aantal kolommen, maakt TextLayout zoveel mogelijk kolommen met de desbetreffende breedte. Hierbij wordt uitgegaan van de containerbreedte en de columnGap-instellingen. De resterende ruimte wordt na de laatste kolom ingevoegd. De waarde is een getal.

Geldige tekenreekswaarden zijn flashx.textLayout.formats.FormatValue.AUTO, flashx.textLayout.formats.FormatValue.INHERIT en getallen van 0 tot 8000.

Als deze eigenschap niet tijdens de trapsgewijze opmaak gedefinieerd is, heeft deze de waarde AUTO.

De standaardwaarde is undefined (indicates not set).

Verwante API-elementen

Een booleaanse waarde die aangeeft of extra witruimte (spaties, regeleinden, enzovoort) in een tekstveld met HTML-tekst, of TLF-opmaakcode, wordt verwijderd. De standaardwaarde is false. De eigenschap condenseWhite is uitsluitend van invloed op TLF-opmaakcode of 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-tags zoals <br> en <p> gebruiken om regeleinden in het tekstveld op te nemen.

Stel de eigenschap condenseWhite in voordat u de eigenschap htmlText of de eigenschap tlfMarkup instelt.

In het volgende voorbeeld wordt aangegeven hoe u de eigenschap condenseWhite gebruikt om extra witruimte uit tlfMarkup-inhoud te verwijderen:

		 import fl.text.TLFTextField;
		 
		 var my_tlf:TLFTextField = new TLFTextField();
		 my_tlf.autoSize = 'left';
		 
		 // This line removes white space from tlfMarkup
		 my_tlf.condenseWhite = true;
		 
		 addChild(my_tlf);
		 
		 var my_markup:String =   '<TextFlow xmlns="http://ns.adobe.com/textLayout/2008">'
		 					+ '	<p>'
		 					+ '		<span>Here is the first span.</span>'
		 					+ ' 	       \n'
		 					+ '		<span>And here is the second span.</span>'
		 					+ '	</p>'
		 					+ '</TextFlow>';
		 					
		 my_tlf.tlfMarkup = my_markup;
		 

De standaardwaarde is false.

Verwante API-elementen

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.

Verwante API-elementen

Geeft het standaardinsluitingsniveau in twee richtingen van de tekst in het tekstblok aan. Bij een leesvolgorde van links naar rechts, zoals in talen die zijn gebaseerd op het Latijnse alfabet of bij een leesvolgorde van rechts naar links, zoals in het Arabisch of Hebreeuws. Deze eigenschap heeft ook invloed op de kolomrichting wanneer de eigenschap wordt toegepast op containerniveau. Kolommen zijn ook van links naar rechts (of van rechts naar links) georiënteerd, net als gewone tekst. Hieronder volgen enkele voorbeelden:

Geldige waarden zijn flashx.textLayout.formats.Direction.LTR, flashx.textLayout.formats.Direction.RTL, flashx.textLayout.formats.FormatValue.INHERIT.

Als de waarde niet is gedefinieerd tijdens de trapsgewijze opmaak, neemt deze eigenschap de waarde van een voorouder over. Als er voor deze eigenschap geen voorouder is ingesteld, heeft deze de waarde LTR.

De standaardwaarde is undefined (indicates not set).

Verwante API-elementen

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.

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. Als het opgegeven lettertype niet in het SWF-bestand is ingesloten, wordt de tekst in een reservelettertype weergegeven.

De standaardwaarde is false.

Verwante API-elementen

Geeft de basislijnpositie van de eerste regel in de container aan. Naar welke basislijn door deze eigenschap wordt verwezen is afhankelijk van de landinstellingswaarde op containerniveau. Voor Japans en Chinees geldt de waarde TextBaseline.IDEOGRAPHIC_BOTTOM; voor alle andere talen is het TextBaseline.ROMAN. De verschuiving van de bovenste inzet (of rechterinzet als blockProgression is ingesteld op RL) van de container naar de basislijn van de eerste regel kan de volgende waarden hebben: BaselineOffset.ASCENT (gelijk aan de stijging van de regel), BaselineOffset.LINE_HEIGHT (gelijk aan de hoogte van de eerste regel) of een vast getal om een absolute afstand aan te duiden. Met de waarde BaselineOffset.AUTO wordt de stijging van de regel uitgelijnd met de bovenste inzet van de container.

Geldige tekenreekswaarden zijn flashx.textLayout.formats.BaselineOffset.AUTO, flashx.textLayout.formats.BaselineOffset.ASCENT, flashx.textLayout.formats.BaselineOffset.LINE_HEIGHT, flashx.textLayout.formats.FormatValue.INHERIT en getallen van 0 tot 1000.

Als de waarde niet is gedefinieerd tijdens de trapsgewijze opmaak, neemt deze eigenschap de waarde van een voorouder over. Als er voor deze eigenschap geen voorouder is ingesteld, heeft deze de waarde AUTO.

De standaardwaarde is undefined (indicates not set).

Verwante API-elementen

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:

De standaardwaarde is flash.text.GridFitType.PIXEL.

Verwante API-elementen

Bevat de HTML-representatie van de inhoud van het tekstveld.

TLFTextField-instanties ondersteunen de volgende HTML-tags:

Flash ondersteunt tevens expliciete tekencodes, zoals & (ASCII-ampersand) en € (€-teken Unicode).

Verwante API-elementen

Het aantal tekens in een tekstveld. Een teken zoals tab (\t) telt als één teken.

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.

De maximumwaarde van scrollH.

Verwante API-elementen

De maximumwaarde van scrollV.

Verwante API-elementen

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 eigenschap is nuttig wanneer u wilt voorkomen dat met het muiswiel door tekstvelden wordt geschoven of u uw eigen schuifmethode voor tekstvelden wilt implementeren.

De standaardwaarde is true.

Geeft aan of het tekstveld 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.

Verwante API-elementen

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.

Verwante API-elementen

Onderste inzet in pixels (neemt de standaardwaarde over als deze tijdens de trapsgewijze opmaak niet gedefinieerd is). De ruimte tussen de onderste rand van de container en de tekst. De waarde is een getal.

Bij horizontale tekst wordt de opvulling in de eerste en alle volgende kolommen in schuifbare containers met meerdere kolommen weergegeven als een lege ruimte onder aan de container. Bij de laatste kolom moet u, als de tekst niet helemaal past, mogelijk echter schuiven om de opvulling te zien.

Een geldige waarde is een getal tussen 0 en 1000 of flashx.textLayout.formats.FormatValue.INHERIT.

Als deze eigenschap niet tijdens de trapsgewijze opmaak gedefinieerd is, heeft deze de waarde 0.

De standaardwaarde is undefined (indicates not set).

Verwante API-elementen

Inzet links in pixels (neemt de standaardwaarde over als deze tijdens de trapsgewijze opmaak niet gedefinieerd is). De ruimte tussen de linkerrand van de container en de tekst. De waarde is een getal.

Bij verticale tekst wordt de opvulling in de eerste en alle volgende kolommen in schuifbare containers met meerdere kolommen weergegeven als een lege ruimte onder aan de container. Bij de laatste kolom moet u, als de tekst niet helemaal past, mogelijk echter schuiven om de opvulling te zien.

Een geldige waarde is een getal tussen 0 en 1000 of flashx.textLayout.formats.FormatValue.INHERIT.

Als deze eigenschap niet tijdens de trapsgewijze opmaak gedefinieerd is, heeft deze de waarde 0.

De standaardwaarde is undefined (indicates not set).

Verwante API-elementen

Inzet rechts in pixels (neemt de standaardwaarde over als deze tijdens de trapsgewijze opmaak niet gedefinieerd is). De ruimte tussen de rechterrand van de container en de tekst. De waarde is een getal.

Een geldige waarde is een getal tussen 0 en 1000 of flashx.textLayout.formats.FormatValue.INHERIT.

Als deze eigenschap niet tijdens de trapsgewijze opmaak gedefinieerd is, heeft deze de waarde 0.

De standaardwaarde is undefined (indicates not set).

Verwante API-elementen

Bovenste inzet in pixels (neemt de standaardwaarde over als deze tijdens de trapsgewijze opmaak niet gedefinieerd is). De ruimte tussen de bovenrand van de container en de tekst. De waarde is een getal.

Een geldige waarde is een getal tussen 0 en 1000 of flashx.textLayout.formats.FormatValue.INHERIT.

Als deze eigenschap niet tijdens de trapsgewijze opmaak gedefinieerd is, heeft deze de waarde 0.

De standaardwaarde is undefined (indicates not set).

Verwante API-elementen

Haalt het teken op of stelt het teken in dat wordt gebruikt voor het verbergen van tekens in een wachtwoordblok.

De maximumwaarde van pixelScrollV Als eenheid voor pixelMaxScrollV worden pixels gebruikt, anders dan de eigenschap maxScrollV die is gebaseerd op regels.

De verticale positie van tekst in een tekstveld, anders dan de eigenschap scrollV die is gebaseerd op regels. De eigenschap pixelScrollV is handig voor het gelijkmatig schuiven door een tekstveld naar een bepaalde positie.

Verwante API-elementen

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.

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.

Verwante API-elementen

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.

Verwante API-elementen

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 het kan worden bewerkt. In tegenstelling tot een klassiek dynamisch of invoertekstveld, kan een TLF-tekstveld dat bewerkbaar is, altijd worden geselecteerd. Als deze eigenschap op false en het invoertype op dynamisch is ingesteld, 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.

De standaardwaarde is true.

Verwante API-elementen

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.

Verwante API-elementen

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.

Verwante API-elementen

Scherpte is niet van toepassing op TLF TextFields. Opgegeven waarden worden genegeerd en er wordt altijd nul geretourneerd.

Opmaakmodellen voor het TLF TextField.

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.

Verwante API-elementen

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).

Gebruik deze eigenschap om opmaak toe te wijzen vanaf de TLF-klassen in de flashx-pakketten aan de TLFTextField-instantie. Bijvoorbeeld:

		 var myFormat:TextLayoutFormat = new TextLayoutFormat();
		 myFormat.textIndent = 8;
		 myFormat.color = 0x336633;
		 myFormat.fontFamily = "Arial, Helvetica, _sans";
		 myFormat.fontSize = 24;
		 
		 var myTextFlow:TextFlow = myTLFTextField.textFlow;
		 myTextFlow.hostFormat = myFormat;
		 

Verwante API-elementen

De hoogte van de tekst in pixels. De opvulling aan de boven- en onderkant bevinden zich niet in deze waarde.

Verwante API-elementen

De breedte van de tekst in pixels. De opvulling aan de rechter- en linkerkant bevinden zich niet in deze waarde.

Verwante API-elementen

De eigenschap Dikte is niet van toepassing op het TLF TextField. Opgegeven waarden worden genegeerd en er wordt altijd nul geretourneerd.

Stelt de TLF-opmaakcode van de tekst in of haalt deze op in het TLF-tekstveld.

De opmaakspecificatie is gepubliceerd op http://sourceforge.net/projects/tlf.adobe/files/docs/TLF_2.0_specification.pdf/download.

Verwante API-elementen

Het type tekstveld. Een van de volgende TextFieldType-constanten: TextFieldType.DYNAMIC, die een selecteerbaar TLF-tekstveld opgeeft dat niet kan worden bewerkt door een gebruiker, of TextFieldType.INPUT, dat een bewerkbaar TLF-tekstveld opgeeft dat wel kan worden bewerkt door een gebruiker.

De standaardwaarde is dynamic.

Verwante API-elementen

Geeft aan of behalve de tekst ook de opmaak ervan naar het klembord wordt gekopieerd. Wanneer ingesteld op true, kopieert Flash Player de opmaak (zoals uitlijning, vet en cursief) in tlfMarkup-opmaak naar het klembord.

De standaardwaarde is false.

Verwante API-elementen

Verticale uitlijning of uitvulling (neemt de standaardwaarde over als deze tijdens de trapsgewijze opmaak niet gedefinieerd is). Bepaalt hoe TextFlow-elementen worden uitgelijnd in de container.

Geldige waarden zijn flashx.textLayout.formats.VerticalAlign.TOP, flashx.textLayout.formats.VerticalAlign.MIDDLE, flashx.textLayout.formats.VerticalAlign.BOTTOM, flashx.textLayout.formats.VerticalAlign.JUSTIFY, flashx.textLayout.formats.FormatValue.INHERIT.

Als deze eigenschap niet tijdens de trapsgewijze opmaak gedefinieerd is, heeft deze de waarde TOP.

De standaardwaarde is undefined (indicates not set).

Verwante API-elementen