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

Artículo
08/24/2023

El método PathGradientBrush::GetWrapMode obtiene el modo de ajuste establecido actualmente para este pincel de degradado de ruta de acceso.

Sintaxis

WrapMode GetWrapMode();

Valor devuelto

Tipo: WrapMode

Este método devuelve un elemento de la enumeración WrapMode que indica el modo de ajuste establecido actualmente para este pincel de degradado de ruta de acceso.

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.

El modo de ajuste predeterminado para un pincel de degradado de trazado es WrapModeClamp, que 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 en WrapModeTileFlipX. A continuación, el código llama al método PathGradientBrush::GetWrapMode del objeto PathGradientBrush para obtener el modo de ajuste del pincel. Si el modo de ajuste obtenido es WrapModeTileFlipX, el código llama a FillRectangle para mosaico un área grande con el pincel degradado de ruta de acceso.

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

   // Create a path gradient brush based on an array of points,
   // and set its wrap mode.
   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);

   // Obtain information about the path gradient brush.
   WrapMode wrapMode; 
   wrapMode = pthGrBrush.GetWrapMode();

   if(wrapMode == WrapModeTileFlipX)
         graphics.FillRectangle(&pthGrBrush, 0, 0, 800, 800);
}

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