IDCompositionVisual2::SetOpacityMode-Methode (dcomp.h)
Legt den Deckkraftmodus für dieses Visual fest.
Syntax
HRESULT SetOpacityMode(
[in] DCOMPOSITION_OPACITY_MODE mode
);
Parameter
[in] mode
Der Deckkraftmodus, der beim Komponieren des Visuals auf dem Bildschirm verwendet werden soll.
Rückgabewert
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
Der Deckkraftmodus beeinflusst, wie sich die Deckkrafteigenschaft eines Effektgruppenobjekts auf die Zusammensetzung einer visuellen Unterstruktur auswirkt. DirectComposition unterstützt zwei Deckkraftmodi: Layer und Multiply. Im Ebenenmodus kann jede visuelle Unterstruktur logisch als Bitmap angezeigt werden, die die undurchsichtige Rasterung der gesamten Teilstruktur enthält, auf die dann der Deckkraftwert angewendet wird. Auf diese Weise fügen sich überlappende undurchsichtige Oberflächen mit dem Hintergrund der Unterstruktur zusammen, aber nicht miteinander. Im Gegensatz dazu wird im Multiplikationsmodus die Deckkraft einzeln auf jede Oberfläche angewendet, während sie zusammengesetzt ist, sodass Oberflächen miteinander verschmelzen. Der Multiplikationsmodus ist schneller als der Ebenenmodus und wird immer bevorzugt, wenn die visuelle Struktur vollständig nicht überlappende Inhalte enthält. Der Multiplikationsmodus kann jedoch unerwünschte visuelle Ergebnisse für überlappende Elemente erzeugen.
Standardmäßig erbt ein Visual den Deckkraftmodus seines übergeordneten Visuals, das den Deckkraftmodus des übergeordneten Visuals erben kann usw. Ein Visual verwendet den DCOMPOSITION_OPACITY_MODE_LAYER-Modus, wenn diese Methode nie für das Visual aufgerufen wird oder wenn diese Methode mit DCOMPOSITION_OPACITY_MODE_INHERIT aufgerufen wird. Wenn keine Visuals den Deckkraftmodus festlegen, ist die Standardeinstellung für die gesamte visuelle Struktur DCOMPOSITION_OPACITY_MODE_LAYER.
Wenn der opacityMode-Parameter etwas anderes als DCOMPOSITION_OPACITY_MODE_INHERIT ist, werden die Oberflächen dieses Visuals mit dem angegebenen Deckkraftmodus zusammengesetzt. Darüber hinaus wird dieser Deckkraftmodus zur neuen Standardeinstellung für die untergeordneten Elemente des aktuellen Visuals. Das heißt, wenn der Deckkraftmodus der untergeordneten Elemente dieses Visuals unverändert oder explizit auf DCOMPOSITION_OPACITY_MODE_INHERIT festgelegt ist, werden die Oberflächen, die die untergeordneten Visuals bilden, mithilfe des Deckkraftmodus dieses Visuals zusammengesetzt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8.1 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | dcomp.h |
| Bibliothek | Dcomp.lib |
| DLL | Dcomp.dll |