Método Graphics::SetCompositingMode (gdiplusgraphics.h)

Artículo
08/24/2023

El método Graphics::SetCompositingMode establece el modo de redacción de este objeto Graphics .

Sintaxis

Status SetCompositingMode(
  [in] CompositingMode compositingMode
);

Parámetros

[in] compositingMode

Tipo: CompositingMode

Elemento de la enumeración CompositingMode que especifica el modo de redacción.

Valor devuelto

Tipo: Estado

Si el método se realiza correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Comentarios

Supongamos que crea un objeto SolidBrush basado en un color que tiene un componente alfa de 192, que es aproximadamente el 75 por ciento del 255. Si el objeto Graphics tiene su modo de composición establecido en CompositingModeSourceOver, las áreas rellenas con el pincel sólido son una mezcla que es un color de pincel del 75 por ciento y un color de fondo del 25 por ciento. Si el objeto Graphics tiene su modo de composición establecido en CompositingModeSourceCopy, el color de fondo no se combina con el color del pincel. Sin embargo, el color representado por el pincel tiene una intensidad que es el 75 por ciento de lo que sería si el componente alfa fuera 255.

No puede usar CompositingModeSourceCopy junto con TextRenderingHintClearTypeGridFit.

Ejemplos

En el ejemplo siguiente se crea un objeto Graphics y se establece su modo de redacción en CompositingModeSourceOver. El código crea un objeto SolidBrush basado en un color que tiene un componente alfa de 128. El código pasa la dirección de ese pincel al método Graphics::FillRectangle del objeto Graphics para rellenar un rectángulo con un color que es una mezcla media y media del color del pincel y el color de fondo. A continuación, el código establece el modo de composición del objeto Graphics en CompositingModeSourceCopy y rellena un segundo rectángulo con el mismo pincel. En ese segundo rectángulo, el color del pincel no se combina con el color de fondo.

VOID Example_SetCompositingMode(HDC hdc)
{
   Graphics graphics(hdc);
   
   // Create a SolidBrush object with an alpha-blended color.
   SolidBrush alphaBrush(Color(180, 255, 0, 0));

   // Set the compositing mode to CompositingModeSourceOver,
   // and fill a rectangle.
   graphics.SetCompositingMode(CompositingModeSourceOver);
   graphics.FillRectangle(&alphaBrush, 0, 0, 100, 100);

   // Set the compositing mode to CompositingModeSourceCopy,
   // and fill a rectangle.
   graphics.SetCompositingMode(CompositingModeSourceCopy);
   graphics.FillRectangle(&alphaBrush, 100, 0, 100, 100);
}

Requisitos


Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplusgraphics.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll