TextBlock  - AS3

Geeft aan of u de weergave op het scherm wilt verbeteren ten koste van de WYSIWYG-afdrukkwaliteit (what-you-see-is-what-you-get). Op platformen en bij lettertypen die geen ondersteuning bieden voor subpixel glyph-positionering bij de rendering van apparaatlettertypen, maar die wel ondersteuning bieden voor niet-lineaire schaling, kunt u door de waarde van deze eigenschap in te stellen op true het gebruik van deze metrische waarden inschakelen. (Houd hierbij rekening met een afname in WYSIWYG-afdrukkwaliteit, met name bij kleine puntgrootten.) Bij niet-lineaire schaling van lettertypen wordt de breedte van individuele glyphs selectief geschaald om lelijke gaten te verbergen die worden veroorzaakt door magnetische pixeluitlijning.

Deze markering wordt genegeerd bij platformen die wel ondersteuning bieden voor subpixel glyph-positionering.

Deze markering is niet van invloed op de rendering van het ingesloten lettertype.

De standaardwaarde is true.

Het lettertype dat wordt gebruikt om de basislijnen voor alle regels die voor het blok zijn gemaakt te bepalen, onafhankelijk van de inhoud ervan. Basislijnen zijn afhankelijk van lettertype en lettergrootte.

De standaardwaarde is null. Wanneer het basislijnlettertype null is, wordt de lettergrootte van de basislijn genegeerd en wordt de basislijn voor elke regel gebaseerd op lettertype en lettergrootte van de grootste tekst op de regel. Wanneer u zowel baselineFontDescription als baselineFontSize opgeeft, worden hiermee de basislijnen bepaalt voor alle regels in het tekstblok, onafhankelijk van de inhoud. Deze combinatie is vaak handig bij Aziatische typografie.

Verwante API-elementen

De lettergrootte die wordt gebruikt om de basislijnen te berekenen voor de regels die vanaf het blok zijn gemaakt. Basislijnen zijn afhankelijk van lettertype en lettergrootte.

De standaardwaarde is 12. Wanneer het basislijnlettertype null is, wordt de lettergrootte van de basislijn genegeerd en wordt de basislijn voor elke regel gebaseerd op lettertype en lettergrootte van de grootste tekst op de regel.

Verwante API-elementen

Geeft aan welke basislijn y=0 is voor alle regels die zijn gemaakt van dit blok. Geldige waarden voor deze eigenschap zijn te vinden onder de leden van de klasse TextBaseline.

De standaardwaarde is TextBaseline.ROMAN.

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

Verwante API-elementen

Geeft het bidirectionele alinea-insluitingsniveau aan van het tekstblok. Over het algemeen gebruikt u de waarde 0 voor alinea's waarin tekst van links naar rechts wordt geschreven (Nederlands, Engels, Japans, enzovoort) en de waarde 1 voor alinea's waarin tekst van rechts naar links wordt geschreven (Arabisch, Hebreeuws, enzovoort). Het gebruik van andere waarden dan 0 of 1 is gereserveerd voor speciale gevallen. Zie UAX#9, "Bidirectioneel Unicode-algoritme" (http://www.unicode.org/reports/tr9/) voor meer informatie.

De standaardwaarde is 0.

Als bidiLevel wordt gewijzigd, verandert de geldigheid van alle eerder afgebroken regels in TextLineValidity.INVALID. Nadat bidiLevel is gewijzigd, is de eigenschap firstInvalidLine gelijk aan de eigenschap firstLine en moet u alle regels in het tekstblok opnieuw afbreken.

Verwante API-elementen

package {
    
    import flash.display.Sprite;
    import flash.text.engine.TextBlock;
    import flash.text.engine.TextElement;
    import flash.text.engine.TextLine;
    import flash.text.engine.ElementFormat;
    import flash.text.engine.FontDescription;
    
    public class TextBlock_bidiLevelExample extends Sprite {
        
        public function TextBlock_bidiLevelExample():void {             
            var fontSize:Number = 36;

            var format:ElementFormat = new ElementFormat();        
            format.fontDescription = new FontDescription("Adobe Hebrew");
            format.fontSize = fontSize;
            var y:Number = 0;
            var leading:Number = fontSize * 0.2;
            var text:String = "abc" + String.fromCharCode(0x05D0, 0x05D1, 0x05D2);

            var textBlock:TextBlock = new TextBlock();
            textBlock.content = new TextElement(text, format);
                        
            // bidiLevel even
            textBlock.bidiLevel = 0;
            var textLine = textBlock.createTextLine(null, 400);
            y += leading + textLine.ascent;
            textLine.y = y;
            y += textLine.descent;
            addChild(textLine);      
            
            // bidiLevel odd
            textBlock.content = new TextElement(text, format);
            textBlock.bidiLevel = 1;
            textLine = textBlock.createTextLine(null, 400);
            y += leading + textLine.ascent;          
            textLine.y = y;
            addChild(textLine);   
        }
    }
}

Bevat de inhoud van het tekstblok. Omdat ContentElement is een basisklasse is, wijst u aan content een instantie toe van een subklasse van ContentElement: TextElement, GraphicElement of GroupElement. Een TextElement-object bevat een String, een GraphicElement-object bevat een DisplayObject en een GroupElement bevat een Vector-object dat een of meer TextElement-objecten, GraphicElement-objecten of andere GroupElement-objecten bevat. Gebruik een TextElement voor een alinea met uitsluitend tekst, een GraphicElement voor een afbeelding en een GroupElement voor een combinatie van tekst en grafische elementen of meerdere instanties van deze elementen en andere GroupElement-objecten.

De standaardwaarde is null.

Als u de eigenschap content wijzigt, verandert de geldigheid van alle eerder gemaakte regels in TextLineValidity.INVALID. Nadat content is gewijzigd, is de eigenschap firstInvalidLine gelijk aan de eigenschap firstLine en moet u alle regels in het tekstblok opnieuw afbreken.

Verwante API-elementen

Geeft de eerste regel in het tekstblok aan waarvoor TextLine.validity niet gelijk is aan TextLineValidity.VALID.

De standaardwaarde is null.

Verwante API-elementen

De eerste eventuele TextLine in het TextBlock.

De standaardwaarde is null.

Verwante API-elementen

De laatste eventuele TextLine in het TextBlock.

De standaardwaarde is null.

Verwante API-elementen

De tekstregels in het tekstblok worden als een eenheid gedraaid. Roep de methode createTextLine() na het instellen van lineRotation aan om de wijziging door te voeren. De standaardwaarde is TextRotation.ROTATE_0.

De laatste rotatie van een glyph is afhankelijk van de waarden van ElementFormat.textRotation, ContentElement.textRotation en TextBlock.lineRotation.

TextBlock.lineRotation wordt gewoonlijk gebruikt voor Aziatische tekst. Ga als volgt te werk om een alinea met verticale Japanse tekst te maken:

1. Stel de eigenschap TextBlock.lineRotation in op TextRotation.ROTATE_90.
2. Houd de eigenschap ElementFormat.textRotation van de inhoud als de standaardinstelling, TextRotation.AUTO.

Gebruik de volgende constanten, die in de klasse TextRotation zijn gedefinieerd, om de waarde voor deze eigenschap in te stellen:

Verwante API-elementen

package {
    import flash.display.Sprite;
    import flash.text.engine.FontDescription;
    import flash.text.engine.TextBlock;
    import flash.text.engine.TextElement;
    import flash.text.engine.TextLine;
    import flash.text.engine.TextRotation;
    import flash.text.engine.ElementFormat;
    
    public class TextBlock_lineRotationExample extends Sprite {
        
        public function TextBlock_lineRotationExample():void {
            var Japanese:String = String.fromCharCode(
                0x5185, 0x95A3, 0x5E9C, 0x304C, 0x300C, 0x653F, 0x5E9C, 0x30A4,
                0x30F3, 0x30BF, 0x30FC, 0x30CD, 0x30C3, 0x30C8, 0x30C6, 0x30EC, 
                0x30D3, 0x300D, 0x306E, 0x52D5, 0x753B, 0x914D, 0x4FE1, 0x5411, 
                0x3051, 0x306B, 0x30A2, 0x30C9, 0x30D3, 0x30B7, 0x30B9, 0x30C6, 
                0x30E0, 0x30BA, 0x793E, 0x306E
            ) +
            "FMS 2" +
            String.fromCharCode(0x3092, 0x63A1, 0x7528, 0x3059, 0x308B, 0x3068, 
                0x767a, 0x8868, 0x3057, 0x307e, 0x3057, 0x305F, 0x3002);

            var fontDescription:FontDescription = new FontDescription("MS Mincho");
            var format:ElementFormat = new ElementFormat();
            format.fontSize = 15;
            format.fontDescription = fontDescription;
                        
            var textElement:TextElement = new TextElement(Japanese, format); 
            var textBlock:TextBlock = new TextBlock();
            textBlock.content = textElement;
            textBlock.lineRotation = TextRotation.ROTATE_90;

            var linePosition:Number = this.stage.stageWidth - 120;
            var previousLine:TextLine = null;
        
            while (true) {
                var textLine:TextLine = textBlock.createTextLine(
                    previousLine, 
                    300);
                if (textLine == null) 
                    break;
                textLine.y = 30;    
                textLine.x = linePosition;
                linePosition -= 24;
                addChild(textLine);                
                previousLine = textLine;
            }        
        }
    }
}

Geeft de tabstops voor de tekst in het tekstblok aan, in de vorm van een Vector van TabStop-objecten.

De standaardwaarde is null, wat betekent dat er geen tabstops zijn opgegeven. Als er geen tabstops zijn opgegeven (of het invoegpunt na de laatst opgegeven tabstop ligt) maakt de runtime standaard tabs van één centimeter.

Als de eigenschap tabStops is ingesteld, maakt het TextBlock een kopie van het Vector-object voor intern gebruik. Het aanpassen van het originele Vector-object of de inhoud daarvan heeft geen invloed op het TextBlock. Als de eigenschap tabStops wordt opgevraagd, wordt er een kopie van het interne Vector-object geretourneerd. Het aanpassen van dit geretourneerde Vector-object heeft evenmin invloed op het TextBlock.

Verwante API-elementen

Geeft aan welke TextJustifier moet worden gebruikt voor het maken van regels.

De standaardwaarde is een geconstrueerd standaard TextJustifier-object.

Als de eigenschap textJustifier is ingesteld, maakt het TextBlock een kopie van het object voor intern gebruik. Het aanpassen van het originele object heeft geen invloed op het TextBlock. Als de eigenschap textJustifier wordt opgevraagd, wordt er een kopie van het interne object geretourneerd. Het aanpassen van het geretourneerde object heeft evenmin invloed op het TextBlock.

Verwante API-elementen

Geeft het resultaat van een createTextLine()-bewerking aan. Als u de inhoud van het blok wijzigt, worden de eerder afgebroken regels ongeldig en wordt deze eigenschap opnieuw ingesteld op null.

De standaardwaarde is null.

Waarden voor deze eigenschap bevinden zich in TextLineCreationResult

Verwante API-elementen

Hiermee kan de toepassing willekeurige gegevens aan het tekstblok koppelen. De gegevens kunnen verwijzen naar de inhoud, zoals een herzieningsdatum of de naam van de auteur, of het kunnen gegevens in de cache zijn die u tijdens de verwerking gebruikt.

Hiermee wordt een object TextBlock gemaakt.

Verwante API-elementen

Instrueert het tekstblok om een regel tekst uit de inhoud te maken, vanaf het punt dat is aangegeven door de parameter previousLine tot het punt dat door de parameter width wordt aangegeven. De tekstregel is een TextLine-object dat u aan de weergavelijst kunt toevoegen.

Als u regels laat doorlopen in een tekstblok waar al tekstdoorloop aanwezig is, kan dit de geldigheidsstatus van regels wijzigen in en buiten het gebied van de tekstdoorloop. De status van regels kan van VALID veranderen in INVALID of in POSSIBLY_INVALID. Als een zojuist afgebroken regel perfect is uitgelijnd met een eerder afgebroken regel met de status POSSIBLY_INVALID, verandert de status van die eerder afgebroken regel en alle volgende regels met status POSSIBLY_INVALID terug naar de status VALID. De geldigheid van regels die op waarden zijn ingesteld die geen lid zijn van TextLineValidity verandert niet in VALID, maar kan wel veranderen in INVALID. Controleer de eigenschap firstInvalidLine na elke wijziging in het tekstblok om te zien waar u moet beginnen of moet doorgaan met het opnieuw afbreken van tekstregels.

U kunt woorden kunstmatig afbreken door het Unicode-teken ZWSP (Zero Width Space) in de tekst op te nemen. Dit kan nuttig zijn voor talen als Thai, waarvoor een dictionary nodig is om regels correct af te breken. De Flash-runtime bevat deze bibliotheek niet.

Om geheugenoverhead te beperken, wanneer alle gewenste lijnen zijn gemaakt, behalve als wordt verwacht dat alle lijnen herhaaldelijk opnieuw gebroken worden doordat, bijvoorbeeld, de grootte van de container opnieuw wordt vastgesteld, moet de gebruiker de releaseLineCreationData()-methode oproepen, waardoor het tekstblok kan beschikken over tijdelijke gegevens die betrekking hebben op regelafbreking.

Parameters

Verwante API-elementen

package {
    import flash.display.Sprite;
    import flash.text.engine.TextBlock;
    import flash.text.engine.TextElement;
    import flash.text.engine.TextLine;
    import flash.text.engine.ElementFormat;
    import flash.text.engine.FontDescription;
    
    public class TextBlock_createTextLineExample extends Sprite {
        
        public function TextBlock_createTextLineExample():void {
            
            var str:String = "I am a TextElement, created from a String and assigned " +
            "to the content property of a TextBlock. The createTextLine() method " +
            "then created these lines, 300 pixels wide, for display." ;
            
            var fontDescription:FontDescription = new FontDescription("Arial");
            var format:ElementFormat = new ElementFormat(fontDescription);
            format.fontSize = 16;
            var textElement:TextElement = new TextElement(str, format); 
            var textBlock:TextBlock = new TextBlock();
            textBlock.content = textElement; 
            createLines(textBlock); 
        }
        
        private function createLines(textBlock:TextBlock):void 
        {            
            var lineWidth:Number = 300;
            var xPos:Number = 15.0;
            var yPos:Number = 20.0;
            
            var textLine:TextLine = textBlock.createTextLine (null, lineWidth);
            while (textLine)
            {
                textLine.x = xPos;
                textLine.y = yPos;
                yPos += textLine.height + 2;
                addChild (textLine);
                textLine = textBlock.createTextLine (textLine, lineWidth);
            }
        }
    }
}

Dumpt de onderliggende inhoud van het TextBlock als een XML-reeks. Dit kan nuttig zijn bij geautomatiseerd testen en bevat tekst-, opmaak- en renderinginformatie.

Hieronder wordt de uitvoer beschreven:

	 >block<
	 	[0-N LINE]
	 >/block<
	 

Zie de methode TextLine.dump() voor een beschrijving van de uitvoer voor elke regel.

Opmerking: De inhoud en opmaak van de uitvoer kunnen in de toekomst veranderen. Achterwaartse compatibiliteit van deze methode wordt door Adobe niet gegarandeerd.

Verwante API-elementen

Vindt de index van de volgende atoomgrens vanaf de opgegeven tekenindex, exclusief het teken bij de opgegeven index. De tekens tussen atoomgrenzen worden gecombineerd tot een atoom in een TextLine, zoals een 'e' met een accent aigu.

Parameters

Verwante API-elementen

Vindt de index van de volgende woordgrens vanaf de opgegeven tekenindex, exclusief het teken bij de opgegeven index. Woordgrenzen worden bepaald op basis van de Unicode-eigenschappen van de tekens.

Parameters

Vindt de index van de vorige atoomgrens tot aan de opgegeven tekenindex, exclusief het teken bij de opgegeven index. De tekens tussen atoomgrenzen worden gecombineerd tot een atoom in een TextLine, zoals een 'e' met een accent aigu.

Parameters

Verwante API-elementen

Vindt de index van de vorige woordgrens tot aan de opgegeven tekenindex, exclusief het teken bij de opgegeven index. Woordgrenzen worden bepaald op basis van de Unicode-eigenschappen van de tekens.

Parameters

Hiermee wordt de TextLine geretourneerd met het teken dat door de parameter charIndex is opgegeven.

Parameters

Instrueert het tekstblok om een bestaande tekstregel opnieuw te gebruiken voor het maken van een tekstregel uit de inhoud, te beginnen vanaf het punt dat wordt aangegeven door de parameter previousLine tot het punt dat wordt aangegeven door de parameter width. De tekstregel is een TextLine-object dat u aan de weergavelijst kunt toevoegen. Door een bestaande tekstregel opnieuw te gebruiken worden er minder objecten gemaakt, met als gevolg betere prestaties.

De textLine die opnieuw wordt gemaakt, wordt indien van toepassing vrijgegeven uit het tekstblok waarin de textLine zich bevindt. Bovendien worden alle eigenschappen, inclusief overgenomen eigenschappen van DisplayObjectContainer, InteractiveObject en DisplayObject, teruggezet naar hun standaardwaarden. Ten slotte worden alle onderliggende elementen van de regel verwijderd, waaronder grafische elementen en andere decoratieve elementen. Ook worden alle gebeurtenislisteners van de regel verwijderd. De regel zelf wordt niet uit het bovenliggende element verwijderd. Ter verbetering van de prestaties is dit de enige uitzondering op deze complete terugzetting naar de standaardwaarden

Als u regels laat doorlopen in een tekstblok waar al tekstdoorloop aanwezig is, kan dit de geldigheidsstatus van regels wijzigen in en buiten het gebied van de tekstdoorloop. De status van regels kan van VALID veranderen in INVALID of in POSSIBLY_INVALID. Als een zojuist afgebroken regel perfect is uitgelijnd met een eerder afgebroken regel met de status POSSIBLY_INVALID, verandert de status van die eerder afgebroken regel en alle volgende regels met status POSSIBLY_INVALID terug naar de status VALID. De geldigheid van regels die op waarden zijn ingesteld die geen lid zijn van TextLineValidity verandert niet in VALID, maar kan wel veranderen in INVALID. Controleer de eigenschap firstInvalidLine na elke wijziging in het tekstblok om te zien waar u moet beginnen of moet doorgaan met het opnieuw afbreken van tekstregels.

U kunt woorden kunstmatig afbreken door het Unicode-teken ZWSP (Zero Width Space) in de tekst op te nemen. Dit kan nuttig zijn voor talen als Thai, waarvoor een dictionary nodig is om regels correct af te breken. De Flash-runtime bevat deze bibliotheek niet.

Om geheugenoverhead te beperken, wanneer alle gewenste lijnen zijn gemaakt, behalve als wordt verwacht dat alle lijnen herhaaldelijk opnieuw gebroken worden doordat, bijvoorbeeld, de grootte van de container opnieuw wordt vastgesteld, moet de gebruiker de releaseLineCreationData()-methode oproepen, waardoor het tekstblok kan beschikken over tijdelijke gegevens die betrekking hebben op regelafbreking.

Parameters

Verwante API-elementen

var elementFormat:ElementFormat = new ElementFormat();
elementFormat.fontDescription = new FontDescription("Arial");
elementFormat.fontSize = 48;

var textElement:TextElement = new TextElement("Text you'll never see", elementFormat)
var textBlock:TextBlock = new TextBlock(textElement);
var textLine:TextLine = textBlock.createTextLine();
textLine.x = 50;
textLine.y = 50;
addChild(textLine);

// Reuse the element format to preserve the text formatting
var elementTwo:TextElement = new TextElement("Text you see", elementFormat);  
textBlock.content = elementTwo;
textBlock.recreateTextLine(textLine);

// Set the position (and any other display object properties like alpha, children, etc.)
// otherwise, they're all set to default properties.
textLine.x = 50;  
textLine.y = 50;

Geeft het tekstblok de opdracht om alle tijdelijke gegevens vrij te geven die gekoppeld zijn aan de creatie van tekstregels. Als u het geheugengebruik van een toepassing wilt minimaliseren, kunt u de methode releaseLineCreationData() aanroepen wanneer u klaar bent met het maken van tekstregels van een tekstblok. Voor de beste resultaten bij het opnieuw afbreken van regels (bijvoorbeeld wanneer de afmetingen van de container worden gewijzigd) kunt u de methode releaseLineCreationData() beter niet aanroepen. De toepassing bepaalt de balans tussen geheugen en prestaties.

Het volgende proces wordt aanbevolen voor tekst die waarschijnlijk niet wordt gewijzigd: initialiseer een tekstblok, roep zo vaak mogelijk de methode createTextLine() aan om de gewenste uitvoer te krijgen en roep vervolgens de methode releaseLineCreationData() aan.

Verwante API-elementen

Verwijdert een aantal tekstregels uit de lijst met regels die door het TextBlock wordt bijgehouden. Hierdoor kunnen de regels worden opgeschoond als er geen andere verwijzingen bestaan.

Stelt de leden textBlock, nextLine en previousLine van de verwijderde regels in op null. Stelt de validity van de verwijderde regels en van alle regels die na de verwijderde regels in het TextBlock volgen in op TextLineValidity.INVALID.

Parameters

Verwante API-elementen