Span Oluşturucular

Tanım

Ad Alanı:: System.Windows.Documents

Bütünleştirilmiş Kod:: PresentationFramework.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Span sınıfının yeni bir örneğini başlatır.

Aşırı Yüklemeler

Name	Description
Span()	Sınıfının yeni, boş bir örneğini Span başlatır.
Span(Inline)	İlk içerik olarak belirtilen Span nesneyle sınıfının yeni bir örneğini Inline başlatır.
Span(Inline, TextPointer)	Yeni öğesinin Span ilk içeriği olarak belirtilen Inline bir nesneyi ve yeni Spanöğe için ekleme konumunu belirten bir TextPointer alarak sınıfının yeni Inline bir örneğini başlatır.
Span(TextPointer, TextPointer)	Sınıfın Span yeni bir örneğini başlatır ve yeninin TextPointer içereceği içerik seçiminin başlangıcını ve sonunu gösteren iki Span nesne alır.

Span()

Sınıfının yeni, boş bir örneğini Span başlatır.

public:
 Span();

public Span();

Public Sub New ()

Şunlara uygulanır

Span(Inline)

İlk içerik olarak belirtilen Span nesneyle sınıfının yeni bir örneğini Inline başlatır.

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)

Parametreler

childInline: Inline

Yeni Spanöğesinin ilk içeriği.

Örnekler

Aşağıdaki örnekte, içeren yeni bir Span oluşturmak için bu oluşturucunun nasıl kullanılacağı gösterilmektedir 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)

Şunlara uygulanır

Span(Inline, TextPointer)

Yeni öğesinin Span ilk içeriği olarak belirtilen Inline bir nesneyi ve yeni Spanöğe için ekleme konumunu belirten bir TextPointer alarak sınıfının yeni Inline bir örneğini başlatır.

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)

Parametreler

childInline: Inline

Inline Yeni Spanöğesinin ilk içeriğini belirten bir nesne. Bu parametre null olabilir ve bu durumda eklenmez Inline .

insertionPosition: TextPointer

TextPointer Öğesinin oluşturulduktan sonra eklendiği Span konumu belirten veya otomatik ekleme olmadan null olan bir.

Örnekler

Aşağıdaki örnekte, bu oluşturucunun başında eklenen öğesini içeren yeni Span bir Run oluşturma işleminin nasıl kullanılacağı gösterilmektedir 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)

Şunlara uygulanır

Span(TextPointer, TextPointer)

Sınıfın Span yeni bir örneğini başlatır ve yeninin TextPointer içereceği içerik seçiminin başlangıcını ve sonunu gösteren iki Span nesne alır.

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)

Parametreler

start: TextPointer

TextPointer Yeni Span içeriğin içereceği bir içerik seçiminin başlangıcını gösteren bir.

end: TextPointer

TextPointer Yeni Span içeriğin içereceği bir içerik seçiminin sonunu gösteren bir.

Özel durumlar

ArgumentNullException

veya start null olduğunda end oluşturulur.

ArgumentException

Bir öğe tarafından start muhafaza için uygun bir içerik aralığına çözümlendiğinde ve end çözümlenmediğinde Span oluşturulur; örneğin, farklı paragraflardaki konumları gösterir ve start gösterirend.

Örnekler

Aşağıdaki örnekte, bir içerik aralığına uygulanan yeni Span bir oluşturma için bu oluşturucunun nasıl kullanılacağı gösterilmektedir. İçerik aralığı, oluşturucu tarafından belirtilen başlangıç ve bitiş TextPointer nesneleri tarafından belirlenir.

// 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şağıdaki şekilde, bu örneğin içinde FlowDocumentnasıl işlenme şekli gösterilmektedir.

Ekran görüntüsü: Üç metin

Açıklamalar

Bu oluşturucu, önceden var olan bir içerik seçimini kapsayan yeni Span bir öğe başlatmaya yöneliktir.

Şunlara uygulanır

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?