IDCompositionMatrixTransform::SetMatrixElement(int, int, IDCompositionAnimation * ) -Methode
Animiert den Wert eines Elements der Matrix dieser 2D-Transformation.
Syntax
HRESULT SetMatrixElement(
[in] int row,
[in] int column,
[in] IDCompositionAnimation *animation
);
Parameter
-
row [ In]
-
Der Zeilenindex des elements, das geändert werden soll. Dieser Wert muss zwischen 0 und 2 (einschließlich) liegen.
-
-Spalte [ In]
-
Der Spaltenindex des elements, das geändert werden soll. Dieser Wert muss zwischen 0 und 1 (einschließlich) liegen.
-
Animation [ In]
-
Eine Animation, die darstellt, wie sich der Wert des angegebenen Elements im Laufe der Zeit ändert. Dieser Parameter darf nicht NULL sein.
Rückgabewert
Wenn die Funktion erfolgreich ausgeführt wird, wird S _ OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben. Eine Liste der Fehlercodes finden Sie unter DirectComposition-Fehlercodes.
Hinweise
Diese Methode erstellt eine Kopie der angegebenen Animation. Wenn das Objekt, auf das vom Animationsparameter verwiesen wird, nach dem Aufruf dieser Methode geändert wird, wirkt sich die Änderung nicht auf das Element aus, es sei denn, diese Methode wird erneut aufgerufen. Wenn das Element zuvor animiert wurde, ersetzt der Aufruf dieser Methode die vorherige Animation durch die neue Animation.
Diese Methode schlägt fehl, wenn die Animation ein ungültiger Zeiger ist oder nicht von der gleichen IDCompositionDevice-Schnittstelle wie die betroffene Transformation erstellt wurde. Die Schnittstelle darf keine benutzerdefinierte Implementierung sein. nur von Microsoft DirectComposition erstellte Schnittstellen können mit dieser Methode verwendet werden.