Span Constructors

Definitie

Naamruimte:: System.Windows.Documents

Assembly:: PresentationFramework.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Initialiseert een nieuw exemplaar van de Span klasse.

Overloads

Name	Description
Span()	Initialiseert een nieuwe, lege instantie van de Span klasse.
Span(Inline)	Initialiseert een nieuw exemplaar van de Span klasse met het opgegeven Inline object als de oorspronkelijke inhoud.
Span(Inline, TextPointer)	Initialiseert een nieuw exemplaar van de Span klasse, waarbij een opgegeven object wordt gebruikt Inline als de initiële inhoud van het nieuwe Spanobject en een TextPointer object dat een invoegpositie voor het nieuwe Inline element aangeeft.
Span(TextPointer, TextPointer)	Initialiseert een nieuw exemplaar van de Span klasse, waarbij twee TextPointer objecten worden gebruikt die het begin en einde aangeven van een selectie van inhoud die de nieuwe Span bevat.

Span()

Initialiseert een nieuwe, lege instantie van de Span klasse.

public:
 Span();

public Span();

Public Sub New ()

Van toepassing op

Span(Inline)

Initialiseert een nieuw exemplaar van de Span klasse met het opgegeven Inline object als de oorspronkelijke inhoud.

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)

Parameters

childInline: Inline

De oorspronkelijke inhoud van het nieuwe Span.

Voorbeelden

In het volgende voorbeeld ziet u hoe u deze constructor gebruikt om een nieuwe span te maken die een 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)

Van toepassing op

Span(Inline, TextPointer)

Initialiseert een nieuw exemplaar van de Span klasse, waarbij een opgegeven object wordt gebruikt Inline als de initiële inhoud van het nieuwe Spanobject en een TextPointer object dat een invoegpositie voor het nieuwe Inline element aangeeft.

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)

Parameters

childInline: Inline

Een Inline object dat de oorspronkelijke inhoud van het nieuwe Spanobject aangeeft. Deze parameter kan null zijn. In dat geval wordt er geen Inline ingevoegd.

insertionPosition: TextPointer

Een TextPointer die de positie aangeeft waarop het Span element moet worden ingevoegd nadat het is gemaakt, of null voor geen automatische invoeging.

Voorbeelden

In het volgende voorbeeld ziet u hoe u deze constructor gebruikt om een nieuwe Span te maken die aan Run het begin van een 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)

Van toepassing op

Span(TextPointer, TextPointer)

Initialiseert een nieuw exemplaar van de Span klasse, waarbij twee TextPointer objecten worden gebruikt die het begin en einde aangeven van een selectie van inhoud die de nieuwe Span bevat.

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)

Parameters

start: TextPointer

Een TextPointer die het begin aangeeft van een selectie van inhoud die de nieuwe Span bevat.

end: TextPointer

Een TextPointer die het einde aangeeft van een selectie van inhoud die de nieuwe Span bevat.

Uitzonderingen

ArgumentNullException

Verhoogd wanneer start of end null is.

ArgumentException

Wordt gegenereerd wanneer start en end niet wordt omgezet in een bereik van inhoud die geschikt is voor een Span element, bijvoorbeeld als start en end geeft u posities in verschillende alinea's aan.

Voorbeelden

In het volgende voorbeeld ziet u hoe u deze constructor gebruikt om een nieuwe Span te maken die wordt toegepast op een inhoudsbereik. Het inhoudsbereik wordt bepaald door de begin- en eindobjecten TextPointer die zijn opgegeven door de constructor.

// 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 de volgende afbeelding ziet u hoe dit voorbeeld wordt weergegeven in een FlowDocument.

Schermopname: Drie tekstuitvoeringen

Opmerkingen

Deze constructor is bedoeld om een nieuw Span element te initialiseren, zodat er een selectie van bestaande inhoud wordt geplaatst.

Van toepassing op

Feedback

Is deze pagina nuttig?