TileBrush Класс

Определение

Пространство имен:: System.Windows.Media

Сборка:: PresentationCore.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Описывает способ рисования региона с помощью одной или нескольких плиток.

public ref class TileBrush abstract : System::Windows::Media::Brush

public abstract class TileBrush : System.Windows.Media.Brush

type TileBrush = class
    inherit Brush

Public MustInherit Class TileBrush
Inherits Brush

Наследование: Object

DispatcherObject

DependencyObject

Freezable

Animatable

Brush
TileBrush

Производный: System.Windows.Media.DrawingBrush

System.Windows.Media.ImageBrush

System.Windows.Media.VisualBrush

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

Используйте для TileBrush управления тем, как вы красите область. Например, Windows Presentation Foundation (WPF) предоставляет несколько типов кистей:

Для рисования с помощью изображения используйте элемент ImageBrush.
Для рисования с помощью рисунка используйте .DrawingBrush
Для рисования с помощью >.

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

При рисовании области с помощью TileBrushэлемента используется три компонента: содержимое, плитки и область вывода. На следующих иллюстрациях показано, как эти три TileBrush компонента связаны друг с другом.

Компоненты TileBrush, Компоненты ПлиткиBrush с одной плиткой

Компоненты плитки TileBrush с элементом TileMode

Содержимое: может TileBrush иметь различные типы содержимого:

Если кисть является, ImageBrushэто содержимое является изображением. Свойство ImageSource указывает содержимое объекта ImageBrush.
Если кисть является кистью DrawingBrush, это содержимое является рисунком. Свойство Drawing указывает содержимое объекта DrawingBrush.
Если кисть является, VisualBrushэто содержимое является визуальным элементом. Свойство Visual указывает содержимое VisualBrushобъекта .

Вы можете указать положение и размеры содержимого TileBrush с помощью Viewbox свойства.

Плитки: создается TileBrush одна или несколько плиток. По умолчанию содержимое кисти растянуто для заполнения одной плитки, и эта плитка растянута для заполнения области вывода. Свойство Viewport используется для указания размера и положения базовой плитки для объекта TileBrush. Свойство ViewportUnits определяет, является ли размер и положение Viewport относительно выходной области (поведением по умолчанию) или являются ли они абсолютными значениями.

Область вывода: область вывода — это область, которая красит кисть, например Fill Ellipse область или Background область Button.

Дополнительные сведения о классе см. в TileBrush разделе "Рисование с изображениями", "Рисунки" и "Визуальные элементы ".

Бесплатные функции

A TileBrush — это Freezable тип. Сведения о Freezable функциях, таких как замораживание и клонирование, см. в обзоре освобожденных объектов.

Примечания для тех, кто реализует этот метод

При наследовании от TileBrush класса необходимо переопределить CreateInstanceCore() метод. Дополнительные сведения о наследовании от Freezable типов см. в обзоре объектов Freezable.

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

Имя	Описание
TileBrush()	Предоставляет инициализацию значений базового класса при вызове конструктором производного класса.

Поля

Имя	Описание
AlignmentXProperty	Определяет AlignmentX свойство зависимостей.
AlignmentYProperty	Определяет AlignmentY свойство зависимостей.
StretchProperty	Определяет Stretch свойство зависимостей.
TileModeProperty	Определяет TileMode свойство зависимостей.
ViewboxProperty	Определяет Viewbox свойство зависимостей.
ViewboxUnitsProperty	Определяет ViewboxUnits свойство зависимостей.
ViewportProperty	Определяет Viewport свойство зависимостей.
ViewportUnitsProperty	Определяет ViewportUnits свойство зависимостей.

Свойства

Имя	Описание
AlignmentX	Возвращает или задает горизонтальное выравнивание содержимого на базовой плитке TileBrush .
AlignmentY	Возвращает или задает вертикальное выравнивание содержимого на базовой плитке TileBrush .
CanFreeze	Возвращает значение, указывающее, можно ли изменить объект. (Унаследовано от Freezable)
DependencyObjectType	Возвращает объект DependencyObjectType , который упаковывает тип СРЕДЫ CLR этого экземпляра. (Унаследовано от DependencyObject)
Dispatcher	Dispatcher Возвращает это DispatcherObject значение, с которым связано. (Унаследовано от DispatcherObject)
HasAnimatedProperties	Возвращает значение, указывающее, связан ли один или несколько AnimationClock объектов с любым из свойств зависимостей этого объекта. (Унаследовано от Animatable)
IsFrozen	Возвращает значение, указывающее, является ли объект изменяемым в настоящее время. (Унаследовано от Freezable)
IsSealed	Возвращает значение, указывающее, запечатан ли этот экземпляр (только для чтения). (Унаследовано от DependencyObject)
Opacity	Возвращает или задает степень непрозрачности объекта Brush. (Унаследовано от Brush)
RelativeTransform	Возвращает или задает преобразование, которое применяется к кисти с помощью относительных координат. (Унаследовано от Brush)
Stretch	Возвращает или задает значение, указывающее, как содержимое этого TileBrush растяжения соответствует его плиткам.
TileMode	Возвращает или задает значение, указывающее, как TileBrush заполняется область, которую вы рисуете, если базовая плитка меньше выходной области.
Transform	Возвращает или задает преобразование, которое применяется к кисти. Это преобразование применяется после того, как выходные данные кисти сопоставлены и расположены. (Унаследовано от Brush)
Viewbox	Возвращает или задает положение и размеры содержимого на плитке TileBrush .
ViewboxUnits	Возвращает или задает значение, указывающее, является ли Viewbox значение относительно ограничивающего поля содержимого TileBrush или является ли значение абсолютным.
Viewport	Возвращает или задает положение и размеры базовой плитки для объекта TileBrush.
ViewportUnits	Возвращает или задает BrushMappingMode перечисление, указывающее, является ли значение Viewportобъекта , указывающее размер и позицию TileBrush базовой плитки, относительно размера области вывода.

Методы

Имя	Описание
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Применяется к указанному объекту AnimationClock DependencyProperty. Если свойство уже анимировано, используется указанный HandoffBehavior параметр. (Унаследовано от Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Применяется к указанному объекту AnimationClock DependencyProperty. Если свойство уже анимировано, SnapshotAndReplace используется поведение передачи. (Унаследовано от Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Применяет анимацию к указанному DependencyProperty. Анимация запускается при отрисовки следующего кадра. Если указанное свойство уже анимировано, используется указанный HandoffBehavior параметр. (Унаследовано от Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Применяет анимацию к указанному DependencyProperty. Анимация запускается при отрисовки следующего кадра. Если указанное свойство уже анимировано, SnapshotAndReplace используется поведение передачи. (Унаследовано от Animatable)
CheckAccess()	Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject. (Унаследовано от DispatcherObject)
ClearValue(DependencyProperty)	Очищает локальное значение свойства. Свойство для очистки указывается идентификатором DependencyProperty . (Унаследовано от DependencyObject)
ClearValue(DependencyPropertyKey)	Очищает локальное значение свойства только для чтения. Свойство, которое необходимо очистить, задается параметром DependencyPropertyKey. (Унаследовано от DependencyObject)
Clone()	Создает изменяемую копию, TileBrush делая глубокие копии его значений.
CloneCore(Freezable)	Делает экземпляр клоном (глубокой копией) указанных Freezable значений свойств с использованием базовых (не анимированных) значений свойств. (Унаследовано от Freezable)
CloneCurrentValue()	Создает изменяемую копию этого TileBrush объекта, делая глубокие копии его значений. Этот метод не копирует ссылки на ресурсы, привязки данных или анимации, хотя он копирует текущие значения.
CloneCurrentValueCore(Freezable)	Делает экземпляр модификируемым клоном (глубокой копией) указанного Freezable с использованием текущих значений свойств. (Унаследовано от Freezable)
CoerceValue(DependencyProperty)	Принуждает значение указанного свойства зависимостей. Это достигается путем вызова любой CoerceValueCallback функции, указанной в метаданных свойств для свойства зависимостей, так как он существует при вызове DependencyObject. (Унаследовано от DependencyObject)
CreateInstance()	Инициализирует новый экземпляр класса Freezable. (Унаследовано от Freezable)
CreateInstanceCore()	При реализации в производном классе создает новый экземпляр производного Freezable класса. (Унаследовано от Freezable)
Equals(Object)	Определяет, эквивалентен ли предоставленный DependencyObject объект текущему DependencyObject. (Унаследовано от DependencyObject)
Freeze()	Делает текущий объект неизменяемым и задает для свойства значение IsFrozen`true`. (Унаследовано от Freezable)
FreezeCore(Boolean)	Делает этот Animatable объект неизменяемым или определяет, может ли он быть изменен. (Унаследовано от Animatable)
GetAnimationBaseValue(DependencyProperty)	Возвращает неанимированное значение указанного DependencyProperty. (Унаследовано от Animatable)
GetAsFrozen()	Создает замороженную копию базовых Freezable(не анимированных) значений свойств. Так как копия заморожена, все замороженные вложенные объекты копируются по ссылке. (Унаследовано от Freezable)
GetAsFrozenCore(Freezable)	Делает экземпляр замороженным клоном указанных Freezable значений свойств (не анимированных). (Унаследовано от Freezable)
GetContentBounds(Rect)	Получает текущие границы содержимого TileBrush .
GetCurrentValueAsFrozen()	Создает замороженную копию с использованием текущих значений Freezable свойств. Так как копия заморожена, все замороженные вложенные объекты копируются по ссылке. (Унаследовано от Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Делает текущий экземпляр замороженным клоном указанного Freezable. Если объект имеет анимированные свойства зависимостей, их текущие анимированные значения копируются. (Унаследовано от Freezable)
GetHashCode()	Получает хэш-код для этого DependencyObject. (Унаследовано от DependencyObject)
GetLocalValueEnumerator()	Создает специализированный перечислитель для определения того, какие свойства зависимостей имеют локальные значения для этого DependencyObject. (Унаследовано от DependencyObject)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
GetValue(DependencyProperty)	Возвращает текущее эффективное значение свойства зависимостей для этого экземпляра DependencyObject. (Унаследовано от DependencyObject)
InvalidateProperty(DependencyProperty)	Повторно вычисляет эффективное значение для указанного свойства зависимостей. (Унаследовано от DependencyObject)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
OnChanged()	Вызывается при изменении текущего Freezable объекта. (Унаследовано от Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Этот член поддерживает инфраструктуру Windows Presentation Foundation (WPF) и не предназначен для использования непосредственно из кода. (Унаследовано от Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Убедитесь, что для элемента данных, который только что был установлен, установлены DependencyObjectType соответствующие указатели контекста. (Унаследовано от Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Переопределяет DependencyObject реализацию OnPropertyChanged(DependencyPropertyChangedEventArgs) для вызова всех Changed обработчиков в ответ на изменение свойства зависимостей типа Freezable. (Унаследовано от Freezable)
ReadLocalValue(DependencyProperty)	Возвращает локальное значение свойства зависимостей, если оно существует. (Унаследовано от DependencyObject)
ReadPreamble()	Гарантирует, что Freezable доступ к ней осуществляется из допустимого потока. Наследующие метод Freezable должны вызывать этот метод в начале любого API, который считывает элементы данных, которые не являются свойствами зависимостей. (Унаследовано от Freezable)
SetCurrentValue(DependencyProperty, Object)	Задает значение свойства зависимостей, не изменяя его источник значений. (Унаследовано от DependencyObject)
SetValue(DependencyProperty, Object)	Задает локальное значение свойства зависимостей, указанное его идентификатором свойства зависимостей. (Унаследовано от DependencyObject)
SetValue(DependencyPropertyKey, Object)	Задает локальное значение свойства зависимостей только для чтения, указанное DependencyPropertyKey идентификатором свойства зависимости. (Унаследовано от DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Возвращает значение, указывающее, должны ли процессы сериализации сериализовать значение для указанного свойства зависимостей. (Унаследовано от DependencyObject)
ToString()	Возвращает строковое представление этого Brushобъекта. (Унаследовано от Brush)
ToString(IFormatProvider)	Создает строковое представление этого объекта на основе указанных сведений о форматировании, зависящих от языка и региональных параметров. (Унаследовано от Brush)
VerifyAccess()	Принудительно применяет, что вызывающий поток имеет доступ к этому DispatcherObject. (Унаследовано от DispatcherObject)
WritePostscript()	Changed Вызывает событие для Freezable метода и вызывает его OnChanged() метод. Классы, производные от Freezable этого метода, должны вызываться в конце любого API, который изменяет элементы класса, которые не хранятся в качестве свойств зависимостей. (Унаследовано от Freezable)
WritePreamble()	Проверяет, что Freezable он не заморожен и к нему осуществляется доступ из допустимого контекста потоков. Freezable наследующие метод должны вызывать этот метод в начале любого API, записывающего элементы данных, которые не являются свойствами зависимостей. (Унаследовано от Freezable)

События

Имя	Описание
Changed	Происходит при Freezable изменении объекта или объекта, содержащего его. (Унаследовано от Freezable)

Явные реализации интерфейса

Имя	Описание
IFormattable.ToString(String, IFormatProvider)	Форматирует значение текущего экземпляра с помощью указанного формата. (Унаследовано от Brush)

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

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

Обратная связь

Были ли сведения на этой странице полезными?

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