ContainerVisual Classe

Definizione

Spazio dei nomi:

Windows.UI.Composition

Nodo nella struttura ad albero visuale che può avere elementi figlio.

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

Ereditarietà

Object Platform::Object IInspectable CompositionObject Visual ContainerVisual

Derivato

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

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

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

Proprietà

AnchorPoint	Punto dell'oggetto visivo da posizionare in corrispondenza dell'offset dell'oggetto visivo. Il valore viene normalizzato rispetto alle dimensioni dell'oggetto visivo. Animatable. (Ereditato da Visual)
BackfaceVisibility	Specifica se la faccia posteriore dell'oggetto visivo deve essere visibile durante una trasformazione 3D. (Ereditato da Visual)
BorderMode	Specifica come comporre i bordi di bitmap e clip associati a un oggetto visivo o a tutti gli oggetti visivi nel sottoalbero rooted in questo oggetto visivo. L'impostazione di BorderMode in un oggetto visivo padre influirà su tutti gli oggetti visivi figlio nel sottoalbero e può essere disattivata in modo selettivo in ogni oggetto visivo figlio. (Ereditato da Visual)
CenterPoint	Punto su quale rotazione o ridimensionamento si verifica. Animatable (Ereditato da Visual)
Children	Elementi figlio di ContainerVisual.
Clip	Specifica l'area di ritaglio per l'oggetto visivo. Quando viene eseguito il rendering di un oggetto visivo, viene visualizzata solo la parte dell'oggetto visivo che rientra nell'area di ritaglio, mentre qualsiasi contenuto che si estende all'esterno dell'area di ritaglio viene ritagliato (ovvero non visualizzato). (Ereditato da Visual)
Comment	Stringa da associare a CompositionObject. (Ereditato da CompositionObject)
CompositeMode	Specifica la modalità di fusione della bitmap di un oggetto visivo con lo schermo. (Ereditato da Visual)
Compositor	Compositor utilizzato per creare questo CompositionObject. (Ereditato da CompositionObject)
Dispatcher	Dispatcher per CompositionObject. (Ereditato da CompositionObject)
DispatcherQueue	Ottiene dispatcherQueue per CompostionObject. (Ereditato da CompositionObject)
ImplicitAnimations	Raccolta di animazioni implicite associate a questo oggetto. (Ereditato da CompositionObject)
IsHitTestVisible	Ottiene o imposta un valore che indica se la radice dell'albero secondario visivo in questo oggetto visivo partecipa al hit testing. (Ereditato da Visual)
IsPixelSnappingEnabled	Ottiene o imposta un valore che indica se il motore di composizione allinea l'oggetto visivo sottoposto a rendering con un limite di pixel. (Ereditato da Visual)
IsVisible	Indica se l'oggetto visivo e l'intero sottoalbero degli oggetti visivi figlio sono visibili. (Ereditato da Visual)
Offset	Offset dell'oggetto visivo rispetto al relativo oggetto padre o per un oggetto visivo radice l'offset rispetto all'angolo superiore sinistro delle finestre che ospita l'oggetto visivo. Animatable. (Ereditato da Visual)
Opacity	Opacità dell'oggetto visivo. Animatable. La proprietà di opacità determina la trasparenza, se presente, dell'oggetto Visivo ed è un valore compreso tra 0 e 1. 0 è completamente trasparente e 1 è opaco. Un oggetto Visual con una proprietà Opacity pari a 0 è ancora presente nell'albero. Analogamente ad altre proprietà nell'oggetto visivo, l'Opacità può essere animata tramite Windows, interfaccia utente. Sistema di animazione di composizione. (Ereditato da Visual)
Orientation	Quaternione che descrive un orientamento e una rotazione nello spazio 3D che verrà applicato all'oggetto visivo. Animatable. (Ereditato da Visual)
Parent	Padre dell'oggetto visivo. (Ereditato da Visual)
ParentForTransform	Oggetto visivo che specifica il sistema di coordinate in cui è composto questo oggetto visivo. (Ereditato da Visual)
Properties	Raccolta di proprietà associate a CompositionObject. (Ereditato da CompositionObject)
RelativeOffsetAdjustment	Specifica l'offset dell'oggetto visivo rispetto alle dimensioni dell'oggetto visivo padre. (Ereditato da Visual)
RelativeSizeAdjustment	Ottiene o imposta le dimensioni dell'oggetto visivo rispetto alle dimensioni dell'oggetto visivo padre. (Ereditato da Visual)
RotationAngle	Angolo di rotazione in radianti dell'oggetto visivo. Animatable. (Ereditato da Visual)
RotationAngleInDegrees	Angolo di rotazione dell'oggetto visivo in gradi. Animatable. (Ereditato da Visual)
RotationAxis	Asse in cui ruotare l'oggetto visivo. Animatable. (Ereditato da Visual)
Scale	Scala da applicare all'oggetto visivo. (Ereditato da Visual)
Size	Larghezza e altezza dell'oggetto visivo. Animatable. (Ereditato da Visual)
TransformMatrix	Matrice di trasformazione da applicare all'oggetto visivo. Animatable. (Ereditato da Visual)

Metodi

Close()	Chiude CompositionObject e rilascia le risorse di sistema. (Ereditato da CompositionObject)
ConnectAnimation(String, CompositionAnimation)	Connette e animazione. (Ereditato da CompositionObject)
DisconnectAnimation(String)	Disconnette un'animazione. (Ereditato da CompositionObject)
Dispose()	Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite. (Ereditato da CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Definisce una proprietà che può essere animata. (Ereditato da CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	Connette un'animazione con la proprietà specificata dell'oggetto e avvia l'animazione. (Ereditato da CompositionObject)
StartAnimation(String, CompositionAnimation)	Connette un'animazione con la proprietà specificata dell'oggetto e avvia l'animazione. (Ereditato da CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	Avvia un gruppo di animazioni. Il metodo StartAnimationGroup in CompositionObject consente di avviare CompositionAnimationGroup. Tutte le animazioni nel gruppo verranno avviate contemporaneamente sull'oggetto . (Ereditato da CompositionObject)
StopAnimation(String)	Disconnette un'animazione dalla proprietà specificata e arresta l'animazione. (Ereditato da CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	Arresta un gruppo di animazioni. (Ereditato da CompositionObject)
TryGetAnimationController(String)	Restituisce un oggetto AnimationController per l'animazione in esecuzione sulla proprietà specificata. (Ereditato da CompositionObject)

Vedi anche

• Visual
• IClosable
• Oggetto visivo di composizione senza esempio di framework (Windows 10)