Share via


Microsoft.UI.Composition 命名空間

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

類別

AmbientLight

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

AnimationController

提供 KeyFrameAnimation 的播放控制項。

AnimationPropertyInfo

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

BackEasingFunction

表示緩動函式,這個函式會於開始在指示的路徑顯示動畫之前,稍微撤回動畫的動作。

BooleanKeyFrameAnimation

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

BounceEasingFunction

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

BounceScalarNaturalMotionAnimation

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

BounceVector2NaturalMotionAnimation

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

BounceVector3NaturalMotionAnimation

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

CircleEasingFunction

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

ColorKeyFrameAnimation

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

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

CompositionAnimation

表示基底動畫類別。

CompositionAnimationGroup

定義動畫群組。

CompositionAnimationGroup 可讓您將CompositionAnimation群組在清單中,當CompositionObject上呼叫StartAnimationGroup時,將會同時啟動。 CompositionAnimationGroup 中的所有 CompositionAnimation 都必須將值指派給動畫本身的 Target 屬性。 CompositionAnimationGroup 也可以與 ImplicitAnimationCollection 建立關聯,做為觸發程式結果所執行的動畫。

CompositionApiInformation

表示組合 API 的相關資訊。

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 函式: 線性立方體 BezierStep

CompositionEffectBrush

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

CompositionEffectFactory

Microsoft.Graphics.Canvas.Effects命名空間中建立包含Win2D效果描述格式的組合物件, (WinAppSDK (WinUI 3) / UWP (WinUI 2) ) 。

注意

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

CompositionEffectSourceParameter

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

CompositionEllipseGeometry

表示具有指定中央和半徑的省略號。

CompositionGeometricClip

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

CompositionGeometry

表示組合幾何的基類。

CompositionGradientBrush

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

CompositionGradientBrush 僅支援 Rgb 和 RgbLinear CompositionColorSpace。

CompositionGraphicsDevice

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

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。

CompositionNotificationDeferral

表示應用程式可用來以非同步方式回應組合通知的延遲。

CompositionObject

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

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

CompositionPath

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

CompositionPathGeometry

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

CompositionProjectedShadow

代表使用光線、轉換陰影的視覺效果,以及接收陰影的視覺效果,來計算場景型陰影,讓陰影在每一個接收者上繪製不同。

CompositionProjectedShadowCaster

表示物件,這個物件會轉換投影的陰影。

CompositionProjectedShadowCasterCollection

代表 CompositionProjectedShadowCaster 物件的集合。

CompositionProjectedShadowReceiver

表示物件,該物件上可以有投影的陰影轉換。

CompositionProjectedShadowReceiverUnorderedCollection

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

CompositionPropertySet

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

CompositionRadialGradientBrush

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

CompositionRectangleGeometry

表示指定大小的矩形圖形。

CompositionRoundedRectangleGeometry

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

CompositionScopedBatch

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

CompositionShadow

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

CompositionShape

表示基底圖形類別。

CompositionShapeCollection

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

CompositionSpriteShape

繪製 Stroked 和 Filled CompositionGeometry 的 CompositionShape

CompositionStrokeDashArray

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

CompositionSurfaceBrush

使用來自 ICompositionSurface 的圖元繪製 SpriteVisual

CompositionTransform

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

CompositionViewBox

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

CompositionVirtualDrawingSurface

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

CompositionVisualSurface

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

Compositor

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

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

ContainerVisual

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

CubicBezierEasingFunction

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

立方體-bezier 函式是搭配 KeyFrameAnimations 使用的其中一個較常見的 Easing 函式,經常用來描述可調整的平滑曲線。 立方-bezier 函式是由 Vector2 類型的兩個「控制點」定義,可定義曲線的形狀。 使用時,動畫屬性會根據定義的曲線,在兩個主要畫面格之間變更。

DistantLight

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

DropShadow

由 SpriteVisualLayerVisual投射的陰影。

ElasticEasingFunction

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

ExponentialEasingFunction

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

ExpressionAnimation

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

ImplicitAnimationCollection

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

InitialValueExpressionCollection

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

InsetClip

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

KeyFrameAnimation

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

LayerVisual

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

LinearEasingFunction

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

NaturalMotionAnimation

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

PathKeyFrameAnimation

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

PointLight

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

PowerEasingFunction

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

QuaternionKeyFrameAnimation

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

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

RectangleClip

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

RedirectVisual

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

RenderingDeviceReplacedEventArgs

RenderingDeviceReplaced事件的引數。

ScalarKeyFrameAnimation

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

ScalarNaturalMotionAnimation

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

ShapeVisual

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

SineEasingFunction

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

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

未排序的視覺效果集合。

介面

IAnimationObject

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

ICompositionAnimationBase

組合動畫的基類。

ICompositionSupportsSystemBackdrop

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

ICompositionSurface

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

ICompositionSurfaceFacade

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

IVisualElement

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

IVisualElement2

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

列舉

AnimationControllerProgressBehavior

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

AnimationDelayBehavior

指定動畫延遲行為。

AnimationDirection

指定動畫的播放方向。

AnimationIterationBehavior

指定動畫是否應該迴圈。

AnimationPropertyAccessMode

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

AnimationStopBehavior

指定動畫停止時的行為。

CompositionBackfaceVisibility

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

CompositionBatchTypes

CompositionCommitBatchCompositionScopedBatch的批次類型。

CompositionBitmapInterpolationMode

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

CompositionBorderMode

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

CompositionColorSpace

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

CompositionCompositeMode

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

CompositionDropShadowSourcePolicy

指定陰影的遮罩原則。

CompositionEasingFunctionMode

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

CompositionEffectFactoryLoadStatus

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

CompositionGetValueStatus

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

CompositionGradientExtendMode

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

CompositionMappingMode

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

CompositionProjectedShadowDrawOrder

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

CompositionStretch

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

CompositionStrokeCap

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

CompositionStrokeLineJoin

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

備註

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

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

另請參閱