Metodo IDCompositionVisual::SetTransform(IDCompositionTransform*) (dcomp.h)

Articolo
08/23/2023

Imposta la proprietà Transform di questo oggetto visivo sull'oggetto trasformazione 2D specificato.

Sintassi

HRESULT SetTransform(
  [in, optional] IDCompositionTransform *transform
);

Parametri

[in, optional] transform

Tipo: IDCompositionTransform*

Oggetto di trasformazione utilizzato per modificare il sistema di coordinate di questo oggetto visivo. Questo parametro può puntare a un'interfaccia IDCompositionTransform o a una delle relative interfacce derivate. Questo parametro può 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

L'impostazione della proprietà Transform trasforma il sistema di coordinate dell'intero sottoalbero visivo radicato in questo oggetto visivo. Se viene specificata la proprietà Clip di questo oggetto visivo, viene trasformato anche il rettangolo di clip.

Se la proprietà Transform ha specificato in precedenza una matrice di trasformazione, l'oggetto trasformazione appena specificato sostituisce la matrice di trasformazione.

Una trasformazione specificata dalla proprietà Transform viene applicata dopo le proprietà OffsetX e OffsetY. In altre parole, l'effetto dell'impostazione della proprietà Transform e delle proprietà OffsetX e OffsetY è uguale all'impostazione solo della proprietà Transform in un gruppo di trasformazione in cui il primo membro del gruppo è un oggetto IDCompositionTranslateTranslateTransform con gli stessi valori OffsetX e OffsetY. Tuttavia, è consigliabile usare i metodi IDCompositionVisual::SetOffsetX e SetOffsetY ogni volta che sono leggermente più veloci.

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

Se il parametro di trasformazione è NULL, il sistema di coordinate di questo oggetto visivo viene trasformato solo dalle proprietà OffsetX e OffsetY. L'impostazione della proprietà Transform su NULL equivale a impostarla su un oggetto IDCompositionMatrixTransform in cui la matrice specificata è la matrice identity. Tuttavia, un'applicazione deve impostare la proprietà Transform su NULL ogni volta che è possibile perché è leggermente più veloce.

Se le proprietà OffsetX e OffsetY sono impostate su 0 e la proprietà Transform è impostata su NULL, il sistema di coordinate dell'oggetto visivo è uguale a quello del relativo padre.

Requisiti


Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	dcomp.h
Libreria	Dcomp.lib
DLL	Dcomp.dll