CompositionEffectFactory 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
在Microsoft.Graphics.Canvas.Effects命名空間中建立包含Win2D效果描述格式的組合物件， (WinAppSDK (WinUI 3) / UWP (WinUI 2) ) 。
注意
不支援的效果會標示為效果命名空間的 Win2D API 參考 中的 [NoComposition]。
public ref class CompositionEffectFactory sealed : CompositionObject/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.LiftedContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
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(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
class CompositionEffectFactory final : CompositionObject[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.LiftedContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class CompositionEffectFactory : 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 : CompositionObjectPublic NotInheritable Class CompositionEffectFactory
Inherits CompositionObject- 繼承
- 屬性
範例
// 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, AnimationController) |
使用物件的指定屬性連接動畫，並啟動動畫。 (繼承來源 CompositionObject) |
| StartAnimation(String, CompositionAnimation) |
使用物件的指定屬性連接動畫，並啟動動畫。 (繼承來源 CompositionObject) |
| StartAnimationGroup(ICompositionAnimationBase) |
啟動動畫群組。 CompositionObject上的 StartAnimationGroup 方法可讓您啟動CompositionAnimationGroup。 群組中的所有動畫都會在 物件上同時啟動。 (繼承來源 CompositionObject) |
| StopAnimation(String) |
中斷與指定屬性的動畫連線，並停止動畫。 (繼承來源 CompositionObject) |
| StopAnimationGroup(ICompositionAnimationBase) |
停止動畫群組。 (繼承來源 CompositionObject) |
| TryGetAnimationController(String) |
傳回在指定屬性上執行的動畫的 AnimationController。 (繼承來源 CompositionObject) |