Span Конструкторы
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Инициализирует новый экземпляр класса Span.
Перегрузки
Span() |
Инициализирует новый пустой экземпляр класса Span. |
Span(Inline) |
Инициализация нового экземпляра класса Span с заданным объектом Inline в качестве начального содержимого. |
Span(Inline, TextPointer) |
Инициализация нового экземпляра класса Span, используя заданный объект Inline в качестве начального содержимого нового Span и TextPointer, задающий позицию вставки для нового элемента Inline. |
Span(TextPointer, TextPointer) |
Инициализация нового экземпляра класса Span, используя два объекта TextPointer, определяющих начало и конец выбора содержимого, которое будет включено в новый Span. |
Span()
Инициализирует новый пустой экземпляр класса Span.
public:
Span();
public Span ();
Public Sub New ()
Применяется к
Span(Inline)
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)
Параметры
Примеры
В следующем примере показано, как использовать этот конструктор для создания нового диапазона, содержащего объект 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)
Инициализация нового экземпляра класса Span, используя заданный объект Inline в качестве начального содержимого нового Span и TextPointer, задающий позицию вставки для нового элемента 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)
Параметры
- childInline
- Inline
Объект Inline, задающий начальное содержимое нового Span. Данный параметр может быть пустым, в таком случае вставка Inline не выполняется.
- insertionPosition
- TextPointer
TextPointer, указывающий позицию, в которую необходимо вставить элемент Span после его создания, или значение null, чтобы не выполнять автоматическую вставку.
Примеры
В следующем примере показано, как использовать этот конструктор для создания нового Span элемента, содержащего вставленный Run в начале объекта 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)
Инициализация нового экземпляра класса Span, используя два объекта TextPointer, определяющих начало и конец выбора содержимого, которое будет включено в новый 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)
Параметры
- start
- TextPointer
TextPointer, указывающий начало выбора содержимого, которое будет включено в новый Span.
- end
- TextPointer
TextPointer, указывающий конец выбора содержимого, которое будет включено в новый Span.
Исключения
Вызывается, когда start
или end
имеет значение null.
Вызывается, когда start
и end
не разрешаются в диапазон содержимого, подходящего для вложения элементом Span. Например, если start
и end
указывают на позиции в различных абзацах.
Примеры
В следующем примере показано, как использовать этот конструктор для создания нового Span объекта, применяемого к диапазону содержимого. Диапазон содержимого определяется начальными и конечными TextPointer объектами, указанными конструктором.
// 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")
На следующем рисунке показано, как этот пример отрисовывается в .FlowDocument
Комментарии
Этот конструктор предназначен для инициализации нового Span элемента, чтобы он заключал в себя выбор существующего содержимого.