Metodo LinearGradientBrush::SetWrapMode (gdiplusbrush.h)

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

Vedi anche

Pennelli e forme piene

Creazione di una sfumatura lineare

LinearGradientBrush

LinearGradientBrush::GetWrapMode

Rect

Affiancamento di una forma con un'immagine

Wrapmode