Span Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Группировка других элементов встроенного содержимого. Родительский класс для полужирного, гиперссылок, курсивного и подчеркивания.
/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Inlines")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Span : Inline[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Inlines")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Span : InlinePublic Class Span
Inherits Inline<Span .../>
-or-
<Span ...>
oneOrMoreInlines
</Span>
-or-
<Span ...>
mixedContent
</Span>
- Наследование
- Производный
- Атрибуты
Комментарии
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 — это родительский класс для нескольких производных классов, определяющих область встроенного текста с определенным соглашением о форматировании:
- Полужирный
- Гиперссылка
- Наклонный
- Гиперссылка подчеркивания обеспечивает поведение щелчка, которое переходит к NavigateUri. Другие производные классы Span можно рассматривать как элементы оформления текста, относящиеся к определенному классу, и в противном случае они не добавляют взаимодействия.
Конструкторы
| Span() |
Инициализирует новый экземпляр класса Span . |
Свойства
| AccessKey |
Возвращает или задает ключ доступа для этого элемента. (Унаследовано от TextElement) |
| AccessKeyScopeOwner |
Возвращает или задает исходный элемент, предоставляющий ключ доступа область для этого элемента, даже если он не находится в визуальном дереве исходного элемента. (Унаследовано от TextElement) |
| AllowFocusOnInteraction |
Возвращает или задает значение, указывающее, получает ли элемент автоматически фокус при взаимодействии с ним. (Унаследовано от TextElement) |
| CharacterSpacing |
Возвращает или задает единый интервал между символами в единицах 1/1000 em. (Унаследовано от TextElement) |
| ContentEnd |
Возвращает объект TextPointer , представляющий конец содержимого в элементе . (Унаследовано от TextElement) |
| ContentStart |
Возвращает объект TextPointer , представляющий начало содержимого в элементе . (Унаследовано от TextElement) |
| Dispatcher |
Всегда возвращается |
| DispatcherQueue |
Возвращает объект , |
| 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) |