Windows.UI.Composition 命名空間

提供使用者介面組合的 API。

類別

AmbientLight

光線,會同樣地照亮每個目標視覺效果。

AnimationController

提供 KeyFrameAnimation 的播放控制項。

AnimationEndedEventArgs

提供 CompositionPropertyAnimator.AnimationEnded 事件的事件資料。

AnimationPropertyInfo

表示可以產生動畫效果之屬性的相關資訊。

BackEasingFunction

表示 Easing 函式,此函式會在持續時間期間變更主要函式相反方向的值,然後以傳統方式反轉並完成一段時間的函式行為。

BooleanKeyFrameAnimation

以具有一或多個主要畫面格之布林值屬性為目標的時間型動畫。

BounceEasingFunction

表示緩動函式,這個函式會建立動畫彈跳效果。

BounceScalarNaturalMotionAnimation

以物理為基礎的動畫,以任何純量為基礎的屬性為目標。

BounceVector2NaturalMotionAnimation

以物理為基礎的動畫,以任何 Vector2 為基礎的屬性為目標。

BounceVector3NaturalMotionAnimation

以物理為基礎的彈跳動畫,以任何 Vector3 為基礎的屬性為目標。

CircleEasingFunction

表示緩動函式,這個函式會利用循環函式來建立加速和 (或) 減速的動畫。

ColorKeyFrameAnimation

以 Color 屬性為目標且具有一或多個色彩主要畫面格的時間型動畫。

ColorKeyFrameAnimation 類別是KeyFrameAnimation的其中一種支援類型,可用來在SpriteVisual上將Brush屬性的Color屬性動畫化。 使用 ColorKeyFrameAnimation s 時,請利用 Windows.UI.Color 物件來取得主要畫面格的值。 利用 InterpolationColorSpace 屬性來定義系統要針對動畫插補的色彩空間。

CompositionAnimation

表示基底動畫類別。

CompositionAnimationGroup

定義動畫群組。

CompositionAnimationGroup 提供在CompositionObject上呼叫StartAnimationGroup時,在清單中群組CompositionAnimations 的方法。 CompositionAnimationGroup 中的所有 CompositionAnimation 都必須將值指派給動畫本身的 Target 屬性。 CompositionAnimationGroup 也可以與 ImplicitAnimationCollection 產生關聯,做為觸發程式結果所執行的動畫。

CompositionBackdropBrush

將效果套用 (或效果鏈結的筆刷,) 到 SpriteVisual後方的區域。

CompositionBatchCompletedEventArgs

CompositionCommitBatch.CompletedCompositionScopedBatch.Completed事件的引數。

CompositionBrush

用來繪製 SpriteVisual之筆刷的基類。

CompositionCapabilities

提供檢查系統硬體功能的功能,讓視覺層效果可以據以調整。 這可讓您確保應用程式的轉譯密集作業使用量身打造,以符合裝置的功能,以提供最佳效能和令人滿意的視覺結果。

CompositionClip

裁剪物件的基類,例如 InsetClip

CompositionColorBrush

使用純色繪製 SpriteVisual

CompositionColorGradientStop

描述漸層中轉換點的位置和色彩。

CompositionColorGradientStopCollection

代表 CompositionColorGradientStop 物件的集合,這些物件可由索引個別存取。

CompositionCommitBatch

作用中動畫或效果的群組。

CompositionContainerShape

代表 CompositionShapes 的容器,用來群組共用 2D 轉換的專案。

CompositionDrawingSurface

與 Direct2D 或 Direct3D 交互操作的繪圖介面。

CompositionEasingFunction

要與 KeyFrameAnimations 搭配使用的插補器函式基類。

CompositionEasingFunction 類別是與 KeyFrameAnimation s 搭配使用的 Easing 函式的基類。 Easing 函式可用來描述系統如何在兩個不同的主要畫面格之間插補。 如需支援的 Easing 函式清單,請參閱衍生一節中的類型。

CompositionEffect

表示效果。

CompositionEffectBrush

使用篩選效果的輸出繪製 SpriteVisual。 篩選效果描述是使用 CompositionEffectFactory 類別來定義。

CompositionEffectFactory

建立組合物件,其中包含Microsoft.Graphics.Canvas.Effects命名空間中的Win2D效果描述格式。

注意

不支援的效果會在效果命名空間的 Win2D API 參考 中標示為 [NoComposition]。

CompositionEffectFactoryLoadResult

表示呼叫 CompositionEffectFactory.CompleteLoadAsync 之撥號狀態之結果的相關資訊。

CompositionEffectSourceParameter

用來 (String) 宣告任意名稱,以 (「效果來源」) 與 CompositionBrush 產生關聯。 呼叫CompositionEffectBrushSetSourceParameter方法時,就會發生指定名稱和效果來源的關聯。

CompositionEllipseGeometry

表示具有指定中心與半徑的省略號。

CompositionGeometricClip

代表裁剪視覺效果部分的圖形。 視覺效果的可見部分是由 CompositionGeometry所定義的圖形。 幾何外部視覺效果的部分會裁剪。

CompositionGeometry

表示組合幾何的基類。

CompositionGradientBrush

表示描述漸層的筆刷,由漸層停駐點組成。

CompositionGradientBrush 僅支援 Rgb 和 RgbLinear CompositionColorSpace。

CompositionGraphicsDevice

用來在撰寫器會話上為指定的 DirectX 裝置建立所有硬體系結資源。 CompositionGraphicsDevice 包含用來執行 GPU 作業的 DirectX 裝置。 開發人員可以從 Compositor 最上層物件取得圖形裝置。

CompositionImage

表示影像。

CompositionImageLoadResult

表示載入 CompositionImage 的結果。

CompositionImageOptions

代表 CompositionImage 的選項。

CompositionLight

可鎖定 UI 場景之光源的基類。

CompositionLight.Targets屬性會決定哪些視覺效果為光線。

CompositionLinearGradientBrush

表示使用線性漸層繪製區域的筆刷。

CompositionLineGeometry

表示兩點之間的直線。

CompositionMaskBrush

使用套用不透明度遮罩的 CompositionBrush 繪製 SpriteVisual。 不透明度遮罩的來源可以是 CompositionColorBrush、CompositionLinearGradientBrush、CompositionSurfaceBrush、CompositionEffectBrush 或 CompositionNineGridBrush 的任何 CompositionBrush。 不透明度遮罩必須指定為 CompositionSurfaceBrush。

CompositionMipmapSurface

代表 Mipmap 紋理的繪圖表面。

CompositionNineGridBrush

在套用 Nine-Grid Stretching 至來源筆刷的內容之後,使用 CompositionBrush 繪製 SpriteVisual 。 九格線延展的來源可以由 CompositionColorBrush、CompositionSurfaceBrush 或 CompositionEffectBrush 類型的 CompositionBrush 所組成。

CompositionObject

組合 API 的基類,表示視覺化樹狀結構中的節點。

組合物件是組合 API 使用和建置之所有其他功能的視覺化樹狀結構。 API 可讓開發人員定義及建立一或多個 Visual 物件,每個物件都代表視覺化樹狀結構中的單一節點。

CompositionPath

表示一系列連接的直線和曲線。

CompositionPathGeometry

表示一系列連接的直線和曲線。

CompositionProjectedShadow

表示使用光線、投射陰影的視覺效果,以及接收陰影的視覺效果,讓陰影在每個接收者上以不同的方式繪製,來計算場景型陰影。

CompositionProjectedShadowCaster

表示轉換投影陰影的物件。

CompositionProjectedShadowCasterCollection

代表 CompositionProjectedShadowCaster 物件的集合。

CompositionProjectedShadowReceiver

表示可以投影陰影投射的物件。

CompositionProjectedShadowReceiverUnorderedCollection

代表 CompositionProjectedShadowReceiver 物件的未排序集合。

CompositionPropertyAnimator

以動畫顯示組合屬性。

CompositionPropertySet

將值儲存為索引鍵/值組。

CompositionRadialGradientBrush

表示使用星形漸層繪製區域的筆刷。

CompositionRectangleGeometry

警告

此 API 包含 Windows 10 2004 版和以下版本的已知問題。 請勿在程式碼中使用此 API。

表示指定大小的矩形圖形。 若要取得 CompositionRectangleGeometry 實例,請呼叫 Compositor.CreateRectangleGeometry

CompositionRoundedRectangleGeometry

表示具有圓角的指定大小的矩形圖形。

CompositionScopedBatch

明確建立的作用中動畫或效果群組。

CompositionShadow

可套用至 SpriteVisual之陰影的基類。

CompositionShape

表示基底圖形類別。

CompositionShapeCollection

代表 CompositionShape 物件的集合,這些物件可由索引個別存取。

CompositionSpriteShape

繪製 Stroked 和 Filled CompositionGeometry 的 CompositionShape

CompositionStrokeDashArray

表示值的集合,表示用來大綱圖案的虛線和間距圖樣。

CompositionSurfaceBrush

使用來自 ICompositionSurface 的圖元繪製 SpriteVisual

CompositionTarget

表示要顯示組合樹狀結構的視窗。

CompositionTexture

表示原始 Direct3D 紋理,可系結至組合視覺效果做為內容。 物件可以在目前這些 API 中使用泛型組合表面的任何位置,例如,做為 Sprite 視覺效果或表面筆刷的內容。 物件會公開可用的柵欄,可用來同步處理應用程式轉譯和組合工作。 也可以接受各種屬性,例如 Alpha 模式、來源矩形和色彩空間,以更精確地定義要顯示的內容。

組合紋理 API 僅支援 Direct3D 11。

CompositionTransform

提供組合物件的一般化轉換支援。

CompositionViewBox

表示將圖形視覺化樹狀結構座標組應至視覺效果的容器。

CompositionVirtualDrawingSurface

表示疏鬆配置的點陣圖,這些點陣圖可以與視覺化樹狀結構中的組合視覺效果相關聯。

CompositionVisualSurface

以 ICompositionSurface 表示視覺化樹狀結構,可用來使用 CompositionBrush 繪製視覺效果。

Compositor

管理應用程式與系統撰寫器進程之間的會話。

Compositor 類別會為應用程式建立 Compositor 的實例,以做為 Windows.UI.Composition 命名空間中各種類型處理站的實例,跨越視覺層、效果系統和動畫系統。 Compositor 類別也會管理從處理站建立的物件存留期。

ContainerVisual

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

CubicBezierEasingFunction

表示用於插補動畫主要畫面格的三次方子函式。

DelegatedInkTrailVisual

表示系統所呈現的「濕度」筆墨筆劃,而應用程式處理「幹」筆跡轉譯階段。

DistantLight

無限大型遠距光源,會以單一方向發出光線。 例如,遠距光線可用來代表 S。

DropShadow

由 SpriteVisualLayerVisual投射的陰影。

EffectVisual

表示 CompositionEffect 根目錄的視覺化樹狀節點。

ElasticEasingFunction

表示緩動函式,這個函式會建立類似於彈簧來回振動直到停止的動畫。

ExponentialEasingFunction

表示 easing 函式,這個函式會使用指數公式建立可加速和/或減速的動畫。

ExpressionAnimation

組合動畫,使用數學方程式來計算每個畫面的動畫屬性值。

ImageVisual

表示 CompositionImage 根目錄的視覺化樹狀節點。

ImplicitAnimationCollection

符合條件時所觸發的動畫集合。

InitialValueExpressionCollection

值的集合,指定動畫開始的位置。

InsetClip

表示裁剪視覺效果部分的矩形。 矩形內的視覺效果部分是可見的;矩形外部視覺效果的部分會裁剪。

KeyFrameAnimation

具有一或多個主要畫面格的時間型動畫。 這些畫面格是標記,可讓開發人員在特定時間指定動畫屬性的值。 藉由指定主要畫面格之間的動畫插補方式,即可進一步自訂 KeyFrame 動畫。

LayerVisual

其子系扁平化成單一層的 ContainerVisual。

LinearEasingFunction

表示在動畫主要畫面格之間插補的線性函式。

NaturalMotionAnimation

表示以物理為基礎的動畫,使用強制動態移動內容。

PathKeyFrameAnimation

警告

此 API 包含 Windows 10 20H2 版和以下版本的已知問題。 請勿在程式碼中使用此 API。

表示具有一或多個主要畫面格的時間型動畫,其中每個主要畫面格值都是以 CompositionPath表示。 Easing 會指定路徑之間的交錯。

PointLight

光線的點來源,會以所有方向產生光線。

PowerEasingFunction

表示 Easing 函式,這個函式會使用公式 f (t) = t*p* 來建立動畫,以加速和/或減速,其中p等於Power屬性。

QuaternionKeyFrameAnimation

以一或多個主要畫面格為目標之 Orientation 屬性的時間型動畫。

QuaternionKeyFrameAnimation 類別是KeyFrameAnimation的其中一種支援類型,可用來以動畫顯示 Visual上的Orientation屬性。 四元數是實用且有時較簡單的旋轉方式–四元數採用角度之間的最短路徑,並避免發生旋轉角度/軸和旋轉矩陣的 Gimbal Lock 等問題。 四元數是由兩個元件所組成:純量和向量部分。

RectangleClip

代表具有選擇性圓角的矩形,可裁剪視覺效果的一部分。 矩形內的視覺效果部分是可見的;矩形外部視覺效果的部分會裁剪。

RedirectVisual

表示從另一個視覺效果取得其內容的視覺效果。

RenderingDeviceReplacedEventArgs

RenderingDeviceReplaced事件的引數。

ScalarKeyFrameAnimation

以時間為基礎的動畫,以具有一或多個主要畫面格的任何純量屬性為目標。

ScalarNaturalMotionAnimation

用來以純量屬性為目標的基底純量 NaturalMotionAnimation。

ShapeVisual

表示 CompositionShape 根目錄的視覺化樹狀節點。

SineEasingFunction

代表建立動畫之 easing 函式,其使用正弦公式來加速和/或減速。

SolidColorVisual

代表純色。

SpotLight

光源,會轉換光線的內部和外部圓錐。 例如,手電筒筒。

SpringScalarNaturalMotionAnimation

以 Spring 物理為基礎的動畫,以任何純量為基礎的屬性為目標。

SpringVector2NaturalMotionAnimation

以 Spring 物理為基礎的動畫,以任何 Vector2 為基礎的屬性為目標。

SpringVector3NaturalMotionAnimation

以 Spring 物理為基礎的動畫,以任何 Vector3 為基礎的屬性為目標。

SpriteVisual

裝載 CompositionBrush類型的 2D Boxed 內容。 筆刷中未由圖元涵蓋的任何視覺效果部分,會轉譯為透明圖元。 CompositionBrush 可以是CompositionBackdropBrushCompositionColorBrush、CompositionSurfaceBrushCompositionEffectBrush

StepEasingFunction

在動畫主要畫面格之間插補的步驟函式,其會以遞增方式前進動畫,例如可以定義的步驟。 您可以自訂初始和最終步驟的行為。

Vector2KeyFrameAnimation

以時間為基礎的動畫,以任何以 Vector2 為基礎的屬性為目標,其中包含一或多個主要畫面格。

Vector2NaturalMotionAnimation

用來以 Vector2 屬性為目標的基底 Vector2 NaturalMotionAnimation。

Vector3KeyFrameAnimation

以時間為基礎的動畫,以任何以 Vector3 為基礎的屬性為目標,其中包含一或多個主要畫面格。

Vector3NaturalMotionAnimation

用來以 Vector3 屬性為目標的基底 Vector3 NaturalMotionAnimation。

Vector4KeyFrameAnimation

以時間為基礎的動畫,以任何以 Vector4 為基礎的屬性為目標,其中包含一或多個主要畫面格。

Visual

視覺階層中的基底視覺物件。

VisualCollection

表示視覺實例的集合。

VisualUnorderedCollection

未排序的視覺效果集合。

結構

InkTrailPoint

代表 DelegatedInkTrailVisual的單一點。

介面

IAnimationObject

表示具有動畫可參考之屬性的物件。

ICompositionAnimationBase

組合動畫的基類。

ICompositionSupportsSystemBackdrop

提供使用 CompositionBrush 做為系統底板的屬性。 具有指定CompositionBrushSpriteVisual將會放在實作物件的子樹狀結構背面。

ICompositionSurface

表示介面的內容,可用來繪製 的 SpriteVisual 界限。

ICompositionSurfaceFacade

表示組合表面的預留位置,可以像實際組合表面一樣使用。

IVisualElement

標記 物件,以向系統指出它可以解析為組合 視覺效果

IVisualElement2

提供擷取物件基礎 視覺效果的方法。

列舉

AnimationControllerProgressBehavior

定義常數,指定如何決定 AnimationController.Progress 值。

AnimationDelayBehavior

指定動畫延遲行為。

AnimationDirection

指定動畫的播放方向。

AnimationEndReason

定義常數,指定動畫結束的原因。

AnimationIterationBehavior

指定動畫是否應該迴圈。

AnimationPropertyAccessMode

定義常數,指定如何存取動畫屬性。

AnimationStopBehavior

指定動畫停止時的行為。

CompositionBackfaceVisibility

指定在 3D 轉換期間,視覺效果的背面是否可見。

CompositionBatchTypes

CompositionCommitBatchCompositionScopedBatch的批次類型。

CompositionBitmapInterpolationMode

指定當 ICompositionSurface 中的圖元未形成一對一對應到螢幕上圖元時,用來插入圖元的演算法。

CompositionBorderMode

控制視覺框線邊緣的別名行為。

CompositionColorSpace

指定 ColorKeyFrameAnimation中插入色彩值的色彩空間。

CompositionCompositeMode

決定非不透明視覺效果的內容如何與視覺效果背後的背景內容混合。

CompositionDropShadowSourcePolicy

指定陰影的遮罩原則。

CompositionEasingFunctionMode

定義常數,指定與 Easing 函式插補相關聯的動畫方式。

CompositionEffectFactoryLoadStatus

效果描述之著色器的非同步編譯狀態。

CompositionGetValueStatus

指出嘗試擷取索引鍵/值組值的結果。

CompositionGradientExtendMode

定義常數,指定如何在筆刷的漸層向量或空間之外繪製漸層。

CompositionImageLoadStatus

定義常數,指定 CompositionImage.CompleteLoadAsync 呼叫的狀態。

CompositionImageProgressStage

定義常數,指定載入 CompositionImage 的進度。

CompositionMappingMode

定義常數,指定漸層筆刷的位置座標 (StartPoint、EndPoint) 是絕對還是相對於輸出區域。

CompositionStretch

指定從內容來源對應至目的地空間時如何調整內容。

CompositionStrokeCap

定義常數,指定線條或線段結尾的圖形。

CompositionStrokeLineJoin

定義常數,指定用來聯結兩行或線段的圖形。

備註

Windows.UI.Composition 概觀、範例和已知問題

項目 描述
Windows.UI.Composition 概觀 API 的概觀和架構
Windows.UI.Composition 範例 官方 Github 中的 API 範例
已知問題和最新資訊 MSDN 論壇中 API 的最新更新

另請參閱