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 |