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