Span Konstruktoren

Definition

Namespace:

System.Windows.Documents

Assembly:

PresentationFramework.dll

Initialisiert eine neue Instanz der Span-Klasse.

Überlädt

Span()	Initialisiert eine neue leere Instanz der Span-Klasse.
Span(Inline)	Initialisiert eine neue Instanz der Span-Klasse mit dem angegebenen Inline-Objekt als ursprünglichem Inhalt.
Span(Inline, TextPointer)	Initialisiert eine neue Instanz der Span-Klasse und übernimmt ein bestimmtes Inline-Objekt als ursprünglichen Inhalt der neuen Span sowie einen TextPointer, mit dem eine Einfügeposition für das neue Inline-Element angegeben wird.
Span(TextPointer, TextPointer)	Initialisiert eine neue Instanz der Span-Klasse mit zwei TextPointer-Objekten, mit denen der Anfang und das Ende des ausgewählten Inhalts angegeben werden, die im neuen Span enthalten sein sollen.

Span()

Initialisiert eine neue leere Instanz der Span-Klasse.

public:
 Span();

public Span ();

Public Sub New ()

Span(Inline)

Initialisiert eine neue Instanz der Span-Klasse mit dem angegebenen Inline-Objekt als ursprünglichem Inhalt.

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)

Parameter

childInline

Inline

Der ursprüngliche Inhalt der neuen Span.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie diesen Konstruktor verwenden, um einen neuen Span-Bereich zu erstellen, der eine 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)

Initialisiert eine neue Instanz der Span-Klasse und übernimmt ein bestimmtes Inline-Objekt als ursprünglichen Inhalt der neuen Span sowie einen TextPointer, mit dem eine Einfügeposition für das neue Inline-Element angegeben wird.

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)

Parameter

childInline

Inline

Ein Inline-Objekt, mit dem der ursprüngliche Inhalt der neuen Span angegeben wird. Dieser Parameter kann NULL sein. In diesem Fall wird kein Inline eingefügt.

insertionPosition

TextPointer

Ein TextPointer, mit dem die Position angegeben wird, an der das Span-Element nach der Erstellung eingefügt werden soll, oder NULL, wenn keine automatische Einfügung erfolgen soll.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie diesen Konstruktor verwenden, um einen neuen Span Konstruktor zu erstellen, der einen Run eingefügten Wert am Anfang einer ParagraphDatei enthält.

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

Initialisiert eine neue Instanz der Span-Klasse mit zwei TextPointer-Objekten, mit denen der Anfang und das Ende des ausgewählten Inhalts angegeben werden, die im neuen Span enthalten sein sollen.

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)

Parameter

start

TextPointer

Ein TextPointer, mit dem den Anfang des ausgewählten Inhalts angegeben wird, den der neue Span enthalten soll.

end

TextPointer

Ein TextPointer, mit dem das Ende des ausgewählten Inhalts angegeben wird, den der neue Span enthalten soll.

Ausnahmen

ArgumentNullException

Wird ausgelöst, wenn start oder end NULL ist.

ArgumentException

Wird ausgelöst, wenn start und end nicht in einen Inhaltsbereich aufgelöst werden, der von einem Span-Element umschlossen werden kann. Tritt beispielsweise auf, wenn start und end auf Positionen in verschiedenen Absätzen verweisen.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie diesen Konstruktor verwenden, um einen neuen Span Konstruktor zu erstellen, der auf einen Inhaltsbereich angewendet wird. Der Inhaltsbereich wird durch die vom Konstruktor angegebenen Start- und Endobjekte TextPointer bestimmt.

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

In der folgenden Abbildung wird gezeigt, wie dieses Beispiel in einem FlowDocument.

Hinweise

Dieser Konstruktor soll ein neues Span Element initialisieren, sodass es eine Auswahl vor vorhandener Inhalte einschließt.