IDCompositionEffectGroup::SetOpacity(float)-Methode (dcomp.h)

Ändert den Wert der Deckkrafteigenschaft.

Syntax

HRESULT SetOpacity(
  [in] float opacity
);

Parameter

[in] opacity

Typ: float

Der neue Wert der Deckkrafteigenschaft.

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

Die Deckkraft wird als vollständig transparent für alle Werte interpretiert, die kleiner oder gleich 0 sind, und als vollständig undurchsichtig für alle Werte, die größer als oder gleich 1 sind. Alle Werte zwischen 0 und 1 stellen eine partielle Deckkraft dar.

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

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

Anforderungen

Weitere Informationen

IDCompositionEffectGroup