Compartir a través de


Método IDCompositionDevice::CreateVisual (dcomp.h)

Crea un nuevo objeto visual.

Sintaxis

HRESULT CreateVisual(
  [out] IDCompositionVisual **visual
);

Parámetros

[out] visual

Tipo: IDCompositionVisual**

Nuevo objeto visual. Este parámetro no debe 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 nuevo objeto visual tiene un valor estático de cero para las propiedades OffsetX y OffsetY, y NULL para las propiedades Transform, Clip y Content. Inicialmente, el objeto visual no hace que el contenido de una ventana cambie. El objeto visual se debe agregar como elemento secundario de otro objeto visual, o como raíz de un destino de composición, antes de que pueda afectar a la apariencia de una ventana.

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

IDCompositionTarget::SetRoot

IDCompositionVisual::AddVisual