Span Construtores

Definição

Namespace:

System.Windows.Documents

Assembly:

PresentationFramework.dll

Inicializa uma nova instância da classe Span.

Sobrecargas

Span()	Inicializa uma nova instância vazia da classe Span.
Span(Inline)	Inicializa uma nova instância da classe Span com o objeto Inline especificado como o conteúdo inicial.
Span(Inline, TextPointer)	Inicializa uma nova instância da classe Span, usando um objeto Inline especificado como o conteúdo inicial do novo Span e um TextPointer que especifica um ponto de inserção para o novo elemento Inline.
Span(TextPointer, TextPointer)	Inicializa uma nova instância da classe Span, usando dois objetos de TextPointer que indicam o início e o fim de uma seleção de conteúdo a ser contido pelo novo Span.

Span()

Inicializa uma nova instância vazia da classe Span.

public:
 Span();

public Span ();

Public Sub New ()

Span(Inline)

Inicializa uma nova instância da classe Span com o objeto Inline especificado como o conteúdo inicial.

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)

Parâmetros

childInline

Inline

O conteúdo inicial do novo Span.

Exemplos

O exemplo a seguir mostra como usar esse construtor para criar um novo Span que contém um 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)

Span(Inline, TextPointer)

Inicializa uma nova instância da classe Span, usando um objeto Inline especificado como o conteúdo inicial do novo Span e um TextPointer que especifica um ponto de inserção para o novo elemento Inline.

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)

Parâmetros

childInline

Inline

Um objeto Inline que especifica o conteúdo inicial do novo Span. Esse parâmetro pode ser nulo, caso em que nenhum Inline é inserido.

insertionPosition

TextPointer

Um TextPointer que especifica uma posição na qual inserir o elemento Span depois que ele é criado ou nulo para nenhuma inserção automática.

Exemplos

O exemplo a seguir mostra como usar esse construtor para criar um novo Span que contém um Run inserido no início de um 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)

Span(TextPointer, TextPointer)

Inicializa uma nova instância da classe Span, usando dois objetos de TextPointer que indicam o início e o fim de uma seleção de conteúdo a ser contido pelo novo 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)

Parâmetros

start

TextPointer

Um TextPointer indicando o início de uma seleção de conteúdo a ser contido pelo novo Span.

end

TextPointer

Um TextPointer indicando o término de uma seleção de conteúdo a ser contido pelo novo Span.

Exceções

ArgumentNullException

Gerado quando start ou end for null.

ArgumentException

Gerada quando start e end não resolverem para uma variedade de conteúdo adequada um elemento de Span conter, por exemplo, se start e end indicarem posições em parágrafos diferentes.

Exemplos

O exemplo a seguir mostra como usar esse construtor para criar um novo Span que é aplicado a um intervalo de conteúdo. O intervalo de conteúdo é determinado pelos objetos start e end TextPointer especificados pelo construtor.

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

A figura a seguir mostra como este exemplo é renderizado em um FlowDocument.

Comentários

Esse construtor destina-se a inicializar um novo Span elemento de modo que ele inclua uma seleção de conteúdo pré-existente.