Metodo TextureBrush::TextureBrush(Image*,WrapMode,constRect&) (gdiplusbrush.h)
Crea un oggetto TextureBrush basato su un'immagine, una modalità di wrapping e un rettangolo di definizione.
Sintassi
void TextureBrush(
[in] Image *image,
[in] WrapMode wrapMode,
[in, ref] const Rect & dstRect
);
Parametri
[in] image
Tipo: Immagine*
Puntatore a un oggetto Image che contiene la bitmap dell'immagine da usare.
[in] wrapMode
Tipo: WrapMode
Elemento dell'enumerazione WrapMode che specifica la modalità di utilizzo delle copie ripetute di un'immagine per affiancare un'area quando viene disegnata con questo pennello di trama.
[in, ref] dstRect
Tipo: const Rect
Riferimento a un rettangolo che definisce le dimensioni di questo pennello trama e la parte dell'immagine da usare con questo pennello di trama. Se l'oggetto Image viene creato da un metafile, il pennello usa l'intera immagine, ridimensionata per adattarsi alle dimensioni del pennello.
Valore restituito
nessuno
Osservazioni
La larghezza e l'altezza di un pennello di trama sono definite dalla larghezza e dall'altezza del rettangolo dstRect . Un pennello di trama è sempre orientato a (0, 0). Il punto superiore sinistro, la larghezza e l'altezza del rettangolo specificano il punto iniziale, la larghezza e l'altezza della parte dell'immagine da usare da un pennello di trama.
Come questo costruttore usa il rettangolo dstRect con immagini nonmetafile
Se le dimensioni del rettangolo dstRect sono inferiori a quelle dell'immagine su cui si basa il pennello, l'immagine del pennello viene ritagliata, ovvero è una parte dell'immagine. Se le dimensioni del rettangolo dstRect sono uguali a quelle dell'immagine, l'immagine del pennello è identica all'immagine. Il rettangolo dstRect non deve includere aree esterne alle dimensioni dell'immagine. In questo modo verrà generato un comportamento imprevedibile o verrà generato un errore di run-time. Si supponga, ad esempio, di avere un'immagine di 256 ×256 pixel e di creare un oggetto TextureBrush basato su questa immagine, passando come parametro dstRect . Il pennello userà la parte inferiore sinistra dell'immagine. L'angolo inferiore sinistro di questa parte è anche l'angolo inferiore sinistro dell'immagine. Si supponga ora di creare un altro oggetto TextureBrush basato sulla stessa immagine, passando come parametro dstRect . Si noti che questo rettangolo ha la coordinata più alta a 157 anziché a 156. Questo rettangolo estende un'unità oltre l'altezza dell'immagine e genererà probabilmente una violazione di accesso.Come questo costruttore usa il rettangolo dstRect con immagini metafile
Se le dimensioni del rettangolo dstRect sono diverse da quelle dell'immagine, l'immagine del pennello viene ridimensionata più piccola o più grande in base alle esigenze per adattare il rettangolo. Si supponga, ad esempio, di avere un'immagine metafile di 256 ×256 pixel e di creare un oggetto TextureBrush , passando come parametro dstRect . L'immagine del pennello includerà tutte le immagini del metafile, ma verrà ridimensionata per adattarsi al pennello: verrà schiacciata verticalmente e allungata orizzontalmente. Se le dimensioni del rettangolo sono uguali a quelle dell'immagine, l'immagine del pennello è identica all'immagine.Modalità di utilizzo della modalità di wrapping di questo costruttore
Un'area che si estende oltre i limiti del pennello viene affiancata con copie ripetute del pennello. Un pennello trama può avere riquadri alternativi capovolti in una determinata direzione, come specificato dalla modalità di ritorno a capo. Il capovolgimento ha l'effetto di invertire l'immagine del pennello.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 |