Método IDCompositionVisual::SetContent (dcomp.h)

  • Artículo

Establece la propiedad Content de este objeto visual en el contenedor de ventanas o mapa de bits especificado.

Sintaxis

HRESULT SetContent(
  [in, optional] IUnknown *content
);

Parámetros

[in, optional] content

Tipo: IUnknown*

Objeto que es el nuevo contenido de este objeto visual. Este parámetro puede ser NULL.

Valor devuelto

Tipo: HRESULT

Si la función se ejecuta 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

El parámetro content debe apuntar a una de las siguientes opciones:

El nuevo contenido reemplaza cualquier contenido asociado anteriormente al objeto visual. Si el parámetro de contenido es NULL, el objeto visual no tiene contenido asociado.

Un objeto visual se puede asociar a un objeto de mapa de bits o a un contenedor de ventanas. Un mapa de bits es una cadena de intercambio de Microsoft DirectX o una superficie de Microsoft DirectComposition.

Se crea un contenedor de ventanas con el método CreateSurfaceFromHwnd y es un elemento independiente para la rasterización de otra ventana, que debe ser una ventana de nivel superior o una ventana secundaria superpuesta. Un contenedor de ventanas es conceptualmente equivalente a un mapa de bits que es el tamaño de la ventana de destino en la que se dibuja el contenido de la ventana. El contenido incluye las ventanas secundarias de la ventana de destino (superpuestas o de otro modo) y cualquier contenido de DirectComposition dibujado en las ventanas secundarias.

Se crea un contenedor de superficie DirectComposition con el método CreateSurfaceFromHandle y es una referencia a una cadena de intercambio. Una aplicación puede usar un contenedor de superficie en un escenario entre procesos en el que un proceso crea la cadena de intercambio y otro proceso asocia el mapa de bits a un objeto visual.

El mapa de bits siempre se dibuja en la posición (0,0) en relación con el sistema de coordenadas del objeto visual, aunque el sistema de coordenadas se ve afectado directamente por las propiedades OffsetX, OffsetY y Transform, así como indirectamente por las transformaciones en los objetos visuales antecesor. El mapa de bits de un objeto visual siempre se dibuja detrás de los elementos secundarios de ese objeto visual.

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

IDCompositionVisual

IDXGIFactory2::CreateSwapChain1