Metodo PathGradientBrush::SetWrapMode (gdipluspath.h)

Articolo
08/24/2023

Il metodo PathGradientBrush::SetWrapMode imposta la modalità di wrapping del pennello sfumatura del percorso.

Sintassi

Status SetWrapMode(
  [in] WrapMode wrapMode
);

Parametri

[in] wrapMode

Tipo: WrappingMode

Elemento dell'enumerazione WrappingMode che specifica come verranno riquadri le aree dipinte con il pennello sfumatura del percorso. Il valore predefinito è WrappingModeClamp.

Valore restituito

Tipo: Stato

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

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

Commenti

Il rettangolo di delimitazione di un pennello sfumatura percorso è il rettangolo più piccolo che racchiude il percorso limite del pennello. Quando si disegna il rettangolo di delimitazione con il pennello sfumatura del percorso, viene riempita solo l'area all'interno del percorso limite. L'area all'interno del rettangolo di selezione, ma all'esterno del percorso limite non viene riempita.

WrappingModeClamp (modalità di wrapping predefinita) indica che nessun dipinto si verifica all'esterno del rettangolo di delimitamento del pennello. Tutte le altre modalità di wrapping indicano che le aree esterne al rettangolo di delimitamento del pennello verranno riquadri. Ogni riquadro è una copia (possibilmente capovolta) del percorso riempito all'interno del rettangolo di delimitamento.

Esempio

Nell'esempio seguente viene creato un oggetto PathGradientBrush basato su un percorso triangolare. Il codice chiama il metodo PathGradientBrush::SetWrapMode dell'oggetto PathGradientBrush per impostare la modalità di wrapping del pennello su WrappingModeTileFlipX. Il metodo Graphics::FillRectangle usa il pennello sfumatura del percorso per riquadriare un'area di grandi dimensioni.

L'output del codice è una griglia di riquadri. Quando si passa da un riquadro all'altro in una determinata riga, l'immagine (percorso limite riempito all'interno del rettangolo di selezione) viene capovolta orizzontalmente.

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

Requisiti

Requisito	Valore
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	gdipluspath.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll