Microsoft.UI.Composition 命名空間
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
提供使用者介面組合的 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.Completed或CompositionScopedBatch.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 函式: 線性、 立方體 Bezier 和 Step。 |
CompositionEffectBrush |
使用篩選效果的輸出繪製 SpriteVisual。 篩選效果描述是使用 CompositionEffectFactory 類別來定義。 |
CompositionEffectFactory |
在Microsoft.Graphics.Canvas.Effects命名空間中建立包含Win2D效果描述格式的組合物件, (WinAppSDK (WinUI 3) / UWP (WinUI 2) ) 。 注意 不支援的效果會標示為效果命名空間的 Win2D API 參考 中的 [NoComposition]。 |
CompositionEffectSourceParameter |
用來宣告) 字串 (與 CompositionBrush 相關聯的任意名稱, (「效果來源」) 。 呼叫CompositionEffectBrush的SetSourceParameter方法時,會發生指定名稱和效果來源的關聯。 |
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 |
由 SpriteVisual或LayerVisual投射的陰影。 |
ElasticEasingFunction |
表示緩動函式,這個函式會建立類似於彈簧來回振動直到停止的動畫。 |
ExponentialEasingFunction |
表示 easing 函式,這個函式會使用指數公式建立可加速和/或減速的動畫。 |
ExpressionAnimation |
組合動畫,使用數學方程式來計算每個畫面的動畫屬性值。 |
ImplicitAnimationCollection |
符合條件時所觸發的動畫集合。 |
InitialValueExpressionCollection |
值的集合,指定動畫開始的位置。 |
InsetClip |
表示裁剪視覺效果部分的矩形。 矩形內的視覺效果部分是可見的;矩形外部視覺效果的部分會裁剪。 |
KeyFrameAnimation |
具有一或多個主要畫面格的時間型動畫。 這些畫面格是標記,可讓開發人員在特定時間指定動畫屬性的值。 藉由指定主要畫面格之間的動畫插補方式,即可進一步自訂 KeyFrame 動畫。 |
LayerVisual |
其子系扁平化成單一層的 ContainerVisual。 |
LinearEasingFunction |
表示在動畫主要畫面格之間插補的線性函式。 |
NaturalMotionAnimation |
表示以物理為基礎的動畫,使用強制動態移動內容。 |
PathKeyFrameAnimation |
表示具有一或多個主要畫面格的時間型動畫,其中每個主要畫面格值都是以 CompositionPath表示。 Easing 會指定路徑之間的交錯。 |
PointLight |
光線的點來源,會以所有方向產生光線。 |
PowerEasingFunction |
表示 Easing 函式,這個函式會使用 公式 f (t) = tp 來建立動畫,以加速和/或減速,其中 p 等於 |
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 可以是CompositionBackdropBrush、CompositionColorBrush、CompositionSurfaceBrush或CompositionEffectBrush。 |
StepEasingFunction |
用於插補動畫主要畫面格之間的步驟函式。 遞增動畫,例如可以定義的步驟。 您可以自訂初始和最終步驟的行為。 |
Vector2KeyFrameAnimation |
以時間為基礎的動畫,以任何以 Vector2 為基礎的屬性為目標,其中包含一或多個主要畫面格。 |
Vector2NaturalMotionAnimation |
用來以 Vector2 屬性為目標的基底 Vector2 NaturalMotionAnimation。 |
Vector3KeyFrameAnimation |
以時間為基礎的動畫,以任何以 Vector3 為基礎的屬性為目標,其中包含一或多個主要畫面格。 |
Vector3NaturalMotionAnimation |
用來以 Vector3 屬性為目標的基底 Vector3 NaturalMotionAnimation。 |
Vector4KeyFrameAnimation |
以時間為基礎的動畫,以任何以 Vector4 為基礎的屬性為目標,其中包含一或多個主要畫面格。 |
Visual |
視覺階層中的基底視覺物件。 |
VisualCollection |
表示視覺實例的集合。 |
VisualUnorderedCollection |
未排序的視覺效果集合。 |
介面
IAnimationObject |
表示具有動畫可參考之屬性的物件。 |
ICompositionAnimationBase |
組合動畫的基類。 |
ICompositionSupportsSystemBackdrop |
提供使用 CompositionBrush 做為系統底板的屬性。 具有指定CompositionBrush的SpriteVisual將會放在實作物件的子樹狀結構背面。 |
ICompositionSurface |
表示介面的內容,可用來繪製 的 |
ICompositionSurfaceFacade |
表示組合表面的預留位置,可以像實際組合表面一樣使用。 |
IVisualElement |
標記 物件,以向系統指出它可以解析為組合 視覺效果 |
IVisualElement2 |
提供擷取物件基礎 視覺效果的方法。 |
列舉
備註
Windows.UI.Composition 概觀、範例和已知問題
項目 | 描述 |
---|---|
Windows.UI.Composition 概觀 | API 的概觀和架構 |
Windows.UI.Composition 範例 | 官方 Github 中的 API 範例 |
已知問題和最新資訊 | MSDN 論壇中 API 的最新更新 |