TextSource.GetTextRun(Int32) Metoda

Reference

Definice

Obor názvů:: System.Windows.Media.TextFormatting

Sestavení:: PresentationCore.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Načte TextRun počáteční hodnotu na zadané TextSource pozici.

public:
 abstract System::Windows::Media::TextFormatting::TextRun ^ GetTextRun(int textSourceCharacterIndex);

public abstract System.Windows.Media.TextFormatting.TextRun GetTextRun (int textSourceCharacterIndex);

abstract member GetTextRun : int -> System.Windows.Media.TextFormatting.TextRun

Public MustOverride Function GetTextRun (textSourceCharacterIndex As Integer) As TextRun

Parametry

textSourceCharacterIndex: Int32

Určuje pozici indexu znaků v TextSource místě, kde se načte TextRun .

Návraty

TextRun

Hodnota, která představuje TextRunobjekt nebo objekt odvozený z TextRun.

Příklady

V následujícím příkladu GetTextRun se implementuje přepsání metody.

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

Poznámky

Spuštění textu je posloupnost znaků sdílejících jednu sadu vlastností. Jakákoli změna formátu, například rodina písem, styl písma, barva popředí, dekorace textu nebo jakýkoli jiný formátovací efekt, přeruší spuštění textu. Třída TextRun je kořen hierarchie typů představující několik typů textového obsahu zpracovávaného TextFormatter. Každá třída odvozená od TextRun představuje jedinečný typ textového obsahu.

Třída	Popis
TextRun	Kořen hierarchie Definuje skupinu znaků, které sdílejí stejnou sadu vlastností znaků.
TextCharacters	Definuje kolekci znaků glyfů z odlišného fyzického typu.
TextEmbeddedObject	Definuje typ textového obsahu, ve kterém se provádí měření, testování a kreslení celého obsahu jako jedinečná entita. Příkladem tohoto typu obsahu je tlačítko uprostřed řádku textu.
TextEndOfLine	Definuje kód znaku zalomení řádku.
TextEndOfParagraph	Definuje kód znaku zalomení odstavce. Odvozuje od TextEndOfLine.
TextEndOfSegment	Definuje značku přerušení segmentu.
TextHidden	Definuje rozsah neviděných znaků.
TextModifier	Definuje začátek oboru úprav.

Platí pro

Sdílet prostřednictvím