Método PathGradientBrush::SetWrapMode (gdipluspath.h)

Artículo
02/29/2024

El método PathGradientBrush::SetWrapMode establece el modo de ajuste de este pincel de degradado de ruta de acceso.

Sintaxis

Status SetWrapMode(
  [in] WrapMode wrapMode
);

Parámetros

[in] wrapMode

Tipo: WrapMode

Elemento de la enumeración WrapMode que especifica cómo se mosaicon las áreas pintadas con el pincel degradado de ruta de acceso. El valor predeterminado es WrapModeClamp.

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

El rectángulo delimitador de un pincel de degradado de ruta de acceso es el rectángulo más pequeño que incluye la ruta de acceso de límite del pincel. Al pintar el rectángulo delimitador con el pincel degradado de trazado, solo se rellena el área dentro de la ruta de acceso del límite. El área dentro del rectángulo delimitador, pero fuera de la ruta de acceso del límite no se rellena.

WrapModeClamp (modo de ajuste predeterminado) indica que no se produce ninguna pintura fuera del rectángulo delimitador del pincel. Todos los demás modos de ajuste indican que las áreas fuera del rectángulo delimitador del pincel se mostrarán en mosaico. Cada icono es una copia (posiblemente volteada) de la ruta de acceso rellenada dentro de su rectángulo delimitador.

Ejemplos

En el ejemplo siguiente se crea un objeto PathGradientBrush basado en una ruta triangular. El código llama al método PathGradientBrush::SetWrapMode del objeto PathGradientBrush para establecer el modo de ajuste del pincel en WrapModeTileFlipX. El método Graphics::FillRectangle usa el pincel degradado de ruta para mosaicor un área grande.

La salida del código es una cuadrícula de iconos. A medida que se mueve de un icono a otro de una fila determinada, la imagen (ruta de acceso de límite rellenada dentro del rectángulo delimitador) se voltea horizontalmente.

VOID Example_SetWrapMode(HDC hdc)
{
   Graphics graphics(hdc);

   Point points[] = {
      Point(0, 0), 
      Point(100, 0), 
      Point(100, 100)};

   Color colors[] = {
      Color(255, 255, 0, 0),   // red
      Color(255, 0, 0, 255),   // blue
      Color(255, 0, 255, 0)};  // green

   INT count = 3;

   PathGradientBrush pthGrBrush(points, 3);
   pthGrBrush.SetSurroundColors(colors, &count);
   pthGrBrush.SetWrapMode(WrapModeTileFlipX);

   graphics.FillRectangle(&pthGrBrush, 0, 0, 800, 800); 
}

Requisitos

Requisito	Value
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	gdipluspath.h (incluya Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll