Metodo IDCompositionTarget::SetRoot (dcomp.h)

Imposta un oggetto visivo come nuovo oggetto radice di un albero visivo.

Sintassi

HRESULT SetRoot(
  [in, optional] IDCompositionVisual *visual
);

Parametri

[in, optional] visual

Tipo: IDCompositionVisual*

Oggetto visivo che rappresenta la nuova radice di questo albero visivo. Questo parametro può essere NULL.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT . Per un elenco di codici di errore, vedere Codici di errore DirectComposition .

Commenti

Un oggetto visivo può essere la radice di un singolo albero visivo o un elemento figlio di un altro oggetto visivo, ma non può essere entrambi allo stesso tempo. Questo metodo ha esito negativo se il parametro visivo è già la radice di un altro albero visivo o è figlio di un altro oggetto visivo.

Se l'oggetto visivo è NULL, l'albero visivo è vuoto. Se è presente un oggetto visivo radice non NULL precedente, tale oggetto visivo diventa disponibile per l'uso come radice di un altro albero visivo o come figlio di un altro oggetto visivo.

Esempio

Per un esempio, vedere Come creare un albero visivo semplice.

Requisiti

Vedi anche

IDCompositionDevice::CreateVisual

IDCompositionTarget