ContainerVisual Класс

Определение

Пространство имен:

System.Windows.Media

Сборка:

PresentationCore.dll

Управляет коллекцией объектов Visual.

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

public class ContainerVisual : System.Windows.Media.Visual

type ContainerVisual = class
    inherit Visual

Public Class ContainerVisual
Inherits Visual

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

Object

DispatcherObject

DependencyObject

Visual

ContainerVisual

Производный

System.Windows.Media.DrawingVisual

System.Windows.Media.HostVisual

Примеры

В следующем примере показано, ContainerVisual как создать объект , который используется в качестве родительского объекта для двух DrawingVisual объектов. Объекты, добавленные в ContainerVisual объект , должны быть добавлены в обратном порядке z (снизу вверх), чтобы обеспечить отрисовку в правильном порядке рисования. Для правильного перечисления визуального дерева в примере приводятся переопределенные реализации GetVisualChild метода и VisualChildrenCount свойства .

// Create a host visual derived from the FrameworkElement class.
// This class provides layout, event handling, and container support for
// the child visual objects.
public class MyContainerVisualHost : FrameworkElement
{
    private ContainerVisual _containerVisual;

    public MyContainerVisualHost(DrawingVisual border, DrawingVisual text)
    {
        // Create a ContainerVisual to hold DrawingVisual children.
        _containerVisual = new ContainerVisual();

        // Add children to ContainerVisual in reverse z-order (bottom to top).
        _containerVisual.Children.Add(border);
        _containerVisual.Children.Add(text);

        // Create parent-child relationship with host visual and ContainerVisual.
        this.AddVisualChild(_containerVisual);
    }

    // Provide a required override for the VisualChildrenCount property.
    protected override int VisualChildrenCount
    {
        get { return _containerVisual == null ? 0 : 1; }
    }

    // Provide a required override for the GetVisualChild method.
    protected override Visual GetVisualChild(int index)
    {
        if (_containerVisual == null)
        {
            throw new ArgumentOutOfRangeException();
        }

        return _containerVisual;
    }
}

' Create a host visual derived from the FrameworkElement class.
' This class provides layout, event handling, and container support for
' the child visual objects.
Public Class MyContainerVisualHost
    Inherits FrameworkElement
    Private _containerVisual As ContainerVisual

    Public Sub New(ByVal border As DrawingVisual, ByVal text As DrawingVisual)
        ' Create a ContainerVisual to hold DrawingVisual children.
        _containerVisual = New ContainerVisual()

        ' Add children to ContainerVisual in reverse z-order (bottom to top).
        _containerVisual.Children.Add(border)
        _containerVisual.Children.Add(text)

        ' Create parent-child relationship with host visual and ContainerVisual.
        Me.AddVisualChild(_containerVisual)
    End Sub

    ' Provide a required override for the VisualChildrenCount property.
    Protected Overrides ReadOnly Property VisualChildrenCount() As Integer
        Get
            Return If(_containerVisual Is Nothing, 0, 1)
        End Get
    End Property

    ' Provide a required override for the GetVisualChild method.
    Protected Overrides Function GetVisualChild(ByVal index As Integer) As Visual
        If _containerVisual Is Nothing Then
            Throw New ArgumentOutOfRangeException()
        End If

        Return _containerVisual
    End Function
End Class

Комментарии

Класс ContainerVisual используется в качестве контейнера для коллекции объектов Visual. Класс DrawingVisual является производным ContainerVisual от класса , поэтому DrawingVisual класс может также содержать коллекцию визуальных объектов.

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

ContainerVisual()

Создает новый экземпляр класса ContainerVisual.

Свойства

BitmapEffect	Устаревшие.. Получает или задает значение BitmapEffect для ContainerVisual.
BitmapEffectInput	Устаревшие.. Получает или задает значение BitmapEffectInput для ContainerVisual.
CacheMode	Получает или задает кэшированное представление объекта ContainerVisual.
Children	Получает дочернюю коллекцию данного ContainerVisual.
Clip	Возвращает или устанавливает вырезанную область объекта ContainerVisual.
ContentBounds	Получает ограничивающий объект для содержимого объекта ContainerVisual.
DependencyObjectType	Возвращает объект , DependencyObjectType который заключает в оболочку тип СРЕДЫ CLR данного экземпляра. (Унаследовано от DependencyObject)
DescendantBounds	Получает объединение всех ограничивающих прямоугольников содержимого для всех потомков объекта ContainerVisual, но без включения содержимого объекта ContainerVisual.
Dispatcher	Возвращает объект Dispatcher, с которым связан этот объект DispatcherObject. (Унаследовано от DispatcherObject)
Effect	Получает или задает эффект растрового изображения, который применяется к объекту ContainerVisual.
IsSealed	Получает значение, указывающее, является ли этот экземпляр в данный момент запечатанным (доступным только для чтения). (Унаследовано от DependencyObject)
Offset	Получает или задает значение смещения ContainerVisual от его опорной точки.
Opacity	Получает или задает непрозрачность объекта ContainerVisual исходя из таких значений: 0=прозрачность, 1=непрозрачность.
OpacityMask	Получает или задает кисть, определяющую возможную маску непрозрачности для ContainerVisual.
Parent	Получает родительский объект Visual для ContainerVisual.
Transform	Получает или задает преобразование, применяемое к ContainerVisual.
VisualBitmapEffect	Устаревшие.. Получает или задает значение BitmapEffect для объекта Visual. (Унаследовано от Visual)
VisualBitmapEffectInput	Устаревшие.. Получает или задает значение BitmapEffectInput для объекта Visual. (Унаследовано от Visual)
VisualBitmapScalingMode	Возвращает или задает BitmapScalingMode для объекта Visual. (Унаследовано от Visual)
VisualCacheMode	Получает или задает кэшированное представление объекта Visual. (Унаследовано от Visual)
VisualChildrenCount	Возвращает количество дочерних элементов для 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.
YSnappingGuidelines	Получает или задает направляющую по оси Y (вертикальную) для 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.
HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)	Инициирует проверку нажатия для ContainerVisual с использованием объектов HitTestFilterCallback и HitTestResultCallback.
HitTest(Point)	Возвращает самый верхний визуальный объект для проверки нажатия, указывая тип Point.
HitTestCore(GeometryHitTestParameters)	Определяет, находится ли значение, соответствующее геометрии, в пределах границ визуального объекта. (Унаследовано от Visual)
HitTestCore(PointHitTestParameters)	Определяет, находится ли значение, соответствующее координате точки, в пределах границ визуального объекта. (Унаследовано от Visual)
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)
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)