TextRun Klas

Definitie

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

Vertegenwoordigt een reeks tekens die één set eigenschappen delen.

public ref class TextRun abstract
public abstract class TextRun
type TextRun = class
Public MustInherit Class TextRun
Overname
Object
TextRun
Afgeleid

Voorbeelden

In het volgende voorbeeld wordt een onderdrukking voor de GetTextRun methode geïmplementeerd.

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

Opmerkingen

Een tekstuitvoering is een reeks tekens die één eigenschappenset delen. Elke wijziging in de opmaak, zoals tekenstijl, voorgrondkleur, lettertypefamilie of een ander opmaakeffect, breekt de tekstuitvoering af. In het volgende voorbeeld ziet u hoe wijzigingen in opmaak in een tekenreeks leiden tot een reeks tekstuitvoeringen. Elke tekstuitvoering heeft een gemeenschappelijke set opmaakeigenschappen.

De TextRun klasse is de hoofdmap van een typehiërarchie die verschillende typen tekstinhoud vertegenwoordigt die door TextFormatter. Elke klasse die is afgeleid van TextRun , vertegenwoordigt een uniek type tekstinhoud.

Class Beschrijving
TextRun Hoofdmap van de hiërarchie. Hiermee definieert u een groep tekens die dezelfde set tekeneigenschappen delen.
TextCharacters Hiermee definieert u een verzameling tekenglyphs van een afzonderlijk fysiek lettertype.
TextEmbeddedObject Definieert een type tekstinhoud waarin het meten, het testen van treffers en het tekenen van de volledige inhoud wordt uitgevoerd als een afzonderlijke entiteit. Een voorbeeld van dit type inhoud is een knop in het midden van de tekstregel.
TextEndOfLine Definieert een regeleindetekencode.
TextEndOfParagraph Hiermee definieert u een code voor alinea-eindetekens. Is afgeleid van TextEndOfLine.
TextEndOfSegment Hiermee definieert u een segmenteindemarkering.
TextHidden Hiermee definieert u een bereik van niet-zichtbare tekens.
TextModifier Definieert het begin van een wijzigingsbereik.

Constructors

Name Description
TextRun()

Hiermee maakt u een exemplaar van een TextRun object.

Eigenschappen

Name Description
CharacterBufferReference

Hiermee wordt een verwijzing naar de tekenbuffer voor tekstuitvoering opgehaald.
Length

Hiermee haalt u het aantal tekens op in de tekstuitvoering.
Properties

Hiermee haalt u de set teksteigenschappen op die worden gedeeld door elk teken in de tekstuitvoering, zoals lettertype of voorgrondborstel.

Methoden

Name Description
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)

Van toepassing op

Zie ook