DrawingVisual Класс

Ссылка

Определение

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

Сборка:: PresentationCore.dll

Важно!

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

DrawingVisual — это визуальный объект, который можно использовать для отрисовки векторной графики на экране. Содержимое сохраняется системой.

public ref class DrawingVisual : System::Windows::Media::ContainerVisual

public class DrawingVisual : System.Windows.Media.ContainerVisual

type DrawingVisual = class
    inherit ContainerVisual

Public Class DrawingVisual
Inherits ContainerVisual

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

DispatcherObject

DependencyObject

Visual

ContainerVisual
DrawingVisual

DrawingVisual — это упрощенный класс рисования, используемый для отрисовки фигур, изображений или текста. Этот класс считается упрощенным, так как он не предоставляет макет, ввод, фокус или обработку событий, что повышает его производительность. Поэтому этот класс идеально подходит для фоновых рисунков или клипов.

Чтобы использовать DrawingVisual объекты, необходимо создать контейнер узла для объектов. Объект контейнера узла должен быть производным FrameworkElement от класса, который обеспечивает поддержку макета и обработки событий, которые DrawingVisual класс не поддерживает. Объект контейнера узла не отображает никаких визуальных свойств, так как его основная цель — содержать дочерние объекты. Дополнительные сведения см. в разделе Использование объектов DrawingVisual.

Полный пример создания DrawingVisual объектов с контейнером узла см. в примере "Тест попадания с помощью DrawingVisuals ".

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

DrawingVisual()

Инициализирует новый экземпляр класса DrawingVisual.

Свойства

BitmapEffect	Является устаревшей. Является устаревшей. Получает или задает значение BitmapEffect для ContainerVisual. (Унаследовано от ContainerVisual)
BitmapEffectInput	Является устаревшей. Является устаревшей. Получает или задает значение BitmapEffectInput для ContainerVisual. (Унаследовано от ContainerVisual)
CacheMode	Получает или задает кэшированное представление объекта ContainerVisual. (Унаследовано от ContainerVisual)
Children	Получает дочернюю коллекцию данного ContainerVisual. (Унаследовано от ContainerVisual)
Clip	Возвращает или устанавливает вырезанную область объекта ContainerVisual. (Унаследовано от ContainerVisual)
ContentBounds	Получает ограничивающий объект для содержимого объекта ContainerVisual. (Унаследовано от ContainerVisual)
DependencyObjectType	Возвращает объект DependencyObjectType , который заключает в оболочку тип среды CLR данного экземпляра. (Унаследовано от DependencyObject)
DescendantBounds	Получает объединение всех ограничивающих прямоугольников содержимого для всех потомков объекта ContainerVisual, но без включения содержимого объекта ContainerVisual. (Унаследовано от ContainerVisual)
Dispatcher	Возвращает объект Dispatcher, с которым связан этот объект DispatcherObject. (Унаследовано от DispatcherObject)
Drawing	Получает содержимое рисунка объекта DrawingVisual.
Effect	Получает или задает эффект растрового изображения, который применяется к объекту ContainerVisual. (Унаследовано от ContainerVisual)
IsSealed	Получает значение, указывающее, является ли этот экземпляр в данный момент запечатанным (доступным только для чтения). (Унаследовано от DependencyObject)
Offset	Получает или задает значение смещения ContainerVisual от его опорной точки. (Унаследовано от ContainerVisual)
Opacity	Получает или задает непрозрачность объекта ContainerVisual исходя из таких значений: 0=прозрачность, 1=непрозрачность. (Унаследовано от ContainerVisual)
OpacityMask	Получает или задает кисть, определяющую возможную маску непрозрачности для ContainerVisual. (Унаследовано от ContainerVisual)
Parent	Получает родительский объект Visual для ContainerVisual. (Унаследовано от ContainerVisual)
Transform	Получает или задает преобразование, применяемое к ContainerVisual. (Унаследовано от ContainerVisual)
VisualBitmapEffect	Является устаревшей. Является устаревшей. Получает или задает значение BitmapEffect для объекта Visual. (Унаследовано от Visual)
VisualBitmapEffectInput	Является устаревшей. Является устаревшей. Получает или задает значение BitmapEffectInput для объекта Visual. (Унаследовано от Visual)
VisualBitmapScalingMode	Возвращает или задает BitmapScalingMode для объекта Visual. (Унаследовано от Visual)
VisualCacheMode	Получает или задает кэшированное представление объекта Visual. (Унаследовано от Visual)
VisualChildrenCount	Возвращает количество дочерних элементов для ContainerVisual. (Унаследовано от ContainerVisual)
VisualClearTypeHint	Получает или задает объект ClearTypeHint, который определяет способ отображения ClearType в Visual. (Унаследовано от Visual)
VisualClip	Возвращает или задает отсеченную область объекта Visual в виде значения Geometry. (Унаследовано от Visual)
VisualEdgeMode	Возвращает или задает края объекта Visual в виде значения EdgeMode. (Унаследовано от Visual)
VisualEffect	Получает или задает эффект растрового изображения, который применяется к объекту Visual. (Унаследовано от Visual)
VisualOffset	Возвращает или задает значение смещения визуального объекта. (Унаследовано от Visual)
VisualOpacity	Получает или задает значение прозрачности для объекта Visual. (Унаследовано от Visual)
VisualOpacityMask	Возвращает или задает значение Brush, которое представляет маску непрозрачности объекта Visual. (Унаследовано от Visual)
VisualParent	Получает для визуального объекта родительский объект визуального дерева. (Унаследовано от Visual)
VisualScrollableAreaClip	Получает или задает обрезанную прокручиваемую область для объекта Visual. (Унаследовано от Visual)
VisualTextHintingMode	Получает или задает TextHintingMode объекта Visual. (Унаследовано от Visual)
VisualTextRenderingMode	Получает или задает TextRenderingMode объекта Visual. (Унаследовано от Visual)
VisualTransform	Получает или задает значение Transform для объекта Visual. (Унаследовано от Visual)
VisualXSnappingGuidelines	Получает или задает коллекцию направляющих по оси X (по вертикали). (Унаследовано от Visual)
VisualYSnappingGuidelines	Получает или задает коллекцию горизонтальных направляющих (по оси Y). (Унаследовано от Visual)
XSnappingGuidelines	Получает или задает направляющую по оси X (горизонтальную) для ContainerVisual. (Унаследовано от ContainerVisual)
YSnappingGuidelines	Получает или задает направляющую по оси Y (вертикальную) для ContainerVisual. (Унаследовано от ContainerVisual)

Методы

AddVisualChild(Visual)	Определяет связь "родитель-потомок" между двумя визуальными объектами. (Унаследовано от Visual)
CheckAccess()	Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject. (Унаследовано от DispatcherObject)
ClearValue(DependencyProperty)	Очищает локальное значение свойства. Очищаемое свойство задается идентификатором DependencyProperty. (Унаследовано от DependencyObject)
ClearValue(DependencyPropertyKey)	Очищает локальное значение доступного только для чтения свойства. Очищаемое свойство задается ключом DependencyPropertyKey. (Унаследовано от DependencyObject)
CoerceValue(DependencyProperty)	Приводит значение указанного свойства зависимостей. Это осуществляется путем вызова какой-либо функции CoerceValueCallback, указанной в метаданных свойства зависимостей, которое существует в вызывающем объекте DependencyObject. (Унаследовано от DependencyObject)
Equals(Object)	Определяет, является ли указанный DependencyObject эквивалентом текущего DependencyObject. (Унаследовано от DependencyObject)
FindCommonVisualAncestor(DependencyObject)	Возвращает общего предка двух визуальных объектов. (Унаследовано от Visual)
GetHashCode()	Возвращает хэш-код для данного объекта DependencyObject. (Унаследовано от DependencyObject)
GetLocalValueEnumerator()	Создает специализированный перечислитель для определения свойств зависимостей, которые локально установили значения для данного DependencyObject. (Унаследовано от DependencyObject)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
GetValue(DependencyProperty)	Возвращает текущее действующее значение свойства зависимостей в этом экземпляре DependencyObject. (Унаследовано от DependencyObject)
GetVisualChild(Int32)	Возвращает указанный дочерний объект Visual родительского ContainerVisual. (Унаследовано от ContainerVisual)
HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)	Инициирует проверку нажатия для ContainerVisual с использованием объектов HitTestFilterCallback и HitTestResultCallback. (Унаследовано от ContainerVisual)
HitTest(Point)	Возвращает самый верхний визуальный объект для проверки нажатия, указывая тип Point. (Унаследовано от ContainerVisual)
HitTestCore(GeometryHitTestParameters)	Определяет, находится ли значение, соответствующее геометрии, в пределах границ визуального объекта.
HitTestCore(PointHitTestParameters)	Определяет, находится ли значение, соответствующее координате точки, в пределах границ объекта DrawingVisual.
InvalidateProperty(DependencyProperty)	Повторно вычисляет действующее значение для указанного свойства зависимостей. (Унаследовано от DependencyObject)
IsAncestorOf(DependencyObject)	Определяет, является ли визуальный объект предком потомка визуального объекта. (Унаследовано от Visual)
IsDescendantOf(DependencyObject)	Определяет, является ли визуальный объект потомком для предка визуального объекта. (Унаследовано от Visual)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
OnDpiChanged(DpiScale, DpiScale)	Вызывается, когда изменяется параметр "точек на дюйм", по которому определяется разрешение представления. (Унаследовано от Visual)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Вызывается каждый раз, когда обновляется действительное значение любого свойства зависимостей для данного DependencyObject. Конкретное измененное свойство зависимостей сообщается в данных события. (Унаследовано от DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)	Вызывается при изменении коллекции VisualCollection визуального объекта. (Унаследовано от Visual)
OnVisualParentChanged(DependencyObject)	Вызывается при изменении родительского объекта визуального объекта. (Унаследовано от Visual)
PointFromScreen(Point)	Преобразовывает объект Point в экранных координатах в объект Point, представляющий текущую систему координат Visual. (Унаследовано от Visual)
PointToScreen(Point)	Преобразовывает объект Point, представляющий текущую систему координат объекта Visual, в объект Point в экранных координатах. (Унаследовано от Visual)
ReadLocalValue(DependencyProperty)	Возвращает локальное значение свойства зависимостей, если таковое существует. (Унаследовано от DependencyObject)
RemoveVisualChild(Visual)	Удаляет связь "родитель-потомок" между двумя визуальными объектами. (Унаследовано от Visual)
RenderOpen()	Открывает объект DrawingVisual для отрисовки. Возвращенное значение DrawingContext можно использовать для отрисовки в объекте DrawingVisual.
SetCurrentValue(DependencyProperty, Object)	Задает значение свойства зависимостей, не меняя источник значения. (Унаследовано от DependencyObject)
SetValue(DependencyProperty, Object)	Задает локальное значение свойства зависимостей, указанного идентификатором этого свойства. (Унаследовано от DependencyObject)
SetValue(DependencyPropertyKey, Object)	Задает локальное значение свойства зависимости только для чтения, определяемое идентификатором DependencyPropertyKey свойства зависимостей. (Унаследовано от DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Возвращает значение, которое указывает, следует ли процессам сериализации выполнять сериализацию значения для предоставленного свойства зависимостей. (Унаследовано от DependencyObject)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
TransformToAncestor(Visual)	Возвращает преобразование, которое может использоваться для преобразования координат этого объекта Visual в координаты заданного предка визуального объекта Visual. (Унаследовано от Visual)
TransformToAncestor(Visual3D)	Возвращает преобразование, которое может использоваться для преобразования координат этого объекта Visual в координаты заданного предка визуального объекта Visual3D. (Унаследовано от Visual)
TransformToDescendant(Visual)	Возвращает преобразование, которое может использоваться для преобразования координат этого объекта Visual в координаты заданного потомка визуального объекта. (Унаследовано от Visual)
TransformToVisual(Visual)	Возвращает преобразование, которое может использоваться для преобразования координат этого объекта Visual в координаты заданного визуального объекта. (Унаследовано от Visual)
VerifyAccess()	Обеспечивает наличие у вызывающего потока доступ к этому DispatcherObject. (Унаследовано от DispatcherObject)

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