Metodo IDCompositionVisual3::SetTransform(IDCompositionTransform3D*) (dcomp.h)
Imposta la proprietà Transform di questo oggetto visivo sull'oggetto transform 3D specificato.
Sintassi
HRESULT SetTransform(
[in, optional] IDCompositionTransform3D *transform
);
Parametri
[in, optional] transform
Tipo: IDCompositionTransform3D*
Oggetto transform 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 ritaglio.
Se la proprietà Transform ha specificato in precedenza una matrice di trasformazione, l'oggetto transform 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 equivale 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 quando possibile perché 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; con questo metodo è possibile usare solo le interfacce create da Microsoft DirectComposition.
Se il parametro transform è 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 di identità. Tuttavia, un'applicazione deve impostare la proprietà Transform su NULL quando 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 corrisponde 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 |
Vedi anche
IDCompositionTranslateTransform