Span 构造函数

定义

命名空间:

System.Windows.Documents

程序集:

PresentationFramework.dll

初始化 Span 类的新实例。

重载

Span()	初始化 Span 类的新的空实例。
Span(Inline)	初始化 Span 类的一个新实例，并使用指定的 Inline 对象作为其初始内容。
Span(Inline, TextPointer)	初始化 Span 类的一个新实例，其中使用指定 Inline 对象作为新 Span 的初始内容，并由一个 TextPointer 指定新 Inline 元素的插入位置。
Span(TextPointer, TextPointer)	初始化 Span 类的一个新实例，其中使用两个 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 类的一个新实例，其中使用两个 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 将要包含的内容选择的结束位置。

例外

ArgumentNullException

当 start 或 end 为 null 时引发。

ArgumentException

当 start 和 end 没有解析为一个适于由 Span 元素包围的范围时引发；例如，当 start 和 end 指示位置位于不同的段落中时。

示例

以下示例演示如何使用此构造函数创建应用于内容范围的新 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呈现方式。

注解

此构造函数旨在初始化新 Span 元素，使其包含一系列预先存在的内容。