Método IDCompositionVisual::SetBorderMode (dcomp.h)

Establece la propiedad BorderMode, que especifica cómo componer los bordes de los mapas de bits y los clips asociados a este objeto visual, o con objetos visuales en el subárbol rooteado en este objeto visual.

Sintaxis

HRESULT SetBorderMode(
  [in] DCOMPOSITION_BORDER_MODE borderMode
);

Parámetros

[in] borderMode

Tipo: DCOMPOSITION_BORDER_MODE

Modo de borde que se va a usar.

Valor devuelto

Tipo: HRESULT

Si la función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT. Consulte Códigos de error de DirectComposition para obtener una lista de códigos de error.

Comentarios

El modo de borde afecta a cómo se componen los bordes de un mapa de bits cuando el mapa de bits se transforma de modo que los bordes no estén exactamente alineados con el eje y en límites de píxeles precisos. También afecta a cómo se recorta el contenido en las esquinas de un clip que tiene esquinas redondeadas y en el borde de un clip que se transforma de modo que los bordes no estén alineados exactamente con el eje y en límites de píxeles precisos.

De forma predeterminada, un objeto visual hereda el modo de borde de su objeto visual primario, que puede heredar el modo de borde de su objeto visual primario, etc. Un objeto visual usa el modo de borde predeterminado si nunca se llama a este método para el objeto visual o si se llama a este método con DCOMPOSITION_BORDER_MODE_INHERIT. Si ningún objeto visual establece el modo de borde, el valor predeterminado para todo el árbol visual se aplica alias a la representación, lo que ofrece la calidad visual más baja, pero el rendimiento más alto.

Si el parámetro borderMode es distinto de DCOMPOSITION_BORDER_MODE_INHERIT, el mapa de bits y el clip de este objeto visual se componen con el modo de borde especificado. Además, este modo de borde se convierte en el nuevo valor predeterminado para los elementos secundarios del objeto visual actual. Es decir, si el modo de borde de los elementos secundarios de este objeto visual no cambia o se establece explícitamente en DCOMPOSITION_BORDER_MODE_INHERIT, los mapas de bits y los clips de los objetos visuales secundarios se componen mediante el modo de borde de este objeto visual.

Requisitos

Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	dcomp.h
Library	Dcomp.lib
Archivo DLL	Dcomp.dll

Consulte también

IDCompositionVisual