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используйте .
Для рисования Visualс помощью используйте VisualBrush.

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

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

Компоненты TileBrush, компоненты
Компоненты TileBrush с одним элементом мозаики

Компоненты мозаичного элемента TileBrush
Компоненты TileBrush с TileMode, имеющим значение Tile

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

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

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

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

Область вывода. Выходная область — это область, которую закрашивает кисть, например Fill Ellipse , или Background Button.

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

Возможности объектов Freezable

— TileBrush это Freezable тип. Сведения о функциях, таких как замораживание и клонирование, см. в разделе Общие сведения об 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)	Применяет AnimationClock к заданному DependencyProperty. Если свойство уже анимировано, используется эстафетное поведение SnapshotAndReplace. (Унаследовано от Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Применяет AnimationClock к заданному DependencyProperty. Если свойство уже является анимированным, используется указанное поведение HandoffBehavior. (Унаследовано от Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Применяет анимацию к указанному DependencyProperty. Анимация начинается при отрисовке следующего кадра. Если указанное свойство уже анимировано, используется поведение перемещения SnapshotAndReplace. (Унаследовано от Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Применяет анимацию к указанному DependencyProperty. Анимация начинается при отрисовке следующего кадра. Если указанное свойство уже является анимированным, используется указанное поведение HandoffBehavior. (Унаследовано от 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)	Обеспечивает создание соответствующих указателей контекста для элемента данных типа DependencyObjectType, который был только что задан. (Унаследовано от Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Этот элемент поддерживает инфраструктуру Windows Presentation Foundation (WPF) и не предназначен для использования непосредственно из кода. (Унаследовано от 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)

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