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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | dcomp.h |
| Bibliothek | Dcomp.lib |
| DLL | Dcomp.dll |