ContainerVisual Класс

Определение

Управляет коллекцией объектов Visual.Manages a collection of Visual objects.

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 объектов.The following example shows how to create a ContainerVisual object that is used as the parent for two DrawingVisual objects. Объекты, добавляемые в ContainerVisual объект, должны быть добавлены в обратном z-порядке (снизу вверх), чтобы обеспечить их отрисовку в правильном порядке отображения.Objects that are added to the ContainerVisual object must be added in reverse z-order (bottom to top) to ensure they are rendering in the correct drawing order. Чтобы правильно перечислить визуальное дерево, пример предоставляет переопределенные реализации GetVisualChild метода и VisualChildrenCount свойства.In order for the visual tree to be enumerated correctly, the example provides overridden implementations of the GetVisualChild method and VisualChildrenCount property.

// 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.The ContainerVisual class is used as a container for a collection of Visual objects. Класс является производным ContainerVisual от DrawingVisual класса, так что класс может также содержать коллекцию визуальных объектов. DrawingVisualThe DrawingVisual class derives from the ContainerVisual class, such that the DrawingVisual class can also contain a collection of visual objects.

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

ContainerVisual()

Создает новый экземпляр класса ContainerVisual.Creates a new instance of the ContainerVisual class.

Свойства

BitmapEffect

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

BitmapEffectInput

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

CacheMode

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

Children

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

Clip

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

ContentBounds

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

DependencyObjectType

Возвращает DependencyObjectType, который создает обертку для типа CLRCLR данного экземпляра.Gets the DependencyObjectType that wraps the CLRCLR 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.

Dispatcher

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

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

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

Opacity

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

OpacityMask

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

Parent

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

Transform

Получает или задает преобразование, применяемое к ContainerVisual.Gets or sets the transform that is applied to the 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.

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.

YSnappingGuidelines

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

HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

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

HitTest(Point)

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

HitTestCore(GeometryHitTestParameters)

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

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

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

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

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