IDCompositionVisual2::SetBackFaceVisibility-Methode (dcomp.h)
Gibt an, ob Oberflächen, auf die 3D-Transformationen angewendet werden, angezeigt werden sollen, wenn sie dem Betrachter abgewandt sind.
Syntax
HRESULT SetBackFaceVisibility(
DCOMPOSITION_BACKFACE_VISIBILITY visibility
);
Parameter
visibility
[in]
Die Sichtbarkeit der Rückseite, die beim Komponieren von Oberflächen in der Unterstruktur dieses Visuals zum Bildschirm verwendet werden soll.
Rückgabewert
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 Sichtbarkeitseigenschaft für die Rückseite wirkt sich darauf aus, wie Oberflächen mit angewendeten 3D-Transformationen gerendert werden.
Standardmäßig erbt ein Visual die Sichtbarkeitseigenschaft für das hintere Gesicht des übergeordneten Visuals, das möglicherweise die Sichtbarkeitseigenschaft für die Rückseite des übergeordneten Visuals erbt usw. Ein Visual verwendet den DCOMPOSITION_BACKFACE_VISIBILITY_VISIBLE-Modus, wenn diese Methode nie für das Visual aufgerufen wird oder wenn diese Methode mit DCOMPOSITION_BACKFACE_VISIBILITY_INHERIT aufgerufen wird. Wenn keine Visuals die Sichtbarkeitseigenschaft für die Rückseite festlegen, ist der Standardwert für die gesamte visuelle Struktur DCOMPOSITION_BACKFACE_VISIBILITY_VISIBLE.
Wenn der Sichtbarkeitsparameter etwas anderes als DCOMPOSITION_BACKFACE_VISIBILITY_INHERIT ist, werden die Oberflächen dieses Visuals mit dem angegebenen Sichtbarkeitsmodus zusammengesetzt. Darüber hinaus wird dieser Sichtbarkeitsmodus zum neuen Standard für die untergeordneten Elemente des aktuellen Visuals. Das heißt, wenn der Sichtbarkeitsmodus der untergeordneten Elemente dieses Visuals unverändert oder explizit auf DCOMPOSITION_BACKFACE_VISIBILITY_INHERIT festgelegt ist, werden die Oberflächen der untergeordneten Visuals im Sichtbarkeitsmodus dieses Visuals zusammengesetzt.
Anforderungen
| 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 |
Weitere Informationen
DirectComposition Backface und D2D Batching