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の初期コンテンツ。

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

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

次の例では、このコンストラクターを使用して、Spanの先頭に挿入されたRunを含む新しい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 要素を初期化することを目的としています。

適用対象