IDCompositionMatrixTransform：：SetMatrixElement (int，int，IDCompositionAnimation*) 方法 (dcomp.h)

以動畫顯示這個 2D 轉換矩陣的一個專案值。

語法

HRESULT SetMatrixElement(
  [in] int                    row,
  [in] int                    column,
  [in] IDCompositionAnimation *animation
);

[in] row

要變更之專案的資料列索引。此值必須介於 0 到 2 之間，包含。

[in] column

要變更之專案的資料行索引。此值必須介於 0 到 1 之間，包含。

[in] animation

動畫，表示指定專案的值隨著時間變更的方式。此參數不得為 Null。

如果函式成功，則會傳回S_OK。否則，它會傳回 HRESULT 錯誤碼。如需錯誤碼清單，請參閱 DirectComposition 錯誤碼。

這個方法會建立指定動畫的複本。如果在呼叫此方法之後，動畫參數所參考的物件已變更，除非再次呼叫此方法，否則變更不會影響元素。如果元素先前已產生動畫效果，則呼叫這個方法會將先前的動畫取代為新的動畫。

如果動畫是不正確指標，或不是由與受影響轉換相同的 IDCompositionDevice 介面所建立，這個方法就會失敗。介面不能是自訂實作;只有由 Microsoft DirectComposition 建立的介面可以搭配這個方法使用。