TextRun TextRun TextRun TextRun Class

定義

単一のプロパティ セットを共有する文字列を表します。Represents a sequence of characters that share a single property set.

public ref class TextRun abstract
public abstract class TextRun
type TextRun = class
Public MustInherit Class TextRun
継承
TextRunTextRunTextRunTextRun
派生

次の例では、 GetTextRunメソッドのオーバーライドが実装されています。In the following example, an override for the GetTextRun method is implemented.

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

注釈

テキストランは、1つのプロパティセットを共有する一連の文字です。A text run is a sequence of characters sharing a single property set. フォントスタイル、前景色、フォントファミリ、またはその他の書式設定効果など、形式を変更すると、テキストランが中断されます。Any change to the format, such as font style, foreground color, font family, or any other formatting effect, breaks the text run. 次の例は、テキスト文字列への書式設定の変更によって一連のテキストランが生成される方法を示しています。各テキストランには、書式設定プロパティの共通セットがあります。The following example illustrates how changes in formatting to a text string results in a series of text runs - each text run has a common set of formatting properties.

クラスは、によってTextFormatter処理されるいくつかの種類のテキストコンテンツを表す型階層のルートです。 TextRunThe TextRun class is the root of a type hierarchy representing several types of text content processed by TextFormatter. からTextRun派生した各クラスは、異なる型のテキストコンテンツを表します。Each class that is derived from TextRun represents a distinct type of text content.

クラスClass 説明Description
TextRun 階層のルート。Root of the hierarchy. 文字プロパティの同じセットを共有する文字のグループを定義します。Defines a group of characters that share the same set of character properties.
TextCharacters 異なる物理タイプフェイスからの文字グリフのコレクションを定義します。Defines a collection of character glyphs from a distinct physical typeface.
TextEmbeddedObject コンテンツ全体の測定、ヒットテスト、および描画を個別のエンティティとして実行するテキストコンテンツの種類を定義します。Defines a type of text content in which measuring, hit testing, and drawing of the entire content is done as a distinct entity. この種類のコンテンツの例としては、テキスト行の中央にボタンがあります。An example of this type of content is a button in the middle of the line of text.
TextEndOfLine 改行文字コードを定義します。Defines a line-break character code.
TextEndOfParagraph 改行文字コードを定義します。Defines a paragraph-break character code. TextEndOfLineから派生します。Derives from TextEndOfLine.
TextEndOfSegment セグメントの区切りマーカーを定義します。Defines a segment break marker.
TextHidden 非表示文字の範囲を定義します。Defines a range of non-visible characters.
TextModifier 変更スコープの先頭を定義します。Defines the beginning of a modification scope.

コンストラクター

TextRun() TextRun() TextRun() TextRun()

TextRun オブジェクトのインスタンスを作成します。Creates an instance of a TextRun object.

プロパティ

CharacterBufferReference CharacterBufferReference CharacterBufferReference CharacterBufferReference

テキスト ラン文字バッファーへの参照を取得します。Gets a reference to the text run character buffer.

Length Length Length Length

テキスト ラン内の文字数を取得します。Gets the number of characters in the text run.

Properties Properties Properties Properties

タイプフェイスや前景ブラシなど、テキスト ラン内のすべての文字が共有するテキスト プロパティのセットを取得します。Gets the set of text properties that are shared by every character in the text run, such as typeface or foreground brush.

メソッド

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

適用対象

こちらもご覧ください