Span 생성자

정의

네임스페이스:

System.Windows.Documents

어셈블리:

PresentationFramework.dll

Span 클래스의 새 인스턴스를 초기화합니다.

오버로드

Span()	Span 클래스의 비어 있는 새 인스턴스를 초기화합니다.
Span(Inline)	지정된 Inline 개체를 초기 내용으로 사용하여 Span 클래스의 새 인스턴스를 초기화합니다.
Span(Inline, TextPointer)	지정된 Inline 개체를 새 Span초기 내용으로 사용하고 새 Inline 요소의 삽입 위치를 지정하는 TextPointer 사용하여 Span 클래스의 새 인스턴스를 초기화합니다.
Span(TextPointer, TextPointer)	새 Span 포함할 콘텐츠 선택 영역의 시작과 끝을 나타내는 두 개의 TextPointer 개체를 사용하여 Span 클래스의 새 인스턴스를 초기화합니다.

Span()

Span 클래스의 비어 있는 새 인스턴스를 초기화합니다.

public:
 Span();

public Span ();

Public Sub New ()

Span(Inline)

지정된 Inline 개체를 초기 내용으로 사용하여 Span 클래스의 새 인스턴스를 초기화합니다.

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)

지정된 Inline 개체를 새 Span초기 내용으로 사용하고 새 Inline 요소의 삽입 위치를 지정하는 TextPointer 사용하여 Span 클래스의 새 인스턴스를 초기화합니다.

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

새 Span초기 내용을 지정하는 Inline 개체입니다. 이 매개 변수는 null일 수 있으며 이 경우 Inline 삽입되지 않습니다.

insertionPosition

TextPointer

Span 요소를 만든 후 삽입할 위치를 지정하는 TextPointer, 자동 삽입이 없으면 null입니다.

예제

다음 예제에서는 이 생성자를 사용하여 Paragraph시작 부분에 삽입된 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.");

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

새 Span 포함할 콘텐츠 선택 영역의 시작을 나타내는 TextPointer.

end

TextPointer

새 Span 포함할 콘텐츠 선택 영역의 끝을 나타내는 TextPointer.

예외

ArgumentNullException

start 또는 end null일 때 발생합니다.

ArgumentException

start 및 endSpan 요소에 의해 인클로저에 적합한 콘텐츠 범위로 확인되지 않을 때 발생합니다. 예를 들어 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렌더링하는 방법을 보여 줍니다.

설명

이 생성자는 기존 콘텐츠의 선택을 묶도록 새 Span 요소를 초기화하기 위한 것입니다.