Span Constructeurs

Définition

Espace de noms:: System.Windows.Documents

Assembly:: PresentationFramework.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Initialise une nouvelle instance de la classe Span.

Surcharges

Nom	Description
Span()	Initialise une nouvelle instance vide de la Span classe.
Span(Inline)	Initialise une nouvelle instance de la Span classe avec l’objet spécifié Inline comme contenu initial.
Span(Inline, TextPointer)	Initialise une nouvelle instance de la Span classe, prenant un objet spécifié Inline comme contenu initial du nouveau Span, et qui TextPointer spécifie une position d’insertion pour le nouvel Inline élément.
Span(TextPointer, TextPointer)	Initialise une nouvelle instance de la Span classe, en prenant deux TextPointer objets qui indiquent le début et la fin d’une sélection de contenu que le nouveau Span contiendra.

Span()

Initialise une nouvelle instance vide de la Span classe.

public:
 Span();

public Span();

Public Sub New ()

S’applique à

Span(Inline)

Initialise une nouvelle instance de la Span classe avec l’objet spécifié Inline comme contenu initial.

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)

Paramètres

childInline: Inline

Contenu initial du nouveau Span.

Exemples

L’exemple suivant montre comment utiliser ce constructeur pour créer une étendue qui contient un 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)

S’applique à

Span(Inline, TextPointer)

Initialise une nouvelle instance de la Span classe, prenant un objet spécifié Inline comme contenu initial du nouveau Span, et qui TextPointer spécifie une position d’insertion pour le nouvel Inline élément.

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)

Paramètres

childInline: Inline

Objet Inline qui spécifie le contenu initial du nouveau Span. Ce paramètre peut être null, auquel cas aucun élément n’est Inline inséré.

insertionPosition: TextPointer

Valeur TextPointer qui spécifie la position à laquelle insérer l’élément Span après sa création, ou null pour aucune insertion automatique.

Exemples

L’exemple suivant montre comment utiliser ce constructeur pour créer un nouveau Span qui contient une Run insertion au début d’un 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)

S’applique à

Span(TextPointer, TextPointer)

Initialise une nouvelle instance de la Span classe, en prenant deux TextPointer objets qui indiquent le début et la fin d’une sélection de contenu que le nouveau Span contiendra.

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)

Paramètres

start: TextPointer

Qui TextPointer indique le début d’une sélection de contenu que le nouveau Span contiendra.

end: TextPointer

Qui TextPointer indique la fin d’une sélection de contenu que le nouveau Span contiendra.

Exceptions

ArgumentNullException

Déclenché quand start ou end a la valeur Null.

ArgumentException

Déclenché quand start et end ne sont pas résolus en une plage de contenu adaptée au boîtier par un Span élément ; par exemple, si start et end indiquez des positions dans différents paragraphes.

Exemples

L’exemple suivant montre comment utiliser ce constructeur pour créer un nouveau Span qui est appliqué à une plage de contenu. La plage de contenu est déterminée par les objets de début et de fin TextPointer spécifiés par le constructeur.

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

La figure suivante montre comment cet exemple s’affiche dans un FlowDocument.

Capture d’écran : Trois exécutions de

Remarques

Ce constructeur est destiné à initialiser un nouvel Span élément afin qu’il place une sélection de contenu préexistant.

S’applique à

Commentaires

Cette page a-t-elle été utile ?