DrawingVisual DrawingVisual DrawingVisual DrawingVisual Class

Определение

DrawingVisual — это визуальный объект, который можно использовать для отрисовки векторной графики на экране.DrawingVisual is a visual object that can be used to render vector graphics on the screen. Содержимое сохраняется системой.The content is persisted by the system.

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
Наследование

Комментарии

DrawingVisual— Это упрощенный класс рисования, используемый для отрисовки фигур, изображений или текста.DrawingVisual is a lightweight drawing class that is used to render shapes, images, or text. Этот класс считается легковесным, поскольку он не предоставляет макет, ввод, фокус или обработку событий, что повышает его производительность.This class is considered lightweight because it does not provide layout, input, focus, or event handling, which improves its performance. Поэтому этот класс идеально подходит для фоновых рисунков или клипов.For this reason, drawings are ideal for backgrounds and clip art.

Чтобы использовать DrawingVisual объекты, необходимо создать контейнер узла для объектов.In order to use DrawingVisual objects, you need to create a host container for the objects. Объект контейнера узла должен быть производным от FrameworkElement класса, который предоставляет поддержку обработки макета и событий DrawingVisual , которую класс не поддерживает.The host container object must be derived from the FrameworkElement class, which provides the layout and event handling support that the DrawingVisual class does not support. Объект контейнера узла не отображает никаких визуальных свойств, так как его основная цель — содержать дочерние объекты.The host container object does not display any visual properties, since its main purpose is to contain child objects. Дополнительные сведения см. в разделе Использование объектов DrawingVisual.For more information, see Using DrawingVisual Objects.

Полный пример, демонстрирующий создание DrawingVisual объектов с помощью контейнера узлов, см. в разделе Проверка попадания с использованием примера DrawingVisuals .For a complete example showing how to create DrawingVisual objects with a host container, see the Hit Test Using DrawingVisuals Sample .

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

DrawingVisual() DrawingVisual() DrawingVisual() DrawingVisual()

Инициализирует новый экземпляр класса DrawingVisual.Initializes a new instance of the DrawingVisual class.

Свойства

BitmapEffect BitmapEffect BitmapEffect BitmapEffect

Получает или задает значение BitmapEffect для ContainerVisual.Gets or sets a BitmapEffect value for the ContainerVisual.

(Inherited from ContainerVisual)
BitmapEffectInput BitmapEffectInput BitmapEffectInput BitmapEffectInput

Получает или задает значение BitmapEffectInput для ContainerVisual.Gets or sets a BitmapEffectInput value for the ContainerVisual.

(Inherited from ContainerVisual)
CacheMode CacheMode CacheMode CacheMode

Получает или задает кэшированное представление объекта ContainerVisual.Gets or sets a cached representation of the ContainerVisual.

(Inherited from ContainerVisual)
Children Children Children Children

Получает дочернюю коллекцию данного ContainerVisual.Gets the child collection of the ContainerVisual.

(Inherited from ContainerVisual)
Clip Clip Clip Clip

Возвращает или устанавливает вырезанную область объекта ContainerVisual.Gets or sets the clipping region of the ContainerVisual.

(Inherited from ContainerVisual)
ContentBounds ContentBounds ContentBounds ContentBounds

Получает ограничивающий объект для содержимого объекта ContainerVisual.Gets the bounding box for the contents of the ContainerVisual.

(Inherited from ContainerVisual)
DependencyObjectType DependencyObjectType DependencyObjectType DependencyObjectType

Возвращает DependencyObjectType, который создает обертку для типа CLRCLR данного экземпляра.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Inherited from DependencyObject)
DescendantBounds DescendantBounds DescendantBounds DescendantBounds

Получает объединение всех ограничивающих прямоугольников содержимого для всех потомков объекта ContainerVisual, но без включения содержимого объекта ContainerVisual.Gets the union of all the content bounding boxes for all of the descendants of the ContainerVisual, but not including the contents of the ContainerVisual.

(Inherited from ContainerVisual)
Dispatcher Dispatcher Dispatcher Dispatcher

Возвращает объект Dispatcher, с которым связан этот объект DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
Drawing Drawing Drawing Drawing

Получает содержимое рисунка объекта DrawingVisual.Gets the drawing content of the DrawingVisual object.

Effect Effect Effect Effect

Получает или задает эффект растрового изображения, который применяется к объекту ContainerVisual.Gets or sets the bitmap effect to apply to the ContainerVisual.

(Inherited from ContainerVisual)
IsSealed IsSealed IsSealed IsSealed

Получает значение, указывающее, является ли этот экземпляр в данный момент запечатанным (доступным только для чтения).Gets a value that indicates whether this instance is currently sealed (read-only).

(Inherited from DependencyObject)
Offset Offset Offset Offset

Получает или задает значение смещения ContainerVisual от его опорной точки.Gets or sets the offset value of the ContainerVisual from its reference point.

(Inherited from ContainerVisual)
Opacity Opacity Opacity Opacity

Получает или задает непрозрачность объекта ContainerVisual исходя из таких значений: 0=прозрачность, 1=непрозрачность.Gets or sets the opacity of the ContainerVisual, based on 0=transparent, 1=opaque.

(Inherited from ContainerVisual)
OpacityMask OpacityMask OpacityMask OpacityMask

Получает или задает кисть, определяющую возможную маску непрозрачности для ContainerVisual.Gets or sets a brush that specifies a possible opacity mask for the ContainerVisual.

(Inherited from ContainerVisual)
Parent Parent Parent Parent

Получает родительский объект Visual для ContainerVisual.Gets the parent Visual for the ContainerVisual.

(Inherited from ContainerVisual)
Transform Transform Transform Transform

Получает или задает преобразование, применяемое к ContainerVisual.Gets or sets the transform that is applied to the ContainerVisual.

(Inherited from ContainerVisual)
VisualBitmapEffect VisualBitmapEffect VisualBitmapEffect VisualBitmapEffect

Получает или задает значение BitmapEffect для объекта Visual.Gets or sets the BitmapEffect value for the Visual.

(Inherited from Visual)
VisualBitmapEffectInput VisualBitmapEffectInput VisualBitmapEffectInput VisualBitmapEffectInput

Получает или задает значение BitmapEffectInput для объекта Visual.Gets or sets the BitmapEffectInput value for the Visual.

(Inherited from Visual)
VisualBitmapScalingMode VisualBitmapScalingMode VisualBitmapScalingMode VisualBitmapScalingMode

Возвращает или задает BitmapScalingMode для объекта Visual.Gets or sets the BitmapScalingMode for the Visual.

(Inherited from Visual)
VisualCacheMode VisualCacheMode VisualCacheMode VisualCacheMode

Получает или задает кэшированное представление объекта Visual.Gets or sets a cached representation of the Visual.

(Inherited from Visual)
VisualChildrenCount VisualChildrenCount VisualChildrenCount VisualChildrenCount

Возвращает количество дочерних элементов для ContainerVisual.Gets the number of children for the ContainerVisual.

(Inherited from ContainerVisual)
VisualClearTypeHint VisualClearTypeHint VisualClearTypeHint VisualClearTypeHint

Получает или задает объект ClearTypeHint, который определяет способ отображения ClearType в Visual.Gets or sets the ClearTypeHint that determines how ClearType is rendered in the Visual.

(Inherited from Visual)
VisualClip VisualClip VisualClip VisualClip

Возвращает или задает отсеченную область объекта Visual в виде значения Geometry.Gets or sets the clip region of the Visual as a Geometry value.

(Inherited from Visual)
VisualEdgeMode VisualEdgeMode VisualEdgeMode VisualEdgeMode

Возвращает или задает края объекта Visual в виде значения EdgeMode.Gets or sets the edge mode of the Visual as an EdgeMode value.

(Inherited from Visual)
VisualEffect VisualEffect VisualEffect VisualEffect

Получает или задает эффект растрового изображения, который применяется к объекту Visual.Gets or sets the bitmap effect to apply to the Visual.

(Inherited from Visual)
VisualOffset VisualOffset VisualOffset VisualOffset

Возвращает или задает значение смещения визуального объекта.Gets or sets the offset value of the visual object.

(Inherited from Visual)
VisualOpacity VisualOpacity VisualOpacity VisualOpacity

Получает или задает значение прозрачности для объекта Visual.Gets or sets the opacity of the Visual.

(Inherited from Visual)
VisualOpacityMask VisualOpacityMask VisualOpacityMask VisualOpacityMask

Возвращает или задает значение Brush, которое представляет маску непрозрачности объекта Visual.Gets or sets the Brush value that represents the opacity mask of the Visual.

(Inherited from Visual)
VisualParent VisualParent VisualParent VisualParent

Получает для визуального объекта родительский объект визуального дерева.Gets the visual tree parent of the visual object.

(Inherited from Visual)
VisualScrollableAreaClip VisualScrollableAreaClip VisualScrollableAreaClip VisualScrollableAreaClip

Получает или задает обрезанную прокручиваемую область для объекта Visual.Gets or sets a clipped scrollable area for the Visual.

(Inherited from Visual)
VisualTextHintingMode VisualTextHintingMode VisualTextHintingMode VisualTextHintingMode

Возвращает или задает TextHintingMode объекта Visual.Gets or sets the TextHintingMode of the Visual.

(Inherited from Visual)
VisualTextRenderingMode VisualTextRenderingMode VisualTextRenderingMode VisualTextRenderingMode

Возвращает или задает TextRenderingMode объекта Visual.Gets or sets the TextRenderingMode of the Visual.

(Inherited from Visual)
VisualTransform VisualTransform VisualTransform VisualTransform

Получает или задает значение Transform для объекта Visual.Gets or sets the Transform value for the Visual.

(Inherited from Visual)
VisualXSnappingGuidelines VisualXSnappingGuidelines VisualXSnappingGuidelines VisualXSnappingGuidelines

Получает или задает коллекцию направляющих по оси X (по вертикали).Gets or sets the x-coordinate (vertical) guideline collection.

(Inherited from Visual)
VisualYSnappingGuidelines VisualYSnappingGuidelines VisualYSnappingGuidelines VisualYSnappingGuidelines

Получает или задает коллекцию горизонтальных направляющих (по оси Y).Gets or sets the y-coordinate (horizontal) guideline collection.

(Inherited from Visual)
XSnappingGuidelines XSnappingGuidelines XSnappingGuidelines XSnappingGuidelines

Получает или задает направляющую по оси X (горизонтальную) для ContainerVisual.Gets or sets the X (horizontal) guideline for the ContainerVisual.

(Inherited from ContainerVisual)
YSnappingGuidelines YSnappingGuidelines YSnappingGuidelines YSnappingGuidelines

Получает или задает направляющую по оси Y (вертикальную) для ContainerVisual.Gets or sets the Y (vertical) guideline for the ContainerVisual.

(Inherited from ContainerVisual)

Методы

AddVisualChild(Visual) AddVisualChild(Visual) AddVisualChild(Visual) AddVisualChild(Visual)

Определяет связь "родитель-потомок" между двумя визуальными объектами.Defines the parent-child relationship between two visuals.

(Inherited from Visual)
CheckAccess() CheckAccess() CheckAccess() CheckAccess()

Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty)

Очищает локальное значение свойства.Clears the local value of a property. Очищаемое свойство задается идентификатором DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Inherited from DependencyObject)
ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey)

Очищает локальное значение свойства, доступного только для чтения.Clears the local value of a read-only property. Очищаемое свойство задается объектом DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Inherited from DependencyObject)
CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty)

Приводит значение указанного свойства зависимостей.Coerces the value of the specified dependency property. Это осуществляется путем вызова какой-либо функции CoerceValueCallback, указанной в метаданных свойства зависимостей, которое существует в вызывающем объекте DependencyObject.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Inherited from DependencyObject)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, является ли указанный DependencyObject эквивалентом текущего DependencyObject.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Inherited from DependencyObject)
FindCommonVisualAncestor(DependencyObject) FindCommonVisualAncestor(DependencyObject) FindCommonVisualAncestor(DependencyObject) FindCommonVisualAncestor(DependencyObject)

Возвращает общего предка двух визуальных объектов.Returns the common ancestor of two visual objects.

(Inherited from Visual)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Получает хэш-код для данного объекта DependencyObject.Gets a hash code for this DependencyObject.

(Inherited from DependencyObject)
GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator()

Создает специализированный перечислитель для определения свойств зависимостей, которые локально установили значения для данного DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Inherited from DependencyObject)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty)

Возвращает текущее действующее значение свойства зависимостей в этом экземпляре DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Inherited from DependencyObject)
GetVisualChild(Int32) GetVisualChild(Int32) GetVisualChild(Int32) GetVisualChild(Int32)

Возвращает указанный дочерний объект Visual родительского ContainerVisual.Returns a specified child Visual for the parent ContainerVisual.

(Inherited from ContainerVisual)
HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters) HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters) HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters) HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Инициирует проверку нажатия для ContainerVisual с использованием объектов HitTestFilterCallback и HitTestResultCallback.Initiates a hit test on the ContainerVisual by using the HitTestFilterCallback and HitTestResultCallback objects.

(Inherited from ContainerVisual)
HitTest(Point) HitTest(Point) HitTest(Point) HitTest(Point)

Возвращает самый верхний визуальный объект для проверки нажатия, указывая тип Point.Returns the top-most visual object of a hit test by specifying a Point.

(Inherited from ContainerVisual)
HitTestCore(GeometryHitTestParameters) HitTestCore(GeometryHitTestParameters) HitTestCore(GeometryHitTestParameters) HitTestCore(GeometryHitTestParameters)

Определяет, находится ли значение, соответствующее геометрии, в пределах границ визуального объекта.Determines whether a geometry value is within the bounds of the visual object.

HitTestCore(PointHitTestParameters) HitTestCore(PointHitTestParameters) HitTestCore(PointHitTestParameters) HitTestCore(PointHitTestParameters)

Определяет, находится ли значение, соответствующее координате точки, в пределах границ объекта DrawingVisual.Determines whether a point coordinate value is within the bounds of the DrawingVisual object.

InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty)

Повторно вычисляет действующее значение для указанного свойства зависимостейRe-evaluates the effective value for the specified dependency property

(Inherited from DependencyObject)
IsAncestorOf(DependencyObject) IsAncestorOf(DependencyObject) IsAncestorOf(DependencyObject) IsAncestorOf(DependencyObject)

Определяет, является ли визуальный объект предком потомка визуального объекта.Determines whether the visual object is an ancestor of the descendant visual object.

(Inherited from Visual)
IsDescendantOf(DependencyObject) IsDescendantOf(DependencyObject) IsDescendantOf(DependencyObject) IsDescendantOf(DependencyObject)

Определяет, является ли визуальный объект потомком для предка визуального объекта.Determines whether the visual object is a descendant of the ancestor visual object.

(Inherited from Visual)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
OnDpiChanged(DpiScale, DpiScale) OnDpiChanged(DpiScale, DpiScale) OnDpiChanged(DpiScale, DpiScale) OnDpiChanged(DpiScale, DpiScale)

Вызывается, когда изменяется параметр "точек на дюйм", по которому определяется разрешение представления.Called when the DPI at which this View is rendered changes.

(Inherited from Visual)
OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs)

Вызывается каждый раз, когда обновляется действительное значение любого свойства зависимостей для данного DependencyObject.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Конкретное свойство зависимости, которое изменилось, сообщается в данных события.The specific dependency property that changed is reported in the event data.

(Inherited from DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject) OnVisualChildrenChanged(DependencyObject, DependencyObject) OnVisualChildrenChanged(DependencyObject, DependencyObject) OnVisualChildrenChanged(DependencyObject, DependencyObject)

Вызывается при изменении коллекции VisualCollection визуального объекта.Called when the VisualCollection of the visual object is modified.

(Inherited from Visual)
OnVisualParentChanged(DependencyObject) OnVisualParentChanged(DependencyObject) OnVisualParentChanged(DependencyObject) OnVisualParentChanged(DependencyObject)

Вызывается при изменении родительского объекта визуального объекта.Called when the parent of the visual object is changed.

(Inherited from Visual)
PointFromScreen(Point) PointFromScreen(Point) PointFromScreen(Point) PointFromScreen(Point)

Преобразовывает объект Point в экранных координатах в объект Point, представляющий текущую систему координат Visual.Converts a Point in screen coordinates into a Point that represents the current coordinate system of the Visual.

(Inherited from Visual)
PointToScreen(Point) PointToScreen(Point) PointToScreen(Point) PointToScreen(Point)

Преобразовывает объект Point, представляющий текущую систему координат объекта Visual, в объект Point в экранных координатах.Converts a Point that represents the current coordinate system of the Visual into a Point in screen coordinates.

(Inherited from Visual)
ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty)

Возвращает локальное значение свойства зависимостей, если таковое существует.Returns the local value of a dependency property, if it exists.

(Inherited from DependencyObject)
RemoveVisualChild(Visual) RemoveVisualChild(Visual) RemoveVisualChild(Visual) RemoveVisualChild(Visual)

Удаляет связь "родитель-потомок" между двумя визуальными объектами.Removes the parent-child relationship between two visuals.

(Inherited from Visual)
RenderOpen() RenderOpen() RenderOpen() RenderOpen()

Открывает объект DrawingVisual для отрисовки.Opens the DrawingVisual object for rendering. Возвращенное значение DrawingContext можно использовать для отрисовки в объекте DrawingVisual.The returned DrawingContext value can be used to render into the DrawingVisual.

SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object)

Задает значение свойства зависимостей, не меняя источник значения.Sets the value of a dependency property without changing its value source.

(Inherited from DependencyObject)
SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object)

Задает локальное значение свойства зависимостей, указанного идентификатором этого свойства.Sets the local value of a dependency property, specified by its dependency property identifier.

(Inherited from DependencyObject)
SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object)

Задает локальное значение свойства зависимости только для чтения, определяемое идентификатором DependencyPropertyKey свойства зависимостей.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Inherited from DependencyObject)
ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty)

Возвращает значение, которое указывает, следует ли процессам сериализации выполнять сериализацию значения для предоставленного свойства зависимостей.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Inherited from DependencyObject)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)
TransformToAncestor(Visual) TransformToAncestor(Visual) TransformToAncestor(Visual) TransformToAncestor(Visual)

Возвращает преобразование, которое может использоваться для преобразования координат этого объекта Visual в координаты заданного предка визуального объекта Visual.Returns a transform that can be used to transform coordinates from the Visual to the specified Visual ancestor of the visual object.

(Inherited from Visual)
TransformToAncestor(Visual3D) TransformToAncestor(Visual3D) TransformToAncestor(Visual3D) TransformToAncestor(Visual3D)

Возвращает преобразование, которое может использоваться для преобразования координат этого объекта Visual в координаты заданного предка визуального объекта Visual3D.Returns a transform that can be used to transform coordinates from the Visual to the specified Visual3D ancestor of the visual object.

(Inherited from Visual)
TransformToDescendant(Visual) TransformToDescendant(Visual) TransformToDescendant(Visual) TransformToDescendant(Visual)

Возвращает преобразование, которое может использоваться для преобразования координат этого объекта Visual в координаты заданного потомка визуального объекта.Returns a transform that can be used to transform coordinates from the Visual to the specified visual object descendant.

(Inherited from Visual)
TransformToVisual(Visual) TransformToVisual(Visual) TransformToVisual(Visual) TransformToVisual(Visual)

Возвращает преобразование, которое может использоваться для преобразования координат этого объекта Visual в координаты заданного визуального объекта.Returns a transform that can be used to transform coordinates from the Visual to the specified visual object.

(Inherited from Visual)
VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

Обеспечивает наличие у вызывающего потока доступ к этому DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

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