Metodo IDCompositionVisual::SetTransformParent (dcomp.h)

Imposta la proprietà TransformParent di questo oggetto visivo. La proprietà TransformParent stabilisce il sistema di coordinate rispetto al quale è composto questo oggetto visivo.

Sintassi

HRESULT SetTransformParent(
  [in, optional] IDCompositionVisual *visual
);

Parametri

[in, optional] visual

Tipo: IDCompositionVisual*

Nuovo oggetto visivo che stabilisce il sistema di coordinate di base per questo oggetto visivo. 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

Il sistema di coordinate di un oggetto visivo viene modificato dalle proprietà OffsetX, OffsetY e Transform. In genere, queste proprietà definiscono il sistema di coordinate di un oggetto visivo rispetto al padre immediato. Questo metodo specifica l'oggetto visivo relativo al quale si basa il sistema di coordinate per questo oggetto visivo. L'oggetto visivo specificato deve essere un predecessore dell'oggetto visivo corrente. Se non è un predecessore, il sistema di coordinate si basa sull'elemento padre immediato di questo oggetto visivo, come se la proprietà TransformParent fosse impostata su NULL. Poiché gli oggetti visivi possono essere replicati, questa proprietà può essere applicata nuovamente se l'oggetto visivo specificato diventa un predecessore dell'oggetto visivo di destinazione tramite un'operazione di ripetizione.

Se il parametro visivo è NULL, il sistema di coordinate viene sempre trasformato rispetto all'elemento padre immediato dell'oggetto visivo. Questo è il comportamento predefinito se questo metodo non viene usato.

Questo metodo ha esito negativo se il parametro visivo è un puntatore non valido o se non è stato creato dalla stessa interfaccia IDCompositionDevice di questo oggetto visivo. L'interfaccia non può essere un'implementazione personalizzata; con questo metodo è possibile usare solo le interfacce create da Microsoft DirectComposition.

Requisiti

Requisito	Valore
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

IDCompositionVisual