IDCompositionMatrixTransform3D::SetMatrixElement(int,int,IDCompositionAnimation*)-Methode (dcomp.h)
Animiert den Wert eines Elements der Matrix dieser 3D-Transformation.
Syntax
HRESULT SetMatrixElement(
[in] int row,
[in] int column,
[in] IDCompositionAnimation *animation
);
Parameter
[in] row
Typ: int
Der Zeilenindex des zu ändernden Elements. Dieser Wert muss zwischen 0 und 3 (einschließlich) liegen.
[in] column
Typ: int
Der Spaltenindex des zu ändernden Elements. Dieser Wert muss zwischen 0 und 3 (einschließlich) liegen.
[in] animation
Typ: IDCompositionAnimation*
Eine Animation, die darstellt, wie sich der Wert des angegebenen Elements im Laufe der Zeit ändert. Dieser Parameter darf nicht NULL sein.
Rückgabewert
Typ: HRESULT
Wenn die Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT 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 angegebene Element aus, es sei denn, diese Methode wird erneut aufgerufen. Wenn das angegebene Element zuvor animiert wurde, ersetzt das Aufrufen 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 derselben IDCompositionDevice-Schnittstelle wie die betroffene Transformation erstellt wurde. Die Schnittstelle kann keine benutzerdefinierte Implementierung sein. mit dieser Methode können nur schnittstellen verwendet werden, die von Microsoft DirectComposition erstellt wurden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | dcomp.h |
| Bibliothek | Dcomp.lib |
| DLL | Dcomp.dll |