Udostępnij za pośrednictwem

TextRun Klasa

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Media.TextFormatting
Zestaw:
PresentationCore.dll

Reprezentuje sekwencję znaków współużytkujących pojedynczy zestaw właściwości.

public ref class TextRun abstract
public abstract class TextRun
type TextRun = class
Public MustInherit Class TextRun
Dziedziczenie
Object
TextRun
Pochodne

Przykłady

W poniższym przykładzie zaimplementowano zastąpienie metody GetTextRun .

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

Uwagi

Przebieg tekstu to sekwencja znaków współużytkowania pojedynczego zestawu właściwości. Wszelkie zmiany w formacie, takie jak styl czcionki, kolor pierwszego planu, rodzina czcionek lub dowolny inny efekt formatowania, przerywa przebieg tekstu. W poniższym przykładzie pokazano, jak zmiany formatowania w ciągu tekstowym są wynikiem serii przebiegów tekstu — każdy przebieg tekstu ma wspólny zestaw właściwości formatowania.

Klasa TextRun jest katalogiem głównym hierarchii typów reprezentującej kilka typów zawartości tekstowej przetworzonej przez TextFormatterprogram . Każda klasa pochodząca z TextRun klasy reprezentuje odrębny typ zawartości tekstowej.

Klasa Opis
TextRun Katalog główny hierarchii. Definiuje grupę znaków, które mają ten sam zestaw właściwości znaków.
TextCharacters Definiuje kolekcję symboli znaków na podstawie odrębnej fizycznej czcionki.
TextEmbeddedObject Definiuje typ zawartości tekstowej, w której miara, testowanie trafień i rysowanie całej zawartości odbywa się jako odrębna jednostka. Przykładem tego typu zawartości jest przycisk w środku wiersza tekstu.
TextEndOfLine Definiuje kod znaku podziału wiersza.
TextEndOfParagraph Definiuje kod znaku podziału akapitu. Pochodzi z klasy TextEndOfLine.
TextEndOfSegment Definiuje znacznik podziału segmentu.
TextHidden Definiuje zakres znaków, które nie są widoczne.
TextModifier Definiuje początek zakresu modyfikacji.

Konstruktory

TextRun()

Tworzy wystąpienie TextRun obiektu.

Właściwości

CharacterBufferReference

Pobiera odwołanie do bufora znaków przebiegu tekstu.
Length

Pobiera liczbę znaków w przebiegu tekstu.
Properties

Pobiera zestaw właściwości tekstu, które są współużytkowane przez każdy znak w przebiegu tekstu, takie jak czcionka lub pędzel pierwszego planu.

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Dotyczy

Zobacz też