CompositionScopedBatch 類別

定義

命名空間:

Windows.UI.Composition

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

public ref class CompositionScopedBatch sealed : CompositionObject

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CompositionScopedBatch final : CompositionObject

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class CompositionScopedBatch : CompositionObject

Public NotInheritable Class CompositionScopedBatch
Inherits CompositionObject

繼承

Object Platform::Object IInspectable CompositionObject CompositionScopedBatch

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 10 (已於 10.0.10586.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v2.0 引進)

範例

限定範圍的 Batch

// The Green Square's completion events for the Offset and Opacity animations are aggregated
// The Rotation animation completion event is not aggregated
// When the aggregated events are completed OnBatchCompleted method is executed
public void BatchAnimations()
{
    // Create a Scoped batch to capture animation completion events
    _batch = _compositor.CreateScopedBatch(CompositionBatchTypes.Animation);

    // Executing the Offset animation and aggregating completion event
    ApplyOffsetAnimation(_greenSquare);

    // Suspending to exclude the following Rotation animation from the batch
    _batch.Suspend();

    // Executing the Rotation animation 
    ApplyRotationAnimation(_greenSquare);

    // Resuming the batch to collect additional animations
    _batch.Resume();

    // Executing the Opacity animation and aggregating completion event
    ApplyOpacityAnimation(_greenSquare);

    // Batch is ended and no objects can be added
    _batch.End();

    // Method triggered when batch completion event fires
    _batch.Completed += OnBatchCompleted;
}

備註

表示作用中動畫或效果的群組，並在群組的所有成員都完成時觸發回呼。 已明確建立 CompositionScopedBatch，並用來指定要包含在單一範圍批次中的特定物件。

您可以建立多個 CompositionScopedBatch 實例，並同時在多個批次中匯總物件。

建立

若要匯總特定動畫群組或以單一動畫完成事件為目標，您可以建立限定範圍的批次。 使用 Compositor.CreateScopedBatch 明確建立範圍批次，並用來指定要包含在單一批次中的特定物件。 範圍批次可以在任何執行緒上建立，而且不會系結至組合執行緒。 限定範圍的批次只會在建立它的執行緒內匯總物件。

CompositionScopedBatch myScopedBatch = _compositor.CreateScopedBatch(CompositionBatchTypes.Animation);

暫停和繼續

建立範圍批次之後，所有已啟動的動畫都會匯總，直到批次明確暫停或使用 Suspend 或 End 函式結束為止。

CompositionScopedBatch 可能會使用 Suspend 明確暫停，以便從該批次中排除物件。 當批次暫停時，可以藉由呼叫 Resume重新開啟。 呼叫 Suspend 函式會停止匯總動畫結束狀態，直到呼叫 Resume 為止。 這可讓您明確排除來自指定之批次的內容。

在以下範例中，鎖定 VisualA 位移屬性的動畫將不會納入批次中：

myScopedBatch.Suspend();
VisualA.StartAnimation("Offset", myAnimation);
myScopeBatch.Resume();

結束

CompositionScopedBatch 必須使用 End明確關閉。 一旦關閉，就無法暫停或再次繼續。 若要完成您的批次，您必須呼叫 End()。 如果沒有 End 呼叫，批次就會讓不斷進行收集的物件保持開啟。

下列程式碼片段和圖表顯示批次如何匯總動畫以追蹤結束狀態的範例。

請注意，在此範例中，動畫 1、3 和 4 具有由此批次追蹤的結束狀態，但動畫 2 則否。

myScopedBatch.End();
CompositionScopedBatch myScopedBatch = 	_compositor.CreateScopedBatch(CompositionBatchTypes.Animation);
// Start Animation1
[…]
myScopedBatch.Suspend();
// Start Animation2 
[…]
myScopedBatch.Resume();
// Start Animation3
[…]
// Start Animation4
[…]
myScopedBatch.End();

批次處理單一動畫的完成事件

如果您想要知道單一動畫何時結束，您必須建立範圍批次，只包含您設定目標的動畫。

例如：

CompositionScopedBatch myScopedBatch = 	_compositor.CreateScopedBatch(CompositionBatchTypes.Animation);
Visual.StartAnimation("Opacity", myAnimation);
myScopedBatch.End();

擷取批次完成事件

批次處理一或多個動畫時，將會依照相同方式擷取批次完成事件。 您可以為目標批次的 Completed 事件註冊事件處理方法。

myScopedBatch.Completed += OnBatchCompleted;

批次狀態

您可以使用兩個屬性來判斷現有批次的狀態; IsActive 和 IsEnded。

若鎖定的批次接受進行動畫彙總，則 IsActive 屬性會傳回 true。 批次暫停或結束時，IsActive 會傳回 false。

若您無法將動畫新增至該特定批次，則 IsEnded 屬性會傳回 true。 當您明確呼叫特定批次的 End 時，將會結束批次。

屬性

Comment	要與 CompositionObject 建立關聯的字串。 (繼承來源 CompositionObject)
Compositor	用來建立這個CompositionObject的Compositor。 (繼承來源 CompositionObject)
Dispatcher	CompositionObject的發送器。 (繼承來源 CompositionObject)
DispatcherQueue	取得 CompostionObject 的 DispatcherQueue 。 (繼承來源 CompositionObject)
ImplicitAnimations	附加至這個物件的隱含動畫集合。 (繼承來源 CompositionObject)
IsActive	指出 CompositionScopedBatch 目前是否開啟，以便匯總物件。
IsEnded	指出 CompositionScopedBatch 是否已關閉，且無法再接受變更。
Properties	與 CompositionObject相關聯的屬性集合。 (繼承來源 CompositionObject)

方法

Close()	關閉 CompositionObject 並釋放系統資源。 (繼承來源 CompositionObject)
ConnectAnimation(String, CompositionAnimation)	連接和動畫。 (繼承來源 CompositionObject)
DisconnectAnimation(String)	中斷動畫的連接。 (繼承來源 CompositionObject)
Dispose()	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。 (繼承來源 CompositionObject)
End()	關閉 CompositionScopedBatch。 當 CompositionScopedBatch關閉之後，就無法暫停或再次繼續。
PopulatePropertyInfo(String, AnimationPropertyInfo)	定義可以產生動畫效果的屬性。 (繼承來源 CompositionObject)
Resume()	繼續匯總 CompositionScopedBatch中的物件。
StartAnimation(String, CompositionAnimation, AnimationController)	使用物件的指定屬性連接動畫，並啟動動畫。 (繼承來源 CompositionObject)
StartAnimation(String, CompositionAnimation)	使用物件的指定屬性連接動畫，並啟動動畫。 (繼承來源 CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	啟動動畫群組。 CompositionObject上的 StartAnimationGroup 方法可讓您啟動CompositionAnimationGroup。 群組中的所有動畫都會在 物件上同時啟動。 (繼承來源 CompositionObject)
StopAnimation(String)	中斷與指定屬性的動畫連線，並停止動畫。 (繼承來源 CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	停止動畫群組。 (繼承來源 CompositionObject)
Suspend()	暫停 在 CompositionScopedBatch中匯總物件。
TryGetAnimationController(String)	傳回在指定屬性上執行的動畫的 AnimationController。 (繼承來源 CompositionObject)

事件

Completed

當 CompositionScopedBatch中的所有動畫和效果都完成之後，就會觸發事件。

另請參閱

• CompositionObject
• IClosable
• 組合動畫概觀