ContainerVisual 類別

定義

命名空間:

Microsoft.UI.Composition

視覺化樹狀結構中可以有子系的節點。

[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

繼承

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

範例

//
// 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	指定在 3D 轉換期間是否應該顯示視覺效果的背面。 (繼承來源 Visual)
BorderMode	指定如何撰寫與視覺效果相關聯之點陣圖和剪輯的邊緣，或與此視覺效果根目錄之子樹中的所有視覺效果。 在父視覺效果上設定 BorderMode 會影響子樹中的所有子系視覺效果，而且可以在每個子視覺效果選擇性地關閉。 (繼承來源 Visual)
CenterPoint	發生旋轉或縮放的點。 可產生動畫效果 (繼承來源 Visual)
Children	ContainerVisual的子系。
Clip	指定視覺效果的裁剪區域。 轉譯視覺效果時，只會顯示落在裁剪區域中的視覺效果部分，而任何在裁剪區域外延伸的內容都會裁剪 (，而不是顯示) 。 (繼承來源 Visual)
Comment	要與 CompositionObject 建立關聯的字串。 (繼承來源 CompositionObject)
CompositeMode	指定視覺效果的點陣圖如何與螢幕混合。 (繼承來源 Visual)
Compositor	用來建立這個CompositionObject的Compositor。 (繼承來源 CompositionObject)
DispatcherQueue	取得 CompositionObject 的 DispatcherQueue。 (繼承來源 CompositionObject)
ImplicitAnimations	附加至這個物件的隱含動畫集合。 (繼承來源 CompositionObject)
IsHitTestVisible	取得或設定值，這個值表示這個視覺效果上根目錄的視覺子樹狀結構是否參與點擊測試。 (繼承來源 Visual)
IsPixelSnappingEnabled	取得或設定值，這個值表示組合引擎是否對齊呈現的視覺效果與圖元界限。 (繼承來源 Visual)
IsVisible	指出視覺效果及其子視覺效果的整個子樹是否可見。 (繼承來源 Visual)
Offset	視覺效果相對於其父系的位移，或根視覺效果的位移相對於裝載視覺效果之視窗左上角的位移。 可產生動畫效果。 (繼承來源 Visual)
Opacity	視覺效果的不透明度。 可產生動畫效果。 不透明度屬性會判斷視覺效果的任何透明度，而且是介於 0 到 1 之間的值。 0 完全透明，1 不透明。 具有不透明度屬性為 0 的視覺效果仍存在於樹狀結構中。 就像視覺效果上的其他屬性一樣，Opacity 可以使用 Windows、UI 產生動畫效果。組合動畫系統。 (繼承來源 Visual)
Orientation	四元數，描述將在 3D 空間中套用至視覺效果的方向和旋轉。 可產生動畫效果。 (繼承來源 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)
Dispose()	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。 (繼承來源 CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	定義可以產生動畫效果的屬性。 (繼承來源 CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	使用物件的指定屬性連接動畫，並啟動動畫。 (繼承來源 CompositionObject)
StartAnimation(String, CompositionAnimation)	使用物件的指定屬性連接動畫，並啟動動畫。 (繼承來源 CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	啟動動畫群組。 CompositionObject上的 StartAnimationGroup 方法可讓您啟動CompositionAnimationGroup。 群組中的所有動畫都會在 物件上同時啟動。 (繼承來源 CompositionObject)
StopAnimation(String)	中斷與指定屬性的動畫連線，並停止動畫。 (繼承來源 CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	停止動畫群組。 (繼承來源 CompositionObject)
TryGetAnimationController(String)	傳回在指定屬性上執行的動畫的 AnimationController。 (繼承來源 CompositionObject)

另請參閱

• Visual
• IClosable
• 不含架構的組合視覺效果範例 (Windows 10)