Compartilhar via


Método IDCompositionTarget::SetRoot (dcomp.h)

Define um objeto visual como o novo objeto raiz de uma árvore visual.

Sintaxe

HRESULT SetRoot(
  [in, optional] IDCompositionVisual *visual
);

Parâmetros

[in, optional] visual

Tipo: IDCompositionVisual*

O objeto visual que é a nova raiz dessa árvore 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

Um visual pode ser a raiz de uma única árvore visual ou um filho de outro visual, mas não pode ser ambos ao mesmo tempo. Esse método falhará se o parâmetro visual já for a raiz de outra árvore visual ou for filho de outro visual.

Se o visual for NULL, a árvore visual estará vazia. Se houver um visual raiz não NULL anterior, esse visual ficará disponível para uso como a raiz de outra árvore visual ou como um filho de outro visual.

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::CreateVisual

IDCompositionTarget