ContainerVisual Класс

Определение

Пространство имен:: Microsoft.UI.Composition

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Изменить

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

[WebHostHidden]
public ref class ContainerVisual : Visual

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.LiftedContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[WebHostHidden]
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(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
[WebHostHidden]
class ContainerVisual : Visual

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.LiftedContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public 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(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
public class ContainerVisual : Visual

Public Class ContainerVisual
Inherits Visual

Наследование: Object Platform::Object IInspectable CompositionObject Visual ContainerVisual

Производный: Microsoft.UI.Composition.LayerVisual

Microsoft.UI.Composition.RedirectVisual

Microsoft.UI.Composition.Scenes.SceneVisual

Microsoft.UI.Composition.ShapeVisual

Microsoft.UI.Composition.SpriteVisual

Атрибуты: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Примеры

// RootGrid is a XAML Grid element.
Compositor compositor = ElementCompositionPreview.GetElementVisual(RootGrid).Compositor;

ContainerVisual root = compositor.CreateContainerVisual();

SpriteVisual 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};
};

Свойства

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

Методы

Имя	Описание
Close()	Закрывает ресурсы системы CompositionObject и освобождает системные ресурсы. (Унаследовано от 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)

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

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

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

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