Método IDCompositionTarget::SetRoot (dcomp.h)
Establece un objeto visual como el nuevo objeto raíz de un árbol visual.
Sintaxis
HRESULT SetRoot(
[in, optional] IDCompositionVisual *visual
);
Parámetros
[in, optional] visual
Tipo: IDCompositionVisual*
Objeto visual que es la nueva raíz de este árbol visual. Este parámetro puede ser NULL.
Valor devuelto
Tipo: HRESULT
Si la función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT. Consulte Códigos de error de DirectComposition para obtener una lista de códigos de error.
Comentarios
Un objeto visual puede ser la raíz de un único árbol visual o un elemento secundario de otro objeto visual, pero no puede ser ambos al mismo tiempo. Este método produce un error si el parámetro visual ya es la raíz de otro árbol visual o es un elemento secundario de otro objeto visual.
Si el objeto visual es NULL, el árbol visual está vacío. Si había un objeto visual raíz no NULL anterior, ese objeto visual estará disponible para su uso como raíz de otro árbol visual o como elemento secundario de otro objeto visual.
Ejemplos
Para obtener un ejemplo, vea How to Build a Simple Visual Tree.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2012 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | dcomp.h |
| Library | Dcomp.lib |
| Archivo DLL | Dcomp.dll |