CompositionEffectFactory 類別

定義

命名空間:

Microsoft.UI.Composition

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

注意

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

public ref class CompositionEffectFactory sealed : CompositionObject

/// [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)]
class CompositionEffectFactory final : CompositionObject

[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 sealed class CompositionEffectFactory : CompositionObject

Public NotInheritable Class CompositionEffectFactory
Inherits CompositionObject

繼承

Object Platform::Object IInspectable CompositionObject CompositionEffectFactory

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

範例

// Create an effect description 
GaussianBlurEffect blurEffect = new GaussianBlurEffect() 
{ 
    Name = "Blur", 
    BlurAmount = 1.0f, 
    BorderMode = EffectBorderMode.Hard, 
    Optimization = EffectOptimization.Balanced 
}; 

CompositionEffectFactory blurEffectFactory = _compositor.CreateEffectFactory(blurEffect); 

備註

組合效果是作業的圖表，定義如何根據組合介面產生圖形內容;例如，影像的圖元內容。 效果會套用至樹狀結構中的視覺效果，並可參考現有的表面。

如需建立和使用效果的相關資訊，請參閱 CompositionEffectBrush 的備註一節。

屬性

Comment	要與 CompositionObject 建立關聯的字串。 (繼承來源 CompositionObject)
Compositor	用來建立這個CompositionObject的Compositor。 (繼承來源 CompositionObject)
DispatcherQueue	取得 CompositionObject 的 DispatcherQueue。 (繼承來源 CompositionObject)
ExtendedError	呼叫 CreateBrush結果的擴充錯誤碼。
ImplicitAnimations	附加至這個物件的隱含動畫集合。 (繼承來源 CompositionObject)
LoadStatus	CreateBrush呼叫的載入狀態。
Properties	與 CompositionObject相關聯的屬性集合。 (繼承來源 CompositionObject)

方法

Close()	關閉 CompositionObject 並釋放系統資源。 (繼承來源 CompositionObject)
CreateBrush()	使用CompositionEffectFactory物件中包含的效果定義和動畫屬性，建立CompositionEffectBrush的實例。
Dispose()	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。 (繼承來源 CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	定義可以產生動畫效果的屬性。 (繼承來源 CompositionObject)
StartAnimation(String, CompositionAnimation)	使用物件的指定屬性連接動畫，並啟動動畫。 (繼承來源 CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	使用物件的指定屬性連接動畫，並啟動動畫。 (繼承來源 CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	啟動動畫群組。 CompositionObject上的 StartAnimationGroup 方法可讓您啟動CompositionAnimationGroup。 群組中的所有動畫都會在 物件上同時啟動。 (繼承來源 CompositionObject)
StopAnimation(String)	中斷與指定屬性的動畫連線，並停止動畫。 (繼承來源 CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	停止動畫群組。 (繼承來源 CompositionObject)
TryGetAnimationController(String)	傳回在指定屬性上執行的動畫的 AnimationController。 (繼承來源 CompositionObject)

另請參閱

• CompositionObject
• 組合筆刷概觀
• 組合效果概觀
• IClosable