ContainerVisual Класс

Определение

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

Windows.UI.Composition

Узел в визуальном дереве, который может иметь дочерние элементы.

public ref class ContainerVisual : Visual

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
class ContainerVisual : Visual

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
public class ContainerVisual : Visual

Public Class ContainerVisual
Inherits Visual

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

Object Platform::Object IInspectable CompositionObject Visual ContainerVisual

Производный

Windows.UI.Composition.EffectVisual

Windows.UI.Composition.ImageVisual

Windows.UI.Composition.LayerVisual

Windows.UI.Composition.RedirectVisual

Windows.UI.Composition.Scenes.SceneVisual

Windows.UI.Composition.ShapeVisual

Windows.UI.Composition.SolidColorVisual

Windows.UI.Composition.SpriteVisual

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

//
// Set up Windows.UI.Composition Compositor, root ContainerVisual, and associate with
// the CoreWindow.
//

_compositor = new Compositor();

_root = _compositor.CreateContainerVisual();
_view.CompositionRootVisual = _root;

//
// Create a simple scene.
//

var child = _compositor.CreateSpriteVisual();
child.Brush = _compositor.CreateColorBrush(Color.FromArgb(0xFF, 0x00, 0xCC, 0x00));
child.Offset = new Vector2(50.0f, 50.0f);
child.Size = new Vector2(200, 200);

_root.Children.InsertAtTop(child);

// App.cpp
struct SampleApp : implements<SampleApp, IFrameworkViewSource, IFrameworkView>
{
    ...
    void SetWindow(CoreWindow const& /* window */)
    {
        // Set up Composition.
        m_compositor = Compositor{};
        m_target = m_compositor.CreateTargetForCurrentView();
        m_root = m_compositor.CreateContainerVisual();
        m_target.Root(m_root);

        // Create a simple scene.
        auto child{ m_compositor.CreateSpriteVisual() };
        child.Brush(m_compositor.CreateColorBrush(ColorHelper::FromArgb(0xFF, 0x00, 0xCC, 0x00)));
        child.Offset({ 50.f, 50.f, 0.f });
        child.Size({ 200.f, 200.f });

        m_root.Children().InsertAtTop(child);
    }

private:
    Compositor m_compositor{ nullptr };
    CompositionTarget m_target{ nullptr };
    ContainerVisual m_root{nullptr};
};

ref class MyClass
{
    Compositor ^ _compositor;
    CompositionTarget ^ _target;
    ContainerVisual ^ _root;

    void Initialize()
    {
        //
        // Set up Composition.
        //

        _compositor = ref new Compositor();
        _target = _compositor->CreateTargetForCurrentView();
        _root = _compositor->CreateContainerVisual();
        _target->Root = _root;

        //
        // Create a simple scene.
        //

        auto child = _compositor->CreateSpriteVisual();
        child->Brush = _compositor.CreateColorBrush(ColorHelper::FromArgb(0xFF, 0x00, 0xCC, 0x00));
        child->Offset = float2(50.0f, 50.0f);
        child->Size = float2(200, 200);

        _root->Children->InsertAtTop(child);
    }
}

Свойства

AnchorPoint	Точка на визуальном элементе, позиционируется по смещению визуального элемента. Значение нормализуется относительно размера визуального элемента. Анимация. (Унаследовано от Visual)
BackfaceVisibility	Указывает, должна ли отображаться задняя часть визуального элемента во время трехмерного преобразования. (Унаследовано от Visual)
BorderMode	Указывает способ создания краев растровых изображений и клипов, связанных с визуальным элементом или со всеми визуальными элементами в поддереве, корнями которых является этот визуальный элемент. Установка BorderMode в родительском визуальном элементе повлияет на все дочерние визуальные элементы в поддереве и может быть выборочно отключена в каждом дочернем визуальном элементе. (Унаследовано от Visual)
CenterPoint	Точка, относительно которой происходит поворот или масштабирование. Анимация (Унаследовано от Visual)
Children	Дочерние элементы Объекта ContainerVisual.
Clip	Указывает область обрезки для визуального элемента. При отрисовки визуального элемента отображается только часть визуального элемента, которая находится в области обрезки, а все содержимое, которое выходит за пределы области обрезки, обрезается (то есть не отображается). (Унаследовано от Visual)
Comment	Строка, связанная с CompositionObject. (Унаследовано от CompositionObject)
CompositeMode	Указывает, как точечный рисунок визуального элемента смешивается с экраном. (Унаследовано от Visual)
Compositor	Compositor, используемый для создания объекта CompositionObject. (Унаследовано от CompositionObject)
Dispatcher	Диспетчер для CompositionObject. (Унаследовано от CompositionObject)
DispatcherQueue	Возвращает dispatcherQueue для Объекта CompostionObject. (Унаследовано от CompositionObject)
ImplicitAnimations	Коллекция неявных анимаций, присоединенных к этому объекту. (Унаследовано от CompositionObject)
IsHitTestVisible	Возвращает или задает значение, указывающее, участвует ли вложенное дерево визуального элемента, укорененная в этом визуальном элементе, в проверке попадания. (Унаследовано от Visual)
IsPixelSnappingEnabled	Возвращает или задает значение, указывающее, выравнивает ли обработчик композиции отображаемый визуальный элемент с границой пикселя. (Унаследовано от Visual)
IsVisible	Указывает, видим ли визуальный элемент и все его поддеревье дочерних визуальных элементов. (Унаследовано от Visual)
Offset	Смещение визуального элемента относительно его родительского элемента или для корневого визуального элемента относительно верхнего левого угла окна, в котором размещен визуальный элемент. Анимация. (Унаследовано от Visual)
Opacity	Непрозрачность визуального элемента. Анимация. Свойство opacity определяет прозрачность (если таковой имеется) визуального элемента и является значением в диапазоне от 0 до 1. 0 является полностью прозрачным, а 1 — полностью непрозрачным. Визуальный элемент со свойством Opacity, равном 0, по-прежнему присутствует в дереве. Как и другие свойства визуального элемента, Opacity можно анимировать с помощью пользовательского интерфейса Windows. Система анимации композиции. (Унаследовано от Visual)
Orientation	Кватернион, описывающий ориентацию и поворот в трехмерном пространстве, которые будут применены к визуальному элементу. Анимация. (Унаследовано от Visual)
Parent	Родительский объект визуального объекта. (Унаследовано от Visual)
ParentForTransform	Визуальный элемент, указывающий систему координат, в которую состоит этот визуальный элемент. (Унаследовано от Visual)
Properties	Коллекция свойств, связанных с CompositionObject. (Унаследовано от CompositionObject)
RelativeOffsetAdjustment	Указывает смещение визуального элемента относительно размера его родительского визуального элемента. (Унаследовано от Visual)
RelativeSizeAdjustment	Возвращает или задает размер визуального элемента относительно размера родительского визуального элемента. (Унаследовано от Visual)
RotationAngle	Угол поворота в радианах визуального элемента. Анимация. (Унаследовано от Visual)
RotationAngleInDegrees	Угол поворота визуального элемента в градусах. Анимация. (Унаследовано от Visual)
RotationAxis	Ось для поворота визуального элемента. Анимация. (Унаследовано от Visual)
Scale	Масштаб, применяемый к визуальному элементу. (Унаследовано от Visual)
Size	Ширина и высота визуального элемента. Анимация. (Унаследовано от Visual)
TransformMatrix	Матрица преобразования, применяемая к визуальному элементу. Анимация. (Унаследовано от Visual)

Методы

Close()	Закрывает CompositionObject и освобождает системные ресурсы. (Унаследовано от CompositionObject)
ConnectAnimation(String, CompositionAnimation)	Подключается и анимация. (Унаследовано от CompositionObject)
DisconnectAnimation(String)	Отключает анимацию. (Унаследовано от CompositionObject)
Dispose()	Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов. (Унаследовано от CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Определяет свойство, которое можно анимировать. (Унаследовано от CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	Соединяет анимацию с указанным свойством объекта и запускает анимацию. (Унаследовано от CompositionObject)
StartAnimation(String, CompositionAnimation)	Соединяет анимацию с указанным свойством объекта и запускает анимацию. (Унаследовано от CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	Запускает группу анимации. Метод StartAnimationGroup в CompositionObject позволяет запустить CompositionAnimationGroup. Все анимации в группе будут запущены одновременно с объектом . (Унаследовано от CompositionObject)
StopAnimation(String)	Отключает анимацию от указанного свойства и останавливает анимацию. (Унаследовано от CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	Останавливает группу анимации. (Унаследовано от CompositionObject)
TryGetAnimationController(String)	Возвращает AnimationController для анимации, выполняемой в указанном свойстве. (Унаследовано от CompositionObject)

См. также раздел

• Visual
• IClosable
• Пример визуального элемента композиции без платформы (Windows 10)