DrawingVisual Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
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
- Наследование
Комментарии
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 |
Возвращает или задает пограничный режим VisualEdgeMode значения. (Унаследовано от 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) |
Вызывается при изменении DPI, в котором отображается это представление. (Унаследовано от Visual) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Вызывается при каждом обновлении эффективного значения любого свойства DependencyObject зависимостей. Определенное свойство зависимостей, которое изменилось, сообщается в данных события. (Унаследовано от DependencyObject) |
| OnVisualChildrenChanged(DependencyObject, DependencyObject) |
Вызывается при VisualCollection изменении визуального объекта. (Унаследовано от Visual) |
| OnVisualParentChanged(DependencyObject) |
Вызывается при изменении родительского элемента визуального объекта. (Унаследовано от Visual) |
| PointFromScreen(Point) |
Преобразует Point координаты Point экрана в объект, представляющий текущую систему координат.Visual (Унаследовано от Visual) |
| PointToScreen(Point) |
Point Преобразует объект, представляющий текущую систему VisualPoint координат в координаты экрана. (Унаследовано от 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) |