Span Konstruktoren
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Initialisiert eine neue Instanz der Span-Klasse.
Überlädt
| Name | Beschreibung |
|---|---|
| Span() |
Initialisiert eine neue, leere Instanz der Span Klasse. |
| Span(Inline) |
Initialisiert eine neue Instanz der Span Klasse mit dem angegebenen Inline Objekt als anfänglichen Inhalt. |
| Span(Inline, TextPointer) |
Initialisiert eine neue Instanz der Span Klasse, wobei ein angegebenes Inline Objekt als anfänglicher Inhalt des neuen SpanObjekts verwendet wird, und ein TextPointer Objekt, das eine Einfügeposition für das neue Inline Element angibt. |
| Span(TextPointer, TextPointer) |
Initialisiert eine neue Instanz der Span Klasse, wobei zwei TextPointer Objekte verwendet werden, die den Anfang und das Ende einer Auswahl von Inhalten angeben, die das neue Span enthalten soll. |
Span()
Initialisiert eine neue, leere Instanz der Span Klasse.
public:
Span();
public Span();
Public Sub New ()
Gilt für:
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)
Parameter
Beispiele
Das folgende Beispiel zeigt, 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)
Gilt für:
Span(Inline, TextPointer)
Initialisiert eine neue Instanz der Span Klasse, wobei ein angegebenes Inline Objekt als anfänglicher Inhalt des neuen SpanObjekts verwendet wird, und ein TextPointer Objekt, das eine Einfügeposition für das neue Inline Element angibt.
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, das den anfänglichen Inhalt des neuen Spanangibt. Dieser Parameter kann null sein, in diesem Fall wird kein Inline Parameter eingefügt.
- insertionPosition
- TextPointer
A TextPointer that specifies the position at which to insert the Span element after it is created, or null for no automatic insert.
Beispiele
Das folgende Beispiel zeigt, wie Sie diesen Konstruktor verwenden, um eine neue Span zu erstellen, die einen Run eingefügten am Anfang einer .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)
Gilt für:
Span(TextPointer, TextPointer)
Initialisiert eine neue Instanz der Span Klasse, wobei zwei TextPointer Objekte verwendet werden, die den Anfang und das Ende einer Auswahl von Inhalten angeben, die das neue Span enthalten soll.
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
A TextPointer that indicates the beginning of a selection of content that the new Span will contain.
- end
- TextPointer
A TextPointer that indicates the end of a selection of content that the new Span will contain.
Ausnahmen
Wird ausgelöst, wenn start oder end null ist.
Wird ausgelöst, wenn start ein end Inhaltsbereich, der für die Anlage durch ein Span Element geeignet ist, nicht aufgelöst wird, z. B. wenn start und end positionen in verschiedenen Absätzen angegeben werden.
Beispiele
Das folgende Beispiel zeigt, wie Sie diesen Konstruktor verwenden, um eine neue Span zu erstellen, die 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")
Die folgende Abbildung zeigt, wie dieses Beispiel in einem FlowDocument.
Hinweise
Dieser Konstruktor soll ein neues Span Element initialisieren, sodass es eine Auswahl bereits vorhandener Inhalte einschließt.