Поделиться через


Span Класс

Определение

Группировка других элементов встроенного содержимого. Родительский класс для полужирного,гиперссылок, курсива и подчеркивания.

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Inlines")]
class Span : Inline
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Inlines")]
public class Span : Inline
Public Class Span
Inherits Inline
<Span .../>
-or-
<Span ...>
  oneOrMoreInlines
</Span>
-or-
<Span ...>
  mixedContent
</Span>
Наследование
Производный
Атрибуты

Требования к Windows

Семейство устройств
Windows 10 (появилось в 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v1.0)

Комментарии

Вы можете использовать Span в качестве объектного элемента в XAML для заключения текста. Это обеспечивает аналогичное использование тега span в HTML. Для этого необходимо задать атрибуты, поддерживаемые TextElement , например FontSize или FontFamily, чтобы можно было применить эти решения по форматированию к заключенному фрагменту текста. Функция Run имеет аналогичные функции применения свойств TextElement к диапазону текста, но run не поддерживает смешанное содержимое (его свойство содержимого Run.Text XAML может содержать только текст, а не смешанное содержимое и другие встроенные элементы).

Span поддерживает смешанное содержимое, если оно задано в XAML. Это означает, что вы можете смешивать встроенные теги, такие как Run, Bold и т. д., с текстовым содержимым XAML (обычный текст), без ограничений в порядке, в котором должны отображаться теги и текст. Весь текст, будь то обычный текст или как заключенный в встроенный тег, отрисовывается в том порядке, в соответствии с которым текст определен в смешанном содержимом. Например, это допустимый КОД XAML:

<RichTextBlock>
  <Paragraph>
    <Span>This is <Bold>mixed content</Bold> with multiple text areas <Italic> and inlines</Italic>.</Span>
  </Paragraph>
</RichTextBlock>

При анализе смешанного содержимого из XAML и анализе текстовой объектной модели во время выполнения любая текстовая область, полученная из обычного текста, создает объект Run в соответствующей позиции порядка чтения в классе коллекции InlineCollection , который обеспечивает доступ во время выполнения. Этот элемент Run содержит текст, но в противном случае не имеет заданных свойств.

Примечание

Размещение содержимого XAML независимо от тегов или текста непосредственно в элементе Span поддерживается, так как Span обозначает, что его свойство Inlines является свойством содержимого XAML. Дополнительные сведения о свойствах содержимого XAML см. в разделе "Свойства содержимого XAML" руководства по синтаксису XAML.

Элементы Span обычно используются в качестве элементов inlineCollection либо как дочерние элементы Paragraph (становится частью Paragraph.Inlines), либо как содержимое другого Span (становится частью Span.Inlines).

Диапазон производных классов

Span — это родительский класс для нескольких производных классов, которые определяют область встроенного текста с определенным соглашением о форматировании:

Конструкторы

Span()

Инициализирует новый экземпляр класса Span .

Свойства

AccessKey

Возвращает или задает ключ доступа для этого элемента.

(Унаследовано от TextElement)
AccessKeyScopeOwner

Возвращает или задает исходный элемент, предоставляющий ключ доступа область для этого элемента, даже если он не находится в визуальном дереве исходного элемента.

(Унаследовано от TextElement)
AllowFocusOnInteraction

Возвращает или задает значение, указывающее, получает ли элемент фокус автоматически, когда пользователь взаимодействует с ним.

(Унаследовано от TextElement)
CharacterSpacing

Возвращает или задает равномерный интервал между символами в единицах 1/1000 em.

(Унаследовано от TextElement)
ContentEnd

Возвращает объект TextPointer , представляющий конец содержимого в элементе .

(Унаследовано от TextElement)
ContentStart

Возвращает объект TextPointer , представляющий начало содержимого в элементе .

(Унаследовано от TextElement)
Dispatcher

Возвращает объект CoreDispatcher , с которым связан этот объект. CoreDispatcher представляет собой средство, которое может получить доступ к DependencyObject в потоке пользовательского интерфейса, даже если код инициируется потоком, не относящегося к пользовательскому интерфейсу.

(Унаследовано от DependencyObject)
ElementEnd

Возвращает объект TextPointer , представляющий позицию сразу после конца элемента.

(Унаследовано от TextElement)
ElementStart

Возвращает объект TextPointer , представляющий позицию непосредственно перед началом элемента.

(Унаследовано от TextElement)
ExitDisplayModeOnAccessKeyInvoked

Возвращает или задает значение, указывающее, закрывается ли отображение ключа доступа при вызове ключа доступа.

(Унаследовано от TextElement)
FontFamily

Возвращает или задает предпочтительное семейство шрифтов верхнего уровня для содержимого элемента.

(Унаследовано от TextElement)
FontSize

Получает или задает размер шрифта для содержимого элемента.

(Унаследовано от TextElement)
FontStretch

Возвращает или задает ширину глифа шрифта в семействе для выбора.

(Унаследовано от TextElement)
FontStyle

Возвращает или задает стиль шрифта для содержимого в этом элементе.

(Унаследовано от TextElement)
FontWeight

Возвращает или задает вес шрифта верхнего уровня, выбираемый из семейства шрифтов для содержимого в этом элементе.

(Унаследовано от TextElement)
Foreground

Возвращает или задает кисть для применения к содержимому в этом элементе.

(Унаследовано от TextElement)
Inlines

Возвращает коллекцию InlineCollection , содержащую встроенные элементы верхнего уровня, содержащие содержимое Span.

IsAccessKeyScope

Возвращает или задает значение, указывающее, определяет ли элемент собственный ключ доступа область.

(Унаследовано от TextElement)
IsTextScaleFactorEnabled

Возвращает или задает значение, указывающее, включено ли автоматическое увеличение текста в соответствии с параметром системного размера текста.

(Унаследовано от TextElement)
KeyTipHorizontalOffset

Возвращает или задает значение, указывающее, насколько далеко слева или справа расположена подсказка клавиши относительно текстового элемента.

(Унаследовано от TextElement)
KeyTipPlacementMode

Возвращает или задает значение, указывающее, где находится подсказка клавиши относительно текстового элемента.

(Унаследовано от TextElement)
KeyTipVerticalOffset

Возвращает или задает значение, указывающее, насколько далеко расположена подсказка клавиши по отношению к текстовому элементу.

(Унаследовано от TextElement)
Language

Возвращает или задает сведения о языке локализации и глобализации, которые применяются к Элементу TextElement.

(Унаследовано от TextElement)
Name

Возвращает или задает уникальную идентификацию для объекта . Имя можно задать только при первоначальном синтаксическом анализе XAML.

(Унаследовано от TextElement)
TextDecorations

Возвращает или задает значение, указывающее, какие украшения применяются к тексту.

(Унаследовано от TextElement)
XamlRoot

Возвращает или задает xamlRoot, в котором просматривается данный элемент.

(Унаследовано от TextElement)

Методы

ClearValue(DependencyProperty)

Очищает локальное значение свойства зависимостей.

(Унаследовано от DependencyObject)
FindName(String)

Извлекает объект в объектной модели или графе объектов среды выполнения, ссылаясь на значение атрибута x:Name или Name объекта.

(Унаследовано от TextElement)
GetAnimationBaseValue(DependencyProperty)

Возвращает любое базовое значение, установленное для свойства зависимостей, которое применяется в случаях, когда анимация не активна.

(Унаследовано от DependencyObject)
GetValue(DependencyProperty)

Возвращает текущее действующее значение свойства зависимостей из DependencyObject.

(Унаследовано от DependencyObject)
OnDisconnectVisualChildren()

Переопределите этот метод, чтобы реализовать поведение макета и логики при удалении элементов из содержимого или дочернего свойства класса.

(Унаследовано от TextElement)
ReadLocalValue(DependencyProperty)

Возвращает локальное значение свойства зависимостей, если задано локальное значение.

(Унаследовано от DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

Регистрирует функцию уведомления для прослушивания изменений определенного DependencyProperty в этом экземпляре DependencyObject .

(Унаследовано от DependencyObject)
SetValue(DependencyProperty, Object)

Задает локальное значение свойства зависимостей для Объекта DependencyObject.

(Унаследовано от DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Отменяет уведомление об изменениях, которое было ранее зарегистрировано путем вызова Метода RegisterPropertyChangedCallback.

(Унаследовано от DependencyObject)

События

AccessKeyDisplayDismissed

Происходит после завершения последовательности ключей доступа для уведомления элементов управления о том, что они должны скрывать визуальные элементы ключа доступа.

(Унаследовано от TextElement)
AccessKeyDisplayRequested

Происходит при запуске последовательности ключей доступа для уведомления элементов управления о том, что они должны отображать визуальные элементы ключа доступа.

(Унаследовано от TextElement)
AccessKeyInvoked

Происходит, когда пользователь завершает последовательность клавиш доступа, чтобы уведомить элемент о том, что необходимо вызвать действие ключа доступа.

(Унаследовано от TextElement)

Применяется к

См. также раздел