Freigeben über

TextRun Klasse

  • Referenz

Definition

Namespace:
System.Windows.Media.TextFormatting
Assembly:
PresentationCore.dll

Stellt eine Sequenz von Zeichen dar, die gemeinsam einen einzelnen Eigenschaftensatz verwenden.

public ref class TextRun abstract
public abstract class TextRun
type TextRun = class
Public MustInherit Class TextRun
Vererbung
Object
TextRun
Abgeleitet

Beispiele

Im folgenden Beispiel wird eine Außerkraftsetzung für die GetTextRun Methode implementiert.

// 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

Hinweise

Eine Textausführung ist eine Reihe von Zeichen, die einen einzelnen Eigenschaftssatz freigeben. Alle Änderungen an dem Format, z. B. Schriftformat, Vordergrundfarbe, Schriftartfamilie oder andere Formatierungseffekte, brechen die Textausführung. Im folgenden Beispiel wird veranschaulicht, wie Änderungen in der Formatierung in einer Textzeichenfolge zu einer Reihe von Textausführungen führen – jede Textausführung verfügt über einen allgemeinen Satz von Formatierungseigenschaften.

Die TextRun Klasse ist der Stamm einer Typhierarchie, die mehrere Arten von Textinhalten darstellt, die von TextFormatter. Jede Klasse, die von TextRun einem abgeleitet wird, stellt einen bestimmten Textinhaltstyp dar.

Klasse BESCHREIBUNG
TextRun Stamm der Hierarchie. Definiert eine Gruppe von Zeichen, die dieselbe Gruppe von Zeicheneigenschaften freigeben.
TextCharacters Definiert eine Auflistung von Zeichenglyphen aus einem unterschiedlichen physischen Typface.
TextEmbeddedObject Definiert einen Textinhaltstyp, in dem Mess-, Treffertests und Zeichnung des gesamten Inhalts als unterschiedliche Entität ausgeführt werden. Ein Beispiel für diesen Inhaltstyp ist eine Schaltfläche in der Mitte der Textzeile.
TextEndOfLine Definiert einen Zeilenumbruchzeichencode.
TextEndOfParagraph Definiert einen Absatztrennzeichencode. Wird von TextEndOfLineabgeleitet.
TextEndOfSegment Definiert eine Segmentbruchmarkierung.
TextHidden Definiert einen Bereich nicht sichtbarer Zeichen.
TextModifier Definiert den Anfang eines Änderungsbereichs.

Konstruktoren

TextRun()

Erstellt eine Instanz eines TextRun-Objekts.

Eigenschaften

CharacterBufferReference

Ruft einen Verweis auf den Lauftextzeichenpuffer ab.
Length

Ruft die Anzahl der Zeichen im Lauftext ab.
Properties

Ruft den Satz der Texteigenschaften, z. B. Schriftart oder Vordergrundpinsel, ab, die von allen Zeichen im Lauftext gemeinsam verwendet werden.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für

Siehe auch