Compartilhar via


Método IDCompositionVisual2::SetBackFaceVisibility (dcomp.h)

Especifica se as superfícies que têm ou não transformações 3D aplicadas a elas devem ser exibidas quando voltadas para longe do observador.

Sintaxe

HRESULT SetBackFaceVisibility(
  DCOMPOSITION_BACKFACE_VISIBILITY visibility
);

Parâmetros

visibility

[in]

A visibilidade da face traseira a ser usada ao redigir superfícies na subárvore desse visual para a tela.

Valor retornado

Se a função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT. Confira Códigos de erro do DirectComposition para obter uma lista de códigos de erro.

Comentários

A propriedade de visibilidade da face traseira afeta como as superfícies que têm transformações 3D aplicadas são renderizadas.

Por padrão, um visual herda a propriedade de visibilidade da face traseira de seu visual pai, que pode herdar a propriedade de visibilidade do rosto traseiro de seu visual pai e assim por diante. Um visual usará o modo DCOMPOSITION_BACKFACE_VISIBILITY_VISIBLE se esse método nunca for chamado para o visual ou se esse método for chamado com DCOMPOSITION_BACKFACE_VISIBILITY_INHERIT. Se nenhum visual definir a propriedade de visibilidade da face traseira, o padrão para toda a árvore visual será DCOMPOSITION_BACKFACE_VISIBILITY_VISIBLE.

Se o parâmetro de visibilidade for algo diferente de DCOMPOSITION_BACKFACE_VISIBILITY_INHERIT, as superfícies desse visual serão compostas com o modo de visibilidade especificado. Além disso, esse modo de visibilidade se torna o novo padrão para os filhos do visual atual. Ou seja, se o modo de visibilidade dos filhos desse visual estiver inalterado ou explicitamente definido como DCOMPOSITION_BACKFACE_VISIBILITY_INHERIT, as superfícies dos visuais filho serão compostas usando o modo de visibilidade desse visual.

Requisitos

   
Cliente mínimo com suporte Windows 8.1 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho dcomp.h
Biblioteca Dcomp.lib
DLL Dcomp.dll

Confira também

Backface directComposition e envio em lote D2D

IDCompositionEffectGroup::SetTransform3D

IDCompositionVisual2