Span Konstruktorer
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Initierar en ny instans av Span klassen.
Överlagringar
| Name | Description |
|---|---|
| Span() |
Initierar en ny, tom instans av Span klassen. |
| Span(Inline) |
Initierar en ny instans av Span klassen med det angivna Inline objektet som det första innehållet. |
| Span(Inline, TextPointer) |
Initierar en ny instans av Span klassen med ett angivet Inline objekt som det första innehållet i den nya Span, och en TextPointer som anger en infogningsposition för det nya Inline elementet. |
| Span(TextPointer, TextPointer) |
Initierar en ny instans av Span klassen med två TextPointer objekt som anger början och slutet av ett urval av innehåll som den nya Span ska innehålla. |
Span()
Initierar en ny, tom instans av Span klassen.
public:
Span();
public Span();
Public Sub New ()
Gäller 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)
Parametrar
Exempel
I följande exempel visas hur du använder den här konstruktorn för att skapa ett nytt span som innehåller en 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)
Gäller för
Span(Inline, TextPointer)
Initierar en ny instans av Span klassen med ett angivet Inline objekt som det första innehållet i den nya Span, och en TextPointer som anger en infogningsposition för det nya Inline elementet.
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)
Parametrar
- childInline
- Inline
Ett Inline objekt som anger det första innehållet i det nya Span. Den här parametern kan vara null, i vilket fall ingen Inline infogas.
- insertionPosition
- TextPointer
En TextPointer som anger den position där elementet Span ska infogas när det har skapats eller null för ingen automatisk infogning.
Exempel
I följande exempel visas hur du använder den här konstruktorn för att skapa en ny Span som innehåller en Run infogad i början av en 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)
Gäller för
Span(TextPointer, TextPointer)
Initierar en ny instans av Span klassen med två TextPointer objekt som anger början och slutet av ett urval av innehåll som den nya Span ska innehålla.
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)
Parametrar
- start
- TextPointer
En TextPointer som anger början på ett urval av innehåll som den nya Span ska innehålla.
- end
- TextPointer
En TextPointer som anger slutet på ett urval av innehåll som den nya Span ska innehålla.
Undantag
Upphöjt när start eller end är null.
Upphöjt när start och end inte matchar en mängd innehåll som är lämpligt för inneslutning av ett Span element, till exempel om start och end anger positioner i olika stycken.
Exempel
I följande exempel visas hur du använder den här konstruktorn för att skapa en ny Span som tillämpas på ett innehållsintervall. Innehållsintervallet bestäms av de start- och slutobjekt TextPointer som anges av konstruktorn.
// 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")
Följande bild visar hur det här exemplet återges i en FlowDocument.
Kommentarer
Konstruktorn är avsedd att initiera ett nytt Span element så att det omger ett urval av befintligt innehåll.