Compartilhar via


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