Método IDCompositionVisual::SetContent (dcomp.h)
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:
- Um objeto que implementa a interface IDCompositionSurface .
- Um objeto que implementa a interface IDXGISwapChain1 .
- Um objeto wrapper retornado pelo método CreateSurfaceFromHandle ou CreateSurfaceFromHwnd .
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
IDXGIFactory2::CreateSwapChain1