Block Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Абстрактный класс, предоставляющий основу для всех элементов содержимого уровня блока.
public ref class Block : TextElement
/// [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 Block : TextElement
[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 Block : TextElement
Public Class Block
Inherits TextElement
- Наследование
- Производный
- Атрибуты
Комментарии
Блок определяет свойства форматирования текста, которые должны применяться ко всем типам содержимого блока. Эти свойства: LineHeight, LineStackingStrategy, Margin и TextAlignment. Блок также наследует свойства форматирования текста и другие API TextElement.
В словаре XAML среды выполнения Windows единственный тип блока — "Абзац". С помощью абзаца можно определить блоки текста, отображаемые в элементе управления RichTextBlock . Каждый RichTextBlock должен содержать по крайней мере один абзац.
BlockCollection — это строго типизированный класс коллекции, используемый свойством RichTextBlock.Block . Указав элементы объекта XAML в RichTextBlock, можно назначить блочное текстовое содержимое для RichTextBlock. Обычно это делается с помощью неявной коллекции и синтаксиса свойств XAML, поэтому элементы Paragraph отображаются как прямые дочерние элементы RichTextBlock в разметке XAML. Рассмотрим пример.
<RichTextBlock>
<Paragraph>First paragraph.</Paragraph>
<Paragraph>Second paragraph.</Paragraph>
<Paragraph>Third paragraph. <Bold>With an inline.</Bold></Paragraph>
</RichTextBlock>
Блочные производные классы
Блокировать является родительским классом для Абзаца.
Примечания о переходе
Словарь XAML среды выполнения Windows не поддерживает класс Section . Если вы переносите XAML из Windows Presentation Foundation (WPF), используйте вместо этого элемент блока абзаца .
Конструкторы
| Имя | Описание |
|---|---|
| Block() |
Предоставляет поведение инициализации базового класса для производных классов block . |
Свойства
| Имя | Описание |
|---|---|
| AccessKey |
Возвращает или задает ключ доступа для этого элемента. (Унаследовано от TextElement) |
| AccessKeyScopeOwner |
Возвращает или задает исходный элемент, предоставляющий область ключа доступа для этого элемента, даже если он не находится в визуальном дереве исходного элемента. (Унаследовано от TextElement) |
| AllowFocusOnInteraction |
Возвращает или задает значение, указывающее, автоматически ли элемент получает фокус при взаимодействии с ним пользователем. (Унаследовано от TextElement) |
| CharacterSpacing |
Возвращает или задает равномерное интервал между символами в единицах 1/1000 эм. (Унаследовано от 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) |
| HorizontalTextAlignment |
Возвращает или задает значение, указывающее, как выровнен текст в блоке. |
| HorizontalTextAlignmentProperty |
Определяет свойство зависимостей HorizontalTextAlignment. |
| IsAccessKeyScope |
Возвращает или задает значение, указывающее, определяет ли элемент собственную область ключа доступа. (Унаследовано от TextElement) |
| IsTextScaleFactorEnabled |
Возвращает или задает, включен ли автоматическое расширение текста для отражения параметра размера системного текста. (Унаследовано от TextElement) |
| KeyTipHorizontalOffset |
Возвращает или задает значение, указывающее, насколько слева или справа находится подсказка в связи с текстовым элементом. (Унаследовано от TextElement) |
| KeyTipPlacementMode |
Возвращает или задает значение, указывающее, где находится подсказка ключа в связи с текстовым элементом. (Унаследовано от TextElement) |
| KeyTipVerticalOffset |
Возвращает или задает значение, указывающее, насколько далеко вверх или вниз подсказка помещается в отношение к текстовому элементу. (Унаследовано от TextElement) |
| Language |
Возвращает или задает сведения о языке локализации и глобализации, которые применяются к TextElement. (Унаследовано от TextElement) |
| LineHeight |
Возвращает или задает высоту каждой строки содержимого. |
| LineHeightProperty |
Определяет свойство зависимости LineHeight . |
| LineStackingStrategy |
Возвращает или задает значение, указывающее, как определяется поле строки для каждой строки текста в блоке. |
| LineStackingStrategyProperty |
Определяет свойство зависимостей LineStackingStrategy . |
| Margin |
Возвращает или задает объем пространства вокруг элемента Block . |
| MarginProperty |
Определяет свойство зависимости Margin . |
| Name |
Возвращает или задает уникальную идентификацию объекта. Имя можно задать только из начального синтаксического анализа XAML. (Унаследовано от TextElement) |
| TextAlignment |
Возвращает или задает горизонтальное выравнивание текстового содержимого. |
| TextAlignmentProperty |
Определяет свойство зависимостей TextAlignment . |
| 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) |