DrawingVisual Класс

Определение

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.Initializes a new instance of the DrawingVisual class.

Свойства

BitmapEffect
Является устаревшей.
Является устаревшей.

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

(Унаследовано от ContainerVisual)
BitmapEffectInput
Является устаревшей.
Является устаревшей.

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

(Унаследовано от ContainerVisual)
CacheMode

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

(Унаследовано от ContainerVisual)
Children

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

(Унаследовано от ContainerVisual)
Clip

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

(Унаследовано от ContainerVisual)
ContentBounds

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

(Унаследовано от ContainerVisual)
DependencyObjectType

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

(Унаследовано от DependencyObject)
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.

(Унаследовано от ContainerVisual)
Dispatcher

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

(Унаследовано от DispatcherObject)
Drawing

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

Effect

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

(Унаследовано от ContainerVisual)
IsSealed

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

(Унаследовано от DependencyObject)
Offset

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

(Унаследовано от ContainerVisual)
Opacity

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

(Унаследовано от ContainerVisual)
OpacityMask

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

(Унаследовано от ContainerVisual)
Parent

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

(Унаследовано от ContainerVisual)
Transform

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

(Унаследовано от ContainerVisual)
VisualBitmapEffect
Является устаревшей.
Является устаревшей.

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

(Унаследовано от Visual)
VisualBitmapEffectInput
Является устаревшей.
Является устаревшей.

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

(Унаследовано от Visual)
VisualBitmapScalingMode

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

(Унаследовано от Visual)
VisualCacheMode

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

(Унаследовано от Visual)
VisualChildrenCount

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

(Унаследовано от ContainerVisual)
VisualClearTypeHint

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

(Унаследовано от Visual)
VisualClip

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

(Унаследовано от Visual)
VisualEdgeMode

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

(Унаследовано от Visual)
VisualEffect

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

(Унаследовано от Visual)
VisualOffset

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

(Унаследовано от Visual)
VisualOpacity

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

(Унаследовано от Visual)
VisualOpacityMask

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

(Унаследовано от Visual)
VisualParent

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

(Унаследовано от Visual)
VisualScrollableAreaClip

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

(Унаследовано от Visual)
VisualTextHintingMode

Получает или задает TextHintingMode объекта Visual.Gets or sets the TextHintingMode of the Visual.

(Унаследовано от Visual)
VisualTextRenderingMode

Получает или задает TextRenderingMode объекта Visual.Gets or sets the TextRenderingMode of the Visual.

(Унаследовано от Visual)
VisualTransform

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

(Унаследовано от Visual)
VisualXSnappingGuidelines

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

(Унаследовано от Visual)
VisualYSnappingGuidelines

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

(Унаследовано от Visual)
XSnappingGuidelines

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

(Унаследовано от ContainerVisual)
YSnappingGuidelines

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

(Унаследовано от ContainerVisual)

Методы

AddVisualChild(Visual)

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

(Унаследовано от Visual)
CheckAccess()

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

(Унаследовано от DispatcherObject)
ClearValue(DependencyProperty)

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

(Унаследовано от DependencyObject)
ClearValue(DependencyPropertyKey)

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

(Унаследовано от DependencyObject)
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.

(Унаследовано от DependencyObject)
Equals(Object)

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

(Унаследовано от DependencyObject)
FindCommonVisualAncestor(DependencyObject)

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

(Унаследовано от Visual)
GetHashCode()

Возвращает хэш-код для данного объекта DependencyObject.Gets a hash code for this DependencyObject.

(Унаследовано от DependencyObject)
GetLocalValueEnumerator()

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

(Унаследовано от DependencyObject)
GetType()

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

(Унаследовано от Object)
GetValue(DependencyProperty)

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

(Унаследовано от DependencyObject)
GetVisualChild(Int32)

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

(Унаследовано от ContainerVisual)
HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

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

(Унаследовано от ContainerVisual)
HitTest(Point)

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

(Унаследовано от ContainerVisual)
HitTestCore(GeometryHitTestParameters)

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

HitTestCore(PointHitTestParameters)

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

InvalidateProperty(DependencyProperty)

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

(Унаследовано от DependencyObject)
IsAncestorOf(DependencyObject)

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

(Унаследовано от Visual)
IsDescendantOf(DependencyObject)

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

(Унаследовано от Visual)
MemberwiseClone()

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

(Унаследовано от Object)
OnDpiChanged(DpiScale, DpiScale)

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

(Унаследовано от Visual)
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.

(Унаследовано от DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)

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

(Унаследовано от Visual)
OnVisualParentChanged(DependencyObject)

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

(Унаследовано от Visual)
PointFromScreen(Point)

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

(Унаследовано от Visual)
PointToScreen(Point)

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

(Унаследовано от Visual)
ReadLocalValue(DependencyProperty)

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

(Унаследовано от DependencyObject)
RemoveVisualChild(Visual)

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

(Унаследовано от Visual)
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)

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

(Унаследовано от DependencyObject)
SetValue(DependencyProperty, Object)

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

(Унаследовано от DependencyObject)
SetValue(DependencyPropertyKey, Object)

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

(Унаследовано от DependencyObject)
ShouldSerializeProperty(DependencyProperty)

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

(Унаследовано от DependencyObject)
ToString()

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

(Унаследовано от Object)
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.

(Унаследовано от Visual)
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.

(Унаследовано от Visual)
TransformToDescendant(Visual)

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

(Унаследовано от Visual)
TransformToVisual(Visual)

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

(Унаследовано от Visual)
VerifyAccess()

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

(Унаследовано от DispatcherObject)

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