Metodo IDCompositionRotateTransform3D::SetAxisZ(IDCompositionAnimation*) (dcomp.h)

Anima il valore della proprietà AxisZ di una trasformazione di rotazione 3D. La proprietà AxisZ specifica la coordinata z per il vettore dell'asse di rotazione. Il valore predefinito è 1,0.

Sintassi

HRESULT SetAxisZ(
  [in] IDCompositionAnimation *animation
);

Parametri

[in] animation

Tipo: IDCompositionAnimation*

Oggetto animazione che determina il modo in cui il valore della proprietà AxisZ 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

Quando si imposta l'asse su un valore non predefinito, è sempre necessario impostare tutte e tre le proprietà dell'asse (AxisX, AxisY e AxisZ).

Questo metodo crea 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à AxisZ, a meno che questo metodo non venga chiamato di nuovo. Se la proprietà AxisZ è stata animata in precedenza, la chiamata a 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 della trasformazione 3D interessata. L'interfaccia non può essere un'implementazione personalizzata; con questo metodo è possibile usare solo le interfacce create da Microsoft DirectComposition.

Il valore predefinito è 0.

Requisiti

Vedi anche

IDCompositionRotateTransform3D

IDCompositionRotateTransform3D::SetAxisX

IDCompositionRotateTransform3D::SetAxisY