Graphics.FromImage(Image) Méthode

Référence

Définition

Espace de noms:: System.Drawing

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

Paquet:: System.Drawing.Common v6.0.0

Paquet:: System.Drawing.Common v7.0.0

Paquet:: System.Drawing.Common v8.0.0

Paquet:: System.Drawing.Common v9.0.0-preview.2.24128.3

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Crée un Graphics à partir du Image spécifié.

public:
 static System::Drawing::Graphics ^ FromImage(System::Drawing::Image ^ image);

public static System.Drawing.Graphics FromImage (System.Drawing.Image image);

static member FromImage : System.Drawing.Image -> System.Drawing.Graphics

Public Shared Function FromImage (image As Image) As Graphics

Paramètres

image: Image

Image à partir duquel créer le Graphics.

Retours

Graphics

Cette méthode retourne un nouveau Graphics pour le Image spécifié.

Exceptions

ArgumentNullException

image a la valeur null.

Exception

image a un format de pixel indexé ou son format n'est pas défini.

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre du Paint gestionnaire d’événements. Le code effectue l’action suivante :

Crée un à Image partir d’un fichier graphique SampImag.jpg dans l’exemple de dossier.
Crée un à Graphics partir de .Image
Modifie l’image en remplissant un rectangle à l’intérieur de celle-ci.
Dessine le Image vers l’écran.
Libère le créé Graphics.

public:
   void FromImageImage( PaintEventArgs^ e )
   {
      // Create image.
      Image^ imageFile = Image::FromFile( "SampImag.jpg" );

      // Create graphics object for alteration.
      Graphics^ newGraphics = Graphics::FromImage( imageFile );

      // Alter image.
      newGraphics->FillRectangle( gcnew SolidBrush( Color::Black ), 100, 50, 100, 100 );

      // Draw image to screen.
      e->Graphics->DrawImage( imageFile, PointF(0.0F,0.0F) );

      // Dispose of graphics object.
      delete newGraphics;
   }

private void FromImageImage(PaintEventArgs e)
{

    // Create image.
    Image imageFile = Image.FromFile("SampImag.jpg");

    // Create graphics object for alteration.
    Graphics newGraphics = Graphics.FromImage(imageFile);

    // Alter image.
    newGraphics.FillRectangle(new SolidBrush(Color.Black), 100, 50, 100, 100);

    // Draw image to screen.
    e.Graphics.DrawImage(imageFile, new PointF(0.0F, 0.0F));

    // Dispose of graphics object.
    newGraphics.Dispose();
}

Private Sub FromImageImage2(ByVal e As PaintEventArgs)

    ' Create image.
    Dim imageFile As Image = Image.FromFile("SampImag.jpg")

    ' Create graphics object for alteration.
    Dim newGraphics As Graphics = Graphics.FromImage(imageFile)

    ' Alter image.
    newGraphics.FillRectangle(New SolidBrush(Color.Black), _
    100, 50, 100, 100)

    ' Draw image to screen.
    e.Graphics.DrawImage(imageFile, New PointF(0.0F, 0.0F))

    ' Dispose of graphics object.
    newGraphics.Dispose()
End Sub

Remarques

Si l’image a un format de pixel indexé, cette méthode lève une exception avec le message « Un objet Graphics ne peut pas être créé à partir d’une image qui a un format de pixel indexé ». Les formats de pixels indexés sont affichés dans la liste suivante.

Vous pouvez enregistrer l’image indexée dans un autre format à l’aide de la Save(String, ImageFormat) méthode , puis récupérer un Graphics objet pour la nouvelle image.

Cette méthode lève également une exception si l’image a l’un des formats de pixels suivants.

Vous devez toujours appeler la Dispose méthode pour libérer les Graphics ressources et associées créées par la FromImage méthode .

S’applique à