Span Constructores

Definición

Espacio de nombres:

System.Windows.Documents

Ensamblado:

PresentationFramework.dll

Inicializa una nueva instancia de la clase Span.

Sobrecargas

Span()	Inicializa una nueva instancia vacía de la clase Span.
Span(Inline)	Inicializa una nueva instancia de la clase Span con el objeto Inline especificado como contenido inicial.
Span(Inline, TextPointer)	Inicializa una nueva instancia de la clase Span, tomando un objeto Inline especificado como el contenido inicial del nuevo Span y un TextPointer que especifica una posición de inserción para el nuevo elemento Inline.
Span(TextPointer, TextPointer)	Inicializa una nueva instancia de la clase Span, tomando dos objetos TextPointer que indican el principio y el fin de una selección de contenido que el nuevo Span contendrá.

Span()

Inicializa una nueva instancia vacía de la clase Span.

public:
 Span();

public Span ();

Public Sub New ()

Span(Inline)

Inicializa una nueva instancia de la clase Span con el objeto Inline especificado como contenido 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

Contenido inicial del nuevo elemento Span.

Ejemplos

En el ejemplo siguiente se muestra cómo usar este constructor para crear un nuevo intervalo que contenga 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)

Span(Inline, TextPointer)

Inicializa una nueva instancia de la clase Span, tomando un objeto Inline especificado como el contenido inicial del nuevo Span y un TextPointer que especifica una posición de inserción para el nuevo 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

Un objeto Inline que especifica el contenido inicial del nuevo Span. Este parámetro puede ser nulo, en cuyo caso no se inserta ningún Inline.

insertionPosition

TextPointer

TextPointer que especifica la posición en la que se inserta el elemento Span una vez creado o null para que no haya inserción automática.

Ejemplos

En el ejemplo siguiente se muestra cómo usar este constructor para crear un nuevo Span objeto que contiene un Run insertado al principio de .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 una nueva instancia de la clase Span, tomando dos objetos TextPointer que indican el principio y el fin de una selección de contenido que el nuevo Span contendrá.

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

TextPointer que indica el principio de una selección de contenido que el nuevo Span contendrá.

end

TextPointer

TextPointer que indica el fin de una selección de contenido que el nuevo Span contendrá.

Excepciones

ArgumentNullException

Se produce cuando start o end es nulo.

ArgumentException

Se produce cuando start y end no se resuelven como un intervalo de contenido adecuado para caracteres enmarcados por un elemento Span; por ejemplo, si start y end indican posiciones en párrafos diferentes.

Ejemplos

En el ejemplo siguiente se muestra cómo usar este constructor para crear un nuevo Span que se aplica a un intervalo de contenido. El intervalo de contenido viene determinado por los objetos start y end TextPointer especificados por el 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")

En la ilustración siguiente se muestra cómo se representa en un FlowDocumentejemplo .

Comentarios

Este constructor está diseñado para inicializar un nuevo Span elemento de modo que incluya una selección de contenido preexistente.