Cette documentation est archivée et n’est pas conservée.

Graphics.DrawImage, méthode (Image, PointF[], RectangleF, GraphicsUnit)

Dessine la partie mentionnée du Image spécifié à l'emplacement indiqué avec la taille précisée.

Espace de noms : System.Drawing
Assembly : System.Drawing (dans system.drawing.dll)

public void DrawImage (
	Image image,
	PointF[] destPoints,
	RectangleF srcRect,
	GraphicsUnit srcUnit
)
public void DrawImage (
	Image image, 
	PointF[] destPoints, 
	RectangleF srcRect, 
	GraphicsUnit srcUnit
)
public function DrawImage (
	image : Image, 
	destPoints : PointF[], 
	srcRect : RectangleF, 
	srcUnit : GraphicsUnit
)

Paramètres

image

Image à dessiner.

destPoints

Tableau de trois structures PointF qui définissent un parallélogramme.

srcRect

Structure RectangleF qui spécifie la partie de l'objet image à dessiner.

srcUnit

Membre de l'énumération GraphicsUnit qui spécifie les unités de mesure utilisées par le paramètre srcRect.

Type d'exceptionCondition

ArgumentNullException

image a la valeur référence Null (Nothing en Visual Basic).

Le paramètre destPoints spécifie trois points d'un parallélogramme. Les trois structures PointF représentent les angles supérieur gauche, supérieur droit et inférieur gauche du parallélogramme. Le quatrième point est extrapolé à partir des trois premiers pour former un parallélogramme.

Le paramètre srcRect spécifie une partie rectangulaire de l'objet image à dessiner. Cette partie est ajustée et inclinée de manière à tenir à l'intérieur du parallélogramme spécifié par le paramètre destPoints.

L'exemple de code suivant est destiné à être utilisé avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre du gestionnaire d'événements Paint. Le code exécute les actions suivantes :

  • Crée une image à partir d'un fichier JPEG, SampImag.jpg, dans le dossier de l'exemple.

  • Crée des points qui définissent un parallélogramme de destination dans lequel dessiner l'image.

  • Crée un rectangle source à partir duquel extraire une partie de l'image.

  • Définit le pixel comme unité de mesure du rectangle source.

  • Dessine l'image à l'écran.

La position du parallélogramme de destination situe l'image à l'écran, tandis que la taille du rectangle source et la taille et la forme du parallélogramme de destination déterminent la mise à l'échelle et l'inclinaison de l'image dessinée et la taille du rectangle détermine la partie de l'image d'origine dessinée à l'écran.

public void DrawImageParaFRectF(PaintEventArgs e)
{
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create parallelogram for drawing image.
    PointF ulCorner = new PointF(100.0F, 100.0F);
    PointF urCorner = new PointF(550.0F, 100.0F);
    PointF llCorner = new PointF(150.0F, 250.0F);
    PointF[] destPara = {ulCorner, urCorner, llCorner};
             
    // Create rectangle for source image.
    RectangleF srcRect = new RectangleF(50.0F, 50.0F, 150.0F, 150.0F);
    GraphicsUnit units = GraphicsUnit.Pixel;
             
    // Draw image to screen.
    e.Graphics.DrawImage(newImage, destPara, srcRect, units);
}

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0
Afficher: