TextRun Klass

Definition

Namnområde:
System.Windows.Media.TextFormatting
Sammansättning:
PresentationCore.dll

Representerar en sekvens med tecken som delar en enda egenskapsuppsättning.

public ref class TextRun abstract
public abstract class TextRun
type TextRun = class
Public MustInherit Class TextRun
Arv
Object
TextRun
Härledda

Exempel

I följande exempel implementeras en åsidosättning för GetTextRun metoden.

// Retrieve the next formatted text run for the text source.
public override TextRun GetTextRun(int textSourceCharacterIndex)
{
    // Determine whether the text source index is in bounds.
    if (textSourceCharacterIndex < 0)
    {
        throw new ArgumentOutOfRangeException("textSourceCharacterIndex", "Value must be greater than 0.");
    }

    // Determine whether the text source index has exceeded or equaled the text source length.
    if (textSourceCharacterIndex >= _text.Length)
    {
        // Return an end-of-paragraph indicator -- a TextEndOfParagraph object is a special type of text run.
        return new TextEndOfParagraph(1);
    }

    // Create and return a TextCharacters object, which is formatted according to
    // the current layout and rendering properties.
    if (textSourceCharacterIndex < _text.Length)
    {
        // The TextCharacters object is a special type of text run that contains formatted text.
        return new TextCharacters(
           _text,                                       // The text store
           textSourceCharacterIndex,                    // The text store index
           _text.Length - textSourceCharacterIndex,     // The text store length
           new CustomTextRunProperties());              // The layout and rendering properties
    }

    // Return an end-of-paragraph indicator if there is no more text source.
    return new TextEndOfParagraph(1);
}

' Retrieve the next formatted text run for the text source.
Public Overrides Function GetTextRun(ByVal textSourceCharacterIndex As Integer) As TextRun
    ' Determine whether the text source index is in bounds.
    If textSourceCharacterIndex < 0 Then
        Throw New ArgumentOutOfRangeException("textSourceCharacterIndex", "Value must be greater than 0.")
    End If

    ' Determine whether the text source index has exceeded or equaled the text source length.
    If textSourceCharacterIndex >= _text.Length Then
        ' Return an end-of-paragraph indicator -- a TextEndOfParagraph object is a special type of text run.
        Return New TextEndOfParagraph(1)
    End If

    ' Create and return a TextCharacters object, which is formatted according to
    ' the current layout and rendering properties.
    If textSourceCharacterIndex < _text.Length Then
        ' The TextCharacters object is a special type of text run that contains formatted text.
        Return New TextCharacters(_text, textSourceCharacterIndex, _text.Length - textSourceCharacterIndex, New CustomTextRunProperties()) ' The layout and rendering properties -  The text store length -  The text store index -  The text store
    End If

    ' Return an end-of-paragraph indicator if there is no more text source.
    Return New TextEndOfParagraph(1)
End Function

Kommentarer

En textkörning är en sekvens med tecken som delar en enda egenskapsuppsättning. Alla ändringar i formatet, till exempel teckensnittsstil, förgrundsfärg, teckensnittsfamilj eller någon annan formateringseffekt, bryter textkörningen. I följande exempel visas hur ändringar i formateringen i en textsträng resulterar i en serie textkörningar – varje textkörning har en gemensam uppsättning formateringsegenskaper.

Klassen TextRun är roten i en typhierarki som representerar flera typer av textinnehåll som bearbetas av TextFormatter. Varje klass som härleds från TextRun representerar en distinkt typ av textinnehåll.

Class Description
TextRun Hierarkins rot. Definierar en grupp med tecken som delar samma uppsättning teckenegenskaper.
TextCharacters Definierar en samling teckengenlyfer från ett distinkt fysiskt typsnitt.
TextEmbeddedObject Definierar en typ av textinnehåll där mätning, träfftestning och ritning av hela innehållet görs som en distinkt entitet. Ett exempel på den här typen av innehåll är en knapp i mitten av textraden.
TextEndOfLine Definierar en radbrytningsteckenkod.
TextEndOfParagraph Definierar en styckebrytningsteckenkod. Härleds från TextEndOfLine.
TextEndOfSegment Definierar en brytmarkör för segment.
TextHidden Definierar ett intervall med icke-synliga tecken.
TextModifier Definierar början av ett ändringsomfång.

Konstruktorer

Name Description
TextRun()

Skapar en instans av ett TextRun objekt.

Egenskaper

Name Description
CharacterBufferReference

Hämtar en referens till textkörningsteckenbufferten.
Length

Hämtar antalet tecken i textkörningen.
Properties

Hämtar den uppsättning textegenskaper som delas av varje tecken i textkörningen, till exempel typsnitt eller förgrundspenslar.

Metoder

Name Description
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)

Gäller för

Se även