Span Konstruktory
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Inicjuje nowe wystąpienie klasy Span.
Przeciążenia
| Nazwa | Opis |
|---|---|
| Span() |
Inicjuje nowe, puste wystąpienie Span klasy. |
| Span(Inline) |
Inicjuje nowe wystąpienie Span klasy z określonym Inline obiektem jako początkową zawartością. |
| Span(Inline, TextPointer) |
Inicjuje nowe wystąpienie Span klasy, przyjmując określony Inline obiekt jako początkową zawartość nowego Spanelementu i , który TextPointer określa pozycję wstawiania dla nowego Inline elementu. |
| Span(TextPointer, TextPointer) |
Inicjuje Span nowe wystąpienie klasy, przyjmując dwa TextPointer obiekty wskazujące początek i koniec wybranej zawartości, która będzie zawierać nowe Span . |
Span()
Inicjuje nowe, puste wystąpienie Span klasy.
public:
Span();
public Span();
Public Sub New ()
Dotyczy
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)
Parametry
Przykłady
W poniższym przykładzie pokazano, jak użyć tego konstruktora do utworzenia nowego zakresu zawierającego Runelement .
// 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)
Dotyczy
Span(Inline, TextPointer)
Inicjuje nowe wystąpienie Span klasy, przyjmując określony Inline obiekt jako początkową zawartość nowego Spanelementu i , który TextPointer określa pozycję wstawiania dla nowego Inline elementu.
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)
Parametry
- childInline
- Inline
Obiekt Inline określający początkową zawartość nowego Spanobiektu . Ten parametr może mieć wartość null, w takim przypadku nie Inline jest wstawiony.
- insertionPosition
- TextPointer
Element TextPointer , który określa położenie, w którym ma być wstawiony element po jego utworzeniu Span , lub null dla braku automatycznego wstawiania.
Przykłady
W poniższym przykładzie pokazano, jak za pomocą tego konstruktora utworzyć nowy Span element zawierający wstawiony Run na początku obiektu 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)
Dotyczy
Span(TextPointer, TextPointer)
Inicjuje Span nowe wystąpienie klasy, przyjmując dwa TextPointer obiekty wskazujące początek i koniec wybranej zawartości, która będzie zawierać nowe 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)
Parametry
- start
- TextPointer
Element TextPointer wskazujący początek zaznaczenia zawartości, która będzie zawierać nową Span zawartość.
- end
- TextPointer
Element TextPointer wskazujący koniec zaznaczenia zawartości, która będzie zawierać nową Span zawartość.
Wyjątki
Zgłaszane, gdy start wartość lub end ma wartość null.
Podniesione, gdy start i end nie rozpoznają zakresu zawartości odpowiedniej dla obudowy przez Span element, na przykład jeśli start i end wskazują pozycje w różnych akapitach.
Przykłady
W poniższym przykładzie pokazano, jak użyć tego konstruktora do utworzenia nowego Span , który jest stosowany do zakresu zawartości. Zakres zawartości jest określany przez obiekty początkowe i końcowe TextPointer określone przez konstruktora.
// 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")
Na poniższej ilustracji przedstawiono sposób renderowania tego przykładu w obiekcie FlowDocument.
Uwagi
Ten konstruktor ma na celu zainicjowanie nowego Span elementu, tak aby ujęł wybór wstępnie istniejącej zawartości.