IDCompositionTarget::SetRoot-Methode (dcomp.h)
Legt ein visuelles Objekt als neues Stammobjekt einer visuellen Struktur fest.
Syntax
HRESULT SetRoot(
[in, optional] IDCompositionVisual *visual
);
Parameter
[in, optional] visual
Typ: IDCompositionVisual*
Das visuelle Objekt, das der neue Stamm dieser visuellen Struktur ist. Dieser Parameter kann NULL sein.
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
Ein Visual kann entweder der Stamm einer einzelnen visuellen Struktur oder ein untergeordnetes Element eines anderen Visuals sein, aber es kann nicht beides gleichzeitig sein. Diese Methode schlägt fehl, wenn der visuelle Parameter bereits der Stamm einer anderen visuellen Struktur oder ein untergeordnetes Element eines anderen Visuals ist.
Wenn visual NULL ist, ist die visuelle Struktur leer. Wenn ein vorheriges Nicht-NULL-Stammvisual vorhanden war, wird dieses Visual zur Verwendung als Stamm einer anderen visuellen Struktur oder als untergeordnetes Element eines anderen Visuals verfügbar.
Beispiele
Ein Beispiel finden Sie unter Erstellen einer einfachen visuellen Struktur.
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 |