ContainerVisual Classe

Definição

Namespace:: Microsoft.UI.Composition

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Editar

Um nó na árvore visual que pode ter filhos.

[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

Herança: Object Platform::Object IInspectable CompositionObject Visual ContainerVisual

Derivado: Microsoft.UI.Composition.LayerVisual

Microsoft.UI.Composition.RedirectVisual

Microsoft.UI.Composition.Scenes.SceneVisual

Microsoft.UI.Composition.ShapeVisual

Microsoft.UI.Composition.SpriteVisual

Atributos: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Exemplos

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

Propriedades

Nome	Description
AnchorPoint	O ponto no visual a ser posicionado no deslocamento do visual. O valor é normalizado em relação ao tamanho do visual. Animatable. (Herdado de Visual)
BackfaceVisibility	Especifica se a face traseira do visual deve estar visível durante uma transformação 3D. (Herdado de Visual)
BorderMode	Especifica como compor as bordas de bitmaps e clipes associados a um visual ou com todos os visuais na subárvore com raiz neste visual. A configuração de BorderMode em um visual pai afetará todos os visuais filhos na subárvore e poderá ser desativada seletivamente em cada visual filho. (Herdado de Visual)
CenterPoint	O ponto sobre qual rotação ou escala ocorre. Animatable (Herdado de Visual)
Children	Os filhos do ContainerVisual.
Clip	Especifica a região de recorte para o visual. Quando um visual é renderizado, somente a parte do visual que cai dentro da região de recorte é exibida, enquanto qualquer conteúdo que se estenda fora da região de recorte é recortado (ou seja, não exibido). (Herdado de Visual)
Comment	Uma cadeia de caracteres a ser associada ao CompositionObject. (Herdado de CompositionObject)
CompositeMode	Especifica como o bitmap de um visual é misturado com a tela. (Herdado de Visual)
Compositor	O Compositor usado para criar este CompositionObject. (Herdado de CompositionObject)
DispatcherQueue	Obtém o DispatcherQueue para o CompositionObject. (Herdado de CompositionObject)
ImplicitAnimations	A coleção de animações implícitas anexadas a esse objeto. (Herdado de CompositionObject)
IsHitTestVisible	Obtém ou define um valor que indica se a subárvore visual com raiz nesse visual participa do teste de clique. (Herdado de Visual)
IsPixelSnappingEnabled	Obtém ou define um valor que indica se o mecanismo de composição alinha o visual renderizado com um limite de pixel. (Herdado de Visual)
IsVisible	Indica se o visual e toda a subárvore de visuais filho estão visíveis. (Herdado de Visual)
Offset	O deslocamento do visual em relação ao pai ou a um visual raiz o deslocamento relativo ao canto superior esquerdo das janelas que hospedam o visual. Animatable. (Herdado de Visual)
Opacity	A opacidade do visual. Animatable. A propriedade opacidade determina a transparência, se houver, do Visual e é um valor de 0 a 1. 0 é totalmente transparente e 1 é totalmente opaco. Um Visual com uma propriedade Opacity de 0 ainda está presente na árvore. Assim como outras propriedades no Visual, a opacidade pode ser animada usando o Windows, interface do usuário. Sistema de animação de composição. (Herdado de Visual)
Orientation	Um quatérnio que descreve uma orientação e rotação no espaço 3D que será aplicado ao visual. Animatable. (Herdado de Visual)
Parent	O pai do visual. (Herdado de Visual)
ParentForTransform	Visual especificando o sistema de coordenadas no qual esse visual é composto. (Herdado de Visual)
Properties	A coleção de propriedades associadas ao CompositionObject. (Herdado de CompositionObject)
RelativeOffsetAdjustment	Especifica o deslocamento do visual em relação ao tamanho de seu visual pai. (Herdado de Visual)
RelativeSizeAdjustment	Obtém ou define o tamanho do visual em relação ao tamanho de seu visual pai. (Herdado de Visual)
RotationAngle	O ângulo de rotação em radianos do visual. Animatable. (Herdado de Visual)
RotationAngleInDegrees	O ângulo de rotação do visual em graus. Animatable. (Herdado de Visual)
RotationAxis	O eixo para girar o visual ao redor. Animatable. (Herdado de Visual)
Scale	A escala a ser aplicada ao visual. (Herdado de Visual)
Size	A largura e a altura do visual. Animatable. (Herdado de Visual)
TransformMatrix	A matriz de transformação a ser aplicada ao visual. Animatable. (Herdado de Visual)

Métodos

Nome	Description
Close()	Fecha o CompositionObject e libera os recursos do sistema. (Herdado de CompositionObject)
Dispose()	Executa tarefas definidas pelo aplicativo associadas à liberação, liberação ou redefinição de recursos não gerenciados. (Herdado de CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Define uma propriedade que pode ser animada. (Herdado de CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	Conecta uma animação com a propriedade especificada do objeto e inicia a animação. (Herdado de CompositionObject)
StartAnimation(String, CompositionAnimation)	Conecta uma animação com a propriedade especificada do objeto e inicia a animação. (Herdado de CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	Inicia um grupo de animação. O método StartAnimationGroup em CompositionObject permite iniciar CompositionAnimationGroup. Todas as animações no grupo serão iniciadas ao mesmo tempo no objeto. (Herdado de CompositionObject)
StopAnimation(String)	Desconecta uma animação da propriedade especificada e interrompe a animação. (Herdado de CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	Interrompe um grupo de animação. (Herdado de CompositionObject)
TryGetAnimationController(String)	Retorna um AnimationController para a animação em execução na propriedade especificada. (Herdado de CompositionObject)

Aplica-se a

Confira também

Visual
IClosable

Comentários

Esta página foi útil?