Compartilhar via

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

  • Artigo

Define a propriedade Content desse visual como o wrapper de janela ou bitmap especificado.

Sintaxe

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

Parâmetros

[in, optional] content

Tipo: IUnknown*

O objeto que é o novo conteúdo desse visual. Este parâmetro pode ser NULL.

Retornar valor

Tipo: HRESULT

Se a função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT. Consulte Códigos de Erro do DirectComposition para obter uma lista de códigos de erro.

Comentários

O parâmetro de conteúdo deve apontar para um dos seguintes:

O novo conteúdo substitui qualquer conteúdo que tenha sido associado anteriormente ao visual. Se o parâmetro de conteúdo for NULL, o visual não terá conteúdo associado.

Um visual pode ser associado a um objeto bitmap ou um wrapper de janela. Um bitmap é uma cadeia de troca do Microsoft DirectX ou uma superfície do Microsoft DirectComposition.

Um wrapper de janela é criado com o método CreateSurfaceFromHwnd e é um stand-in para a rasterização de outra janela, que deve ser uma janela de nível superior ou uma janela filho em camadas. Um wrapper de janela é conceitualmente equivalente a um bitmap que é o tamanho da janela de destino na qual o conteúdo da janela é desenhado. O conteúdo inclui as janelas filho da janela de destino (em camadas ou não) e qualquer conteúdo DirectComposition desenhado nas janelas filho.

Um wrapper de superfície DirectComposition é criado com o método CreateSurfaceFromHandle e é uma referência a uma cadeia de troca. Um aplicativo pode usar um wrapper de superfície em um cenário entre processos em que um processo cria a cadeia de troca e outro processo associa o bitmap a um visual.

O bitmap é sempre desenhado na posição (0,0) em relação ao sistema de coordenadas do visual, embora o sistema de coordenadas seja diretamente afetado pelas propriedades OffsetX, OffsetY e Transform, bem como indiretamente pelas transformações em visuais ancestrais. O bitmap de um visual é sempre desenhado atrás dos filhos desse visual.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho dcomp.h
Biblioteca Dcomp.lib
DLL Dcomp.dll

Confira também

IDCompositionVisual

IDXGIFactory2::CreateSwapChain1