ContainerVisual Classe

Définition

Espace de noms:

Microsoft.UI.Composition

Nœud dans l’arborescence visuelle qui peut avoir des enfants.

[WebHostHidden]
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(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
[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(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
public class ContainerVisual : Visual

Public Class ContainerVisual
Inherits Visual

Héritage

Object Platform::Object IInspectable CompositionObject Visual ContainerVisual

Dérivé

Microsoft.UI.Composition.LayerVisual

Microsoft.UI.Composition.RedirectVisual

Microsoft.UI.Composition.Scenes.SceneVisual

Microsoft.UI.Composition.ShapeVisual

Microsoft.UI.Composition.SpriteVisual

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Exemples

//
// 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);
    }
}

Propriétés

AnchorPoint	Point sur le visuel à positionner au décalage du visuel. La valeur est normalisée en ce qui concerne la taille du visuel. Animatable. (Hérité de Visual)
BackfaceVisibility	Spécifie si la face arrière du visuel doit être visible lors d’une transformation 3D. (Hérité de Visual)
BorderMode	Spécifie comment composer les bords des bitmaps et des clips associés à un visuel, ou à tous les visuels de la sous-arborescence enracinée sur ce visuel. La définition de BorderMode sur un visuel parent affecte tous les visuels enfants de la sous-arborescence et peut être désactivé de manière sélective à chaque visuel enfant. (Hérité de Visual)
CenterPoint	Point sur lequel la rotation ou la mise à l’échelle se produit. Animatable (Hérité de Visual)
Children	Enfants de ContainerVisual.
Clip	Spécifie la zone de découpage du visuel. Lorsqu’un visuel est rendu, seule la partie du visuel qui se trouve à l’intérieur de la zone de découpage est affichée, tandis que tout contenu qui s’étend en dehors de la zone de découpage est rogné (autrement dit, non affiché). (Hérité de Visual)
Comment	Chaîne à associer à CompositionObject. (Hérité de CompositionObject)
CompositeMode	Spécifie la façon dont l’image bitmap d’un visuel est mélangée à l’écran. (Hérité de Visual)
Compositor	Compositor utilisé pour créer cet Objet CompositionObject. (Hérité de CompositionObject)
DispatcherQueue	Obtient le DispatcherQueue pour l’objet CompositionObject. (Hérité de CompositionObject)
ImplicitAnimations	Collection d’animations implicites attachées à cet objet. (Hérité de CompositionObject)
IsHitTestVisible	Obtient ou définit une valeur qui indique si la sous-arborescence visuelle enracinée dans ce visuel participe au test d’accès. (Hérité de Visual)
IsPixelSnappingEnabled	Obtient ou définit une valeur qui indique si le moteur de composition aligne le visuel rendu avec une limite de pixels. (Hérité de Visual)
IsVisible	Indique si le visuel et sa sous-arborescence entière de visuels enfants sont visibles. (Hérité de Visual)
Offset	Décalage du visuel par rapport à son parent ou, pour un visuel racine, décalage par rapport au coin supérieur gauche des fenêtres qui hébergent le visuel. Animatable. (Hérité de Visual)
Opacity	Opacité du visuel. Animatable. La propriété opacité détermine la transparence, le cas échéant, du visuel et est une valeur comprise entre 0 et 1. 0 est entièrement transparent et 1 est entièrement opaque. Un visuel avec une propriété Opacity de 0 est toujours présent dans l’arborescence. Comme d’autres propriétés du visuel, Opacity peut être animée à l’aide de Windows,UI. Système d’animation de composition. (Hérité de Visual)
Orientation	Quaternion décrivant une orientation et une rotation dans l’espace 3D qui seront appliquées au visuel. Animatable. (Hérité de Visual)
Parent	Parent de l’objet visuel. (Hérité de Visual)
ParentForTransform	Visuel spécifiant le système de coordonnées dans lequel ce visuel est composé. (Hérité de Visual)
Properties	Collection de propriétés associées à CompositionObject. (Hérité de CompositionObject)
RelativeOffsetAdjustment	Spécifie le décalage du visuel par rapport à la taille de son visuel parent. (Hérité de Visual)
RelativeSizeAdjustment	Obtient ou définit la taille du visuel par rapport à la taille de son visuel parent. (Hérité de Visual)
RotationAngle	Angle de rotation en radians du visuel. Animatable. (Hérité de Visual)
RotationAngleInDegrees	Angle de rotation du visuel en degrés. Animatable. (Hérité de Visual)
RotationAxis	Axe autour duquel faire pivoter le visuel. Animatable. (Hérité de Visual)
Scale	Échelle à appliquer au visuel. (Hérité de Visual)
Size	Largeur et hauteur du visuel. Animatable. (Hérité de Visual)
TransformMatrix	Matrice de transformation à appliquer au visuel. Animatable. (Hérité de Visual)

Méthodes

Close()	Ferme l’objet CompositionObject et libère les ressources système. (Hérité de CompositionObject)
Dispose()	Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées. (Hérité de CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Définit une propriété qui peut être animée. (Hérité de CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	Connecte une animation à la propriété spécifiée de l’objet et démarre l’animation. (Hérité de CompositionObject)
StartAnimation(String, CompositionAnimation)	Connecte une animation à la propriété spécifiée de l’objet et démarre l’animation. (Hérité de CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	Démarre un groupe d’animations. La méthode StartAnimationGroup sur CompositionObject vous permet de démarrer CompositionAnimationGroup. Toutes les animations du groupe seront démarrées en même temps sur l’objet. (Hérité de CompositionObject)
StopAnimation(String)	Déconnecte une animation de la propriété spécifiée et arrête l’animation. (Hérité de CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	Arrête un groupe d’animations. (Hérité de CompositionObject)
TryGetAnimationController(String)	Renvoie un AnimationController pour l’animation en cours d’exécution sur la propriété spécifiée. (Hérité de CompositionObject)

Voir aussi

• Visual
• IClosable
• Visuel composition sans exemple de framework (Windows 10)