Span コンストラクター

定義

Span クラスの新しいインスタンスを初期化します。

オーバーロード

Span()

Span クラスの新しい空のインスタンスを初期化します。

Span(Inline)

指定した Span オブジェクトを初期コンテンツとして使用して、Inline クラスの新しいインスタンスを初期化します。

Span(Inline, TextPointer)

新しい Span の初期コンテンツとして指定された Inline オブジェクトと、新しい Span 要素の挿入位置を指定する TextPointer を受け取って、Inline クラスの新しいインスタンスを初期化します。

Span(TextPointer, TextPointer)

新しい Span が格納するコンテンツの選択範囲の先頭と末尾を示す 2 つの TextPointer オブジェクトを受け取って、Span クラスの新しいインスタンスを初期化します。

Span()

Span クラスの新しい空のインスタンスを初期化します。

public:
 Span();
public Span ();
Public Sub New ()

適用対象

Span(Inline)

指定した Span オブジェクトを初期コンテンツとして使用して、Inline クラスの新しいインスタンスを初期化します。

public:
 Span(System::Windows::Documents::Inline ^ childInline);
public Span (System.Windows.Documents.Inline childInline);
new System.Windows.Documents.Span : System.Windows.Documents.Inline -> System.Windows.Documents.Span
Public Sub New (childInline As Inline)

パラメーター

childInline
Inline

新しい Span の初期コンテンツ。

次の例では、このコンストラクターを使用して、 を含む新しい Span を作成する方法を Run示します。

// A child Inline element for the new Span element.
Run runx = new Run("The Run element derives from Inline, and is therefore" +
    "an acceptable child element for this new Span.");

// After this line executes, the new element "spanx"
// contains the specified Inline element, "runx".
Span spanx = new Span(runx);
' A child Inline element for the new Span element.
Dim runx1 As New Run("The Run element derives from Inline, and is therefore" & "an acceptable child element for this new Span.")

' After this line executes, the new element "spanx"
' contains the specified Inline element, "runx".
Dim spanx1 As New Span(runx1)

適用対象

Span(Inline, TextPointer)

新しい Span の初期コンテンツとして指定された Inline オブジェクトと、新しい Span 要素の挿入位置を指定する TextPointer を受け取って、Inline クラスの新しいインスタンスを初期化します。

public:
 Span(System::Windows::Documents::Inline ^ childInline, System::Windows::Documents::TextPointer ^ insertionPosition);
public Span (System.Windows.Documents.Inline childInline, System.Windows.Documents.TextPointer insertionPosition);
new System.Windows.Documents.Span : System.Windows.Documents.Inline * System.Windows.Documents.TextPointer -> System.Windows.Documents.Span
Public Sub New (childInline As Inline, insertionPosition As TextPointer)

パラメーター

childInline
Inline

新しい Inline の初期コンテンツを指定する Span オブジェクト。 このパラメーターは、null でもかまいません。その場合、Inline は挿入されません。

insertionPosition
TextPointer

TextPointer 要素の作成後に、この要素を挿入する挿入位置を指定する Span。自動挿入を行わない場合は null。

次の例は、このコンストラクターを使用して、 の先頭に挿入された をRun含む新しい Span を作成する方法をParagraph示しています。

// A child Inline element for the new Span element.
Run runx = new Run("The Run element derives from Inline, and is therefore" +
    "an acceptable child element for this new Span.");

// An empty paragraph will serve as the container for the new Span element.
Paragraph parx = new Paragraph();

// After this line executes, the new element "spanx"
// contains the specified Inline element, "runx".  Also, "spanx" is
// inserted at the point indicated by the insertionPosition parameter, 
// which in this case indicates the content start position in the Paragraph 
// element "parx".
Span spanx = new Span(runx, parx.ContentStart);
' A child Inline element for the new Span element.
Dim runx2 As New Run("The Run element derives from Inline, and is therefore" & "an acceptable child element for this new Span.")

' An empty paragraph will serve as the container for the new Span element.
Dim parx2 As New Paragraph()

' After this line executes, the new element "spanx"
' contains the specified Inline element, "runx".  Also, "spanx" is
' inserted at the point indicated by the insertionPosition parameter, 
' which in this case indicates the content start position in the Paragraph 
' element "parx".
Dim spanx2 As New Span(runx2, parx2.ContentStart)

適用対象

Span(TextPointer, TextPointer)

新しい Span が格納するコンテンツの選択範囲の先頭と末尾を示す 2 つの TextPointer オブジェクトを受け取って、Span クラスの新しいインスタンスを初期化します。

public:
 Span(System::Windows::Documents::TextPointer ^ start, System::Windows::Documents::TextPointer ^ end);
public Span (System.Windows.Documents.TextPointer start, System.Windows.Documents.TextPointer end);
new System.Windows.Documents.Span : System.Windows.Documents.TextPointer * System.Windows.Documents.TextPointer -> System.Windows.Documents.Span
Public Sub New (start As TextPointer, end As TextPointer)

パラメーター

start
TextPointer

新しい TextPointer が格納するコンテンツの選択範囲の先頭を示す Span

end
TextPointer

新しい TextPointer が格納するコンテンツの選択範囲の末尾を示す Span

例外

start または end が null の場合に発生します。

startend が、Span 要素によって囲まれた部分に適合するコンテンツの範囲に解決されない場合に発生します。たとえば、startend が別々のパラグラフ内の位置を示している場合などです。

次の例は、このコンストラクターを使用して、コンテンツの範囲に適用される新しい Span を作成する方法を示しています。 コンテンツの範囲は、コンストラクターで指定された開始オブジェクトと終了 TextPointer オブジェクトによって決まります。

// Create a paragraph and three text runs to serve as example content.  
Paragraph parx = new Paragraph();
Run run1 = new Run("Text run 1.");
Run run2 = new Run("Text run 2.");
Run run3 = new Run("Text run 3.");

// Add the three text runs to the paragraph, separated by linebreaks.
parx.Inlines.Add(run1);
parx.Inlines.Add(new LineBreak());
parx.Inlines.Add(run2);
parx.Inlines.Add(new LineBreak());
parx.Inlines.Add(run3);

// After this line executes, the selection of content
// indicated by the "start" and "end" parameters will be
// enclosed by the new Span.  In this case, the new Span
// will enclose the entire contents of the Paragraph "parx",
// which happens to contain three text runs and two linebreaks.               
Span spanx = new Span(parx.ContentStart, parx.ContentEnd);

// Now, properties set on "spanx" will override default properties
// on elements contained by "spanx".  For example, setting 
// these arbitrary display properties on "spanx" will affect
// the child text runs enclosed by "spanx".
spanx.Foreground = Brushes.Blue;
spanx.Background = Brushes.GhostWhite;
spanx.FontFamily = new FontFamily("Century Gothic");

// Non-default property values override any settings on the 
// enclosing Span element.
run2.Foreground = Brushes.Red;
run2.Background = Brushes.AntiqueWhite;
run2.FontFamily = new FontFamily("Lucida Handwriting");
' Create a paragraph and three text runs to serve as example content.  
Dim parx3 As New Paragraph()
Dim run1 As New Run("Text run 1.")
Dim run2 As New Run("Text run 2.")
Dim run3 As New Run("Text run 3.")

' Add the three text runs to the paragraph, separated by linebreaks.
parx3.Inlines.Add(run1)
parx3.Inlines.Add(New LineBreak())
parx3.Inlines.Add(run2)
parx3.Inlines.Add(New LineBreak())
parx3.Inlines.Add(run3)

' After this line executes, the selection of content
' indicated by the "start" and "end" parameters will be
' enclosed by the new Span.  In this case, the new Span
' will enclose the entire contents of the Paragraph "parx",
' which happens to contain three text runs and two linebreaks.               
Dim spanx As New Span(parx3.ContentStart, parx3.ContentEnd)

' Now, properties set on "spanx" will override default properties
' on elements contained by "spanx".  For example, setting 
' these arbitrary display properties on "spanx" will affect
' the child text runs enclosed by "spanx".
spanx.Foreground = Brushes.Blue
spanx.Background = Brushes.GhostWhite
spanx.FontFamily = New FontFamily("Century Gothic")

' Non-default property values override any settings on the 
' enclosing Span element.
run2.Foreground = Brushes.Red
run2.Background = Brushes.AntiqueWhite
run2.FontFamily = New FontFamily("Lucida Handwriting")

次の図は、 でこの例がどのようにレンダリングされるかを FlowDocument示しています。

スクリーンショット: 3 つのテキスト実行

注釈

このコンストラクターは、既存のコンテンツの選択を囲む新しい Span 要素を初期化することを目的としています。

適用対象