Método LinearGradientBrush::SetWrapMode (gdiplusbrush.h)

Artículo
08/23/2023

El método LinearGradientBrush::SetWrapMode establece el modo de ajuste de este pincel de degradado lineal.

Sintaxis

Status SetWrapMode(
  [in] WrapMode wrapMode
);

Parámetros

[in] wrapMode

Tipo: WrapMode

Elemento de la enumeración WrapMode que especifica cómo se mosaicorán las áreas pintadas con este pincel de degradado lineal. El valor de este parámetro debe ser uno de los siguientes elementos:

WrapModeTile
WrapModeTileFlipX
WrapModeTileFlipY
WrapModeTileFlipXY

Valor devuelto

Tipo: Estado

Si el método se ejecuta 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

Las líneas de límite de un pincel de degradado lineal forman un icono. Al pintar un área con un pincel degradado lineal, el icono se repite. Un pincel de degradado lineal puede tener mosaicos alternativos volteados en una dirección determinada, según lo especificado por el modo de ajuste. Voltear tiene el efecto de revertir el orden de los colores.

El modo de ajuste tiene como valor predeterminado WrapModeTile cuando se construye un objeto LinearGradientBrush .

Ejemplos

En el ejemplo siguiente se crea un pincel de degradado lineal y se usa para rellenar un rectángulo. A continuación, el código modifica el modo de ajuste del pincel y usa el pincel modificado para rellenar otro rectángulo.

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

   LinearGradientBrush linGrBrush( 
      Rect(0, 0, 100, 50),
      Color(255, 255, 0, 0),  // red
      Color(255, 0, 0, 255),  // blue
      LinearGradientModeHorizontal);

   // Fill a large area using the gradient brush with the default wrap mode.
   myGraphics.FillRectangle(&linGrBrush, 0, 0, 800, 50);

   linGrBrush.SetWrapMode(WrapModeTileFlipX);

   // Fill a large area using the gradient brush with the new wrap mode.
   myGraphics.FillRectangle(&linGrBrush, 0, 75, 800, 50);
}

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