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

Cria um novo objeto visual.

Sintaxe

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

Parâmetros

[out] visual

Tipo: IDCompositionVisual**

O novo objeto visual. Esse parâmetro não deve 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

Um novo objeto visual tem um valor estático de zero para as propriedades OffsetX e OffsetY e NULL para as propriedades Transformar, Clipe e Conteúdo. Inicialmente, o visual não faz com que o conteúdo de uma janela seja alterado. O visual deve ser adicionado como um filho de outro visual ou como a raiz de um destino de composição, antes que possa afetar a aparência de uma janela.

Exemplos

Para obter um exemplo, consulte Como criar uma árvore visual simples.

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

IDCompositionDevice

IDCompositionTarget::SetRoot

IDCompositionVisual::AddVisual