Método IDCompositionVisual::SetBorderMode (dcomp.h)
Define a propriedade BorderMode, que especifica como compor as bordas de bitmaps e clipes associados a esse visual ou com visuais na subárvore com raiz neste visual.
Sintaxe
HRESULT SetBorderMode(
[in] DCOMPOSITION_BORDER_MODE borderMode
);
Parâmetros
[in] borderMode
Tipo: DCOMPOSITION_BORDER_MODE
O modo de borda a ser usado.
Valor retornado
Tipo: HRESULT
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
O modo de borda afeta como as bordas de um bitmap são compostas quando o bitmap é transformado de modo que as bordas não estejam exatamente alinhadas ao eixo e em limites precisos de pixel. Ele também afeta como o conteúdo é recortado nos cantos de um clipe que tem cantos arredondados e na borda de um clipe que é transformado de modo que as bordas não estejam exatamente alinhadas ao eixo e em limites precisos de pixel.
Por padrão, um visual herda o modo de borda de seu visual pai, que pode herdar o modo de borda de seu visual pai e assim por diante. Um visual usará o modo de borda padrão se esse método nunca for chamado para o visual ou se esse método for chamado com DCOMPOSITION_BORDER_MODE_INHERIT. Se nenhum visual definir o modo de borda, o padrão para toda a árvore visual será a renderização com alias, que oferece a menor qualidade visual, mas o desempenho mais alto.
Se o parâmetro borderMode não for DCOMPOSITION_BORDER_MODE_INHERIT, o bitmap e o clipe desse visual serão compostos com o modo de borda especificado. Além disso, esse modo de borda se torna o novo padrão para os filhos do visual atual. Ou seja, se o modo de borda dos filhos desse visual estiver inalterado ou explicitamente definido como DCOMPOSITION_BORDER_MODE_INHERIT, os bitmaps e clipes dos visuais filho serão compostos usando o modo de borda desse visual.
Requisitos
| 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 |