IDCompositionVisual::SetOffsetX(float)-Methode (dcomp.h)

Ändert den Wert der OffsetX-Eigenschaft dieses Visuals. Die OffsetX-Eigenschaft gibt den neuen Offset des Visuals entlang der x-Achse relativ zum übergeordneten Visual an.

Syntax

HRESULT SetOffsetX(
  [in] float offsetX
);

Parameter

[in] offsetX

Typ: float

Der neue Offset des Visuals entlang der x-Achse in Pixel.

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

Diese Methode schlägt fehl, wenn der offsetX-Parameter NaN, positive Unendlichkeit oder negative Unendlichkeit ist.

Wenn Sie die OffsetX-Eigenschaft eines Visuals ändern, wird das Koordinatensystem der gesamten visuellen Unterstruktur transformiert, die in diesem Visual verwurzelt ist. Wenn die Clip-Eigenschaft dieses Visuals angegeben wird, wird auch das Cliprechteck transformiert.

Eine Transformation, die von der Transform-Eigenschaft angegeben wird, wird nach der OffsetX-Eigenschaft angewendet. Anders ausgedrückt: Die Auswirkung des Festlegens der Transform-Eigenschaft und der OffsetX-Eigenschaft ist identisch mit dem Festlegen nur der Transform-Eigenschaft für ein Transformationsgruppenobjekt, bei dem das erste Mitglied der Gruppe ein IDCompositionTranslateTransform-Objekt ist, das denselben OffsetX-Wert wie offsetX aufweist. Sie sollten jedoch IDCompositionVisual::SetOffsetX wann immer möglich verwenden, da es etwas schneller ist.

Wenn die Eigenschaften OffsetX und OffsetY auf 0 festgelegt sind und die Transform-Eigenschaft auf NULL festgelegt ist, ist das Koordinatensystem des Visuals mit dem des übergeordneten Elements identisch.

Wenn die OffsetX-Eigenschaft zuvor animiert wurde, entfernt diese Methode die Animation und legt die Eigenschaft auf den angegebenen statischen Wert fest.

Beispiele

Ein Beispiel finden Sie unter Erstellen einer einfachen visuellen Struktur.

Anforderungen

Weitere Informationen

IDCompositionVisual

IDCompositionVisual::SetOffsetY

IDCompositionVisual::SetTransform