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)	Вызывается при изменении DPI, в котором отображается это представление. (Унаследовано от 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)

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

Обратная связь

Были ли сведения на этой странице полезными?