Share via

Método IDCompositionTarget::SetRoot (dcomp.h)

  • Artículo

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

Consulte también

IDCompositionDevice::CreateVisual

IDCompositionTarget