Metodo LinearGradientBrush::SetWrapMode (gdiplusbrush.h)

Articolo
08/23/2023

Il metodo LinearGradientBrush::SetWrapMode imposta la modalità di wrapping di questo pennello sfumatura lineare.

Sintassi

Status SetWrapMode(
  [in] WrapMode wrapMode
);

Parametri

[in] wrapMode

Tipo: WrapMode

Elemento dell'enumerazione WrapMode che specifica come verranno affiancate le aree disegnate con questo pennello sfumato lineare. Il valore di questo parametro deve essere uno degli elementi seguenti:

WrapModeTile
WrapModeTileFlipX
WrapModeTileFlipY
WrapModeTileFlipXY

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce Ok, che è un elemento dell'enumerazione Status .

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .

Commenti

Le linee limite di un pennello sfumato lineare formano un riquadro. Quando si disegna un'area con un pennello sfumato lineare, il riquadro si ripete. Un pennello sfumato lineare può avere riquadri alternativi capovolti in una determinata direzione, come specificato dalla modalità di ritorno a capo. Capovolgimento ha l'effetto di invertire l'ordine dei colori.

Per impostazione predefinita, la modalità di wrapping è WrapModeTile quando viene costruito un oggetto LinearGradientBrush .

Esempio

L'esempio seguente crea un pennello sfumato lineare e lo usa per riempire un rettangolo. Successivamente, il codice modifica la modalità di wrapping del pennello e usa il pennello modificato per riempire un altro rettangolo.

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);
}

Requisiti


Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdiplusbrush.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll