IDCompositionRectangleClip::SetTop(float)-Methode (dcomp.h)

Ändert den Wert der Top-Eigenschaft eines Cliprechtecks. Die Top-Eigenschaft gibt die y-Koordinate der oberen linken Ecke des Cliprechtecks an.

Syntax

HRESULT SetTop(
  [in] float top
);

Parameter

[in] top

Typ: float

Der neue Wert der Top-Eigenschaft in Pixeln. Dieser Parameter hat einen numerischen Grenzwert von -2^21 bis 2^21. Die API akzeptiert Zahlen außerhalb dieses Bereichs, aber sie werden immer in diesen Bereich eingespannt.

Rückgabewert

Typ: HRESULT

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

Hinweise

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

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

Anforderungen

Weitere Informationen

IDCompositionRectangleClip