UpsPct.IImage.Coller

Procedure Optimiser(NulAbsorbant) Coller(Destination : Nul Ou IImage, MDestination : Nul Ou MasqueDessin, Mode : ModeCopie=CopieSansTransparent, PourcentMixage : Entier=0);

Procedure Optimiser(NulAbsorbant) Coller(Destination : Nul Ou ContexteGraphique, MDestination : Nul Ou MasqueDessin);

Description

La méthode Coller permet de coller la partie bitmap de l'image courante décalquée au travers du masque de dessin par MDestination dans l'image destination Destination qui peut être une image ou un contexte graphique.

Si MDestination est Nul, alors tout le bitmap de l'image courante est collé.

Le mode de collage s'effectue selon le mode Mode. En cas de mixage, le pourcentage est donné par le paramètre PourcentMixage. Pour plus de précisions, merci de se référer à la fiche ModeCopie.

Si la destination est une image, la taille de l'image courante doit être exactement la taille de la zone collée i.e. du masque de dessin MDestination. Si la destination est un contexte graphique, alors cela permet de réaliser une collage d'écran.

En cas d'erreur, l'exception OperationImageImpossible est envoyée.

Exemple

Principal
/*******/
Variable
/******/

Debut
...
I1.Coller(I2, MasqueDessin(Rectangle(0,0, 200, 100)));
/* Colle une partie de l'image. */
...
I1.Coller(I2, Nul, ModeCopieAdditionner);
/* Colle toute l'image en additionnant les couleurs. */
...
Fin Principal

Avertissement

Si Destination n'est pas une image alors la copie est rectangulaire même si le masque MDestination n'est pas un rectangle.

Voir aussi

Copier pour copier l'image.

Traduction

---------