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 : InlinePublic 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 — это родительский класс для нескольких производных классов, которые определяют область встроенного текста с определенным соглашением о форматировании:
- Полужирный
- Гиперссылка
- Наклонный
- Гиперссылка подчеркивания включает поведение щелчка, при переходе к NavigateUri. Другие производные классы 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) |