Metodo IDCompositionScaleTransform3D::SetScaleZ(IDCompositionAnimation*) (dcomp.h)

Anima il valore della proprietà ScaleZ di una trasformazione di scala. La proprietà ScaleZ specifica il fattore di scala lungo l'asse z.

Sintassi

HRESULT SetScaleZ(
  [in] IDCompositionAnimation *animation
);

Parametri

[in] animation

Tipo: IDCompositionAnimation*

Oggetto di animazione che determina il modo in cui il valore della proprietà ScaleZ cambia nel tempo. Questo parametro non deve essere NULL.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT . Per un elenco di codici di errore, vedere Codici di errore DirectComposition .

Commenti

Questo metodo esegue una copia dell'animazione specificata. Se l'oggetto a cui fa riferimento il parametro di animazione viene modificato dopo aver chiamato questo metodo, la modifica non influisce sulla proprietà ScaleZ a meno che questo metodo non venga chiamato di nuovo. Se la proprietà ScaleZ è stata animata in precedenza, chiamando questo metodo sostituisce l'animazione precedente con la nuova animazione.

Questo metodo ha esito negativo se l'animazione è un puntatore non valido o se non è stata creata dalla stessa interfaccia IDCompositionDevice dell'oggetto visivo interessato. L'interfaccia non può essere un'implementazione personalizzata; è possibile usare solo interfacce create da Microsoft DirectComposition con questo metodo.

Requisiti

Vedi anche

IDCompositionScaleTransform3D

IDCompositionScaleTransform3D::SetScaleX

IDCompositionScaleTransform3D::SetScaleY