CompositionCommitBatch 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
作用中動畫或效果的群組。
public ref class CompositionCommitBatch 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 CompositionCommitBatch 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 CompositionCommitBatch : CompositionObjectPublic NotInheritable Class CompositionCommitBatch
Inherits CompositionObject- 繼承
- 屬性
Windows 需求
| 裝置系列 |
Windows 10 (已於 10.0.10586.0 引進)
|
| API contract |
Windows.Foundation.UniversalApiContract (已於 v2.0 引進)
|
範例
認可 Batch
private void UsingCommitBatch()
{
//Create Scoped batch for animations
CompositionCommitBatch batch = Compositor.GetCommitBatch(CompositionBatchTypes.Animation);
//Setup completion event
batch.Completed += CommitBatchCompleted;
//Setup animations
Animation1(_target);
}
// Creates and defines the key frame animation
private void Animation1(Visual targetVisual)
{
var animation1 = _compositor.CreateVector3KeyFrameAnimation();
animation1.InsertKeyFrame(0.0f, new Vector3(100.00f, 100.00f, 0.00f));
animation1.InsertKeyFrame(0.5f, new Vector3(300.00f, 100.00f, 0.00f));
animation1.InsertKeyFrame(1.0f, new Vector3(500.00f, 100.00f, 0.00f));
animation1.Duration = TimeSpan.FromMilliseconds(2000);
targetVisual.StartAnimation("Offset", animation1);
}
public void CommitBatchCompleted(object sender, CompositionBatchCompletedEventArgs args)
{
_root.Children.Remove(_target);
}
備註
表示作用中動畫或效果的群組，並在群組的所有成員都完成時觸發回呼。 CompositionCommitBatch 會隱含建立，但必須依序擷取宣告完成的事件。 認可批次會在每個認可週期結束時隱含關閉。
對於動畫批次類型，回呼會在批次中最長動畫的合併延遲和持續時間經過時觸發。 對於效果 批次類型，回呼會在批次中的所有效果處理完成時觸發。
在認可週期期間隨時呼叫 Compositor.GetCommitBatch ，即可擷取目前的認可批次。 認可週期會定義為撰寫器更新之間的時間。 更新會排入佇列，直到系統準備好處理變更，並將位繪製到畫面。 認可批次會匯總認可週期內的所有物件，這些物件在 呼叫 GetCommitBatch 之前和之後。 認可批次會在撰寫執行緒上隱含建立，這是建立撰寫器所在的執行緒。 每個執行緒只能有一個撰寫器，因此每個執行緒只能有一個認可批次。 必須擷取認可批次，才能宣告已完成的事件。 認可批次會在每個認可週期結束時隱含關閉，且無法暫停或繼續，如果嘗試，這會導致錯誤。
如需組合批次的詳細資訊，請參閱 組合動畫 概觀。
屬性
| Comment |
要與 CompositionObject 建立關聯的字串。 (繼承來源 CompositionObject) |
| Compositor |
用來建立這個CompositionObject的Compositor。 (繼承來源 CompositionObject) |
| Dispatcher |
CompositionObject的發送器。 (繼承來源 CompositionObject) |
| DispatcherQueue |
取得 CompostionObject 的 DispatcherQueue 。 (繼承來源 CompositionObject) |
| ImplicitAnimations |
附加至這個物件的隱含動畫集合。 (繼承來源 CompositionObject) |
| IsActive |
指出 CompositionCommitBatch 目前是否開啟，以便匯總物件。 |
| IsEnded |
指出 CompositionCommitBatch 是否已關閉，且無法再接受變更。 |
| Properties |
與 CompositionObject相關聯的屬性集合。 (繼承來源 CompositionObject) |
方法
事件
| Completed |
CompositionCommitBatch中所有物件完成時所觸發的事件。 |