ContainerVisual Класс

Определение

Управляет коллекцией объектов 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
Наследование
Производный

Примеры

В следующем примере показано, как создать 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)

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