IDCompositionVisual::SetTransformParent-Methode (dcomp.h)

Legt die TransformParent-Eigenschaft dieses Visuals fest. Die TransformParent-Eigenschaft legt das Koordinatensystem relativ fest, zu dem dieses Visual zusammengesetzt ist.

Syntax

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

Parameter

[in, optional] visual

Typ: IDCompositionVisual*

Das neue Visual, das das Basiskoordinatensystem für dieses Visual festlegt. Dieser Parameter kann NULL sein.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben. Eine Liste der Fehlercodes finden Sie unter DirectComposition-Fehlercodes .

Hinweise

Das Koordinatensystem eines Visuals wird durch die Eigenschaften OffsetX, OffsetY und Transform geändert. Normalerweise definieren diese Eigenschaften das Koordinatensystem eines Visuals relativ zum unmittelbaren übergeordneten Element. Diese Methode gibt das Visuelle relativ an, auf dem das Koordinatensystem für dieses Visual basiert. Das angegebene Visual muss ein Vorgänger des aktuellen Visuals sein. Wenn es sich nicht um einen Vorgänger handelt, basiert das Koordinatensystem auf dem unmittelbar übergeordneten Element dieses Visuals, so als wäre die TransformParent-Eigenschaft auf NULL festgelegt. Da Visuals reparented werden können, kann diese Eigenschaft erneut wirksam werden, wenn das angegebene Visual durch einen Reparenting-Vorgang zum Vorgänger des Zielvisuals wird.

Wenn der visuelle Parameter NULL ist, wird das Koordinatensystem immer relativ zum unmittelbaren übergeordneten Element des Visuals transformiert. Dies ist das Standardverhalten, wenn diese Methode nicht verwendet wird.

Diese Methode schlägt fehl, wenn der visuelle Parameter ein ungültiger Zeiger ist oder nicht von derselben IDCompositionDevice-Schnittstelle wie dieses Visual erstellt wurde. Die Schnittstelle darf keine benutzerdefinierte Implementierung sein. Mit dieser Methode können nur schnittstellen verwendet werden, die von Microsoft DirectComposition erstellt wurden.

Anforderungen

Weitere Informationen

IDCompositionVisual