Metodo TextureBrush::SetWrapMode (gdiplusbrush.h)

Articolo
08/24/2023

Il metodo TextureBrush::SetWrapMode imposta la modalità di wrapping di questo pennello di trama.

Sintassi

Status SetWrapMode(
  [in] WrapMode wrapMode
);

Parametri

[in] wrapMode

Tipo: WrappingMode

Elemento dell'enumerazione WrappingMode che specifica come vengono usate copie ripetute di un'immagine per riquadrire un'area quando viene dipinta con questo pennello di trama.

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

Un'area che si estende oltre i limiti del pennello viene riquadrizzato con copie ripetute del pennello. Un pennello di trama può avere riquadri alternativi capovolti in una determinata direzione, come specificato dalla modalità di wrapping. Il capovolgimento ha l'effetto di ripristinare l'immagine del pennello. Ad esempio, se la modalità di wrapping viene specificata come WrappingModeTileFlipX, il pennello viene capovolto su una linea parallela all'asse y.

Il pennello di trama è sempre orientato a (0, 0). Se la modalità di wrapping viene specificata come WrappingModeClamp, nessuna area esterna al pennello viene riquadri. Si supponga, ad esempio, di creare un pennello di trama, specificando WrappingModeClamp come modalità di wrapping:

TextureBrush(&SomeImage, WrapModeClamp)

Disegnare quindi un'area con il pennello. Se le dimensioni del pennello hanno un'altezza di 50 e l'area dipinta è un rettangolo con l'angolo superiore sinistro (0, 50), non vedrai copie ripetute del pennello (nessuna tiglia).

La modalità di wrapping predefinita per un pennello di trama è WrappingModeTile, che specifica nessun capovolgimento del riquadro e nessun blocco.

Esempio

Nell'esempio seguente viene creato un pennello di trama, viene impostata la modalità di wrapping del pennello e viene usato il pennello per riempire un rettangolo.

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

   Image image(L"HouseAndTree.gif");
   TextureBrush textureBrush(&image);
   textureBrush.SetWrapMode(WrapModeTileFlipX);
   graphics.FillRectangle(&textureBrush, 0, 0, 400, 200);
}

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