Image.SetPropertyItem(PropertyItem) Méthode

Définition

Espace de noms:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v8.0.0

Source:

Image.cs

Stocke un élément de propriété (métadonnées) dans cet objet Image.

public:
 void SetPropertyItem(System::Drawing::Imaging::PropertyItem ^ propitem);

public void SetPropertyItem (System.Drawing.Imaging.PropertyItem propitem);

member this.SetPropertyItem : System.Drawing.Imaging.PropertyItem -> unit

Public Sub SetPropertyItem (propitem As PropertyItem)

Paramètres

propitem

PropertyItem

PropertyItem à stocker.

Exceptions

ArgumentException

Le format d’image de cette image ne prend pas en charge les éléments de propriété.

Exemples

L’exemple de code suivant montre comment utiliser le GetPropertyItem et SetPropertyItem méthodes. Cet exemple est conçu pour être utilisé avec Windows Forms. Pour exécuter cet exemple, collez-le dans un formulaire et gérez l’événement du Paint formulaire en appelant la DemonstratePropertyItem méthode, en passant e comme PaintEventArgs.

private:
   void DemonstratePropertyItem( PaintEventArgs^ e )
   {
      // Create two images.
      Image^ image1 = Image::FromFile( "c:\\FakePhoto1.jpg" );
      Image^ image2 = Image::FromFile( "c:\\FakePhoto2.jpg" );

      // Get a PropertyItem from image1.
      PropertyItem^ propItem = image1->GetPropertyItem( 20624 );

      // Change the ID of the PropertyItem.
      propItem->Id = 20625;

      // Set the PropertyItem for image2.
      image2->SetPropertyItem( propItem );

      // Draw the image.
      e->Graphics->DrawImage( image2, 20.0F, 20.0F );
   }

private void DemonstratePropertyItem(PaintEventArgs e)
{

    // Create two images.
    Image image1 = Image.FromFile("c:\\FakePhoto1.jpg");
    Image image2 = Image.FromFile("c:\\FakePhoto2.jpg");

    // Get a PropertyItem from image1.
    PropertyItem propItem = image1.GetPropertyItem(20624);

    // Change the ID of the PropertyItem.
    propItem.Id = 20625;

    // Set the PropertyItem for image2.
    image2.SetPropertyItem(propItem);

    // Draw the image.
    e.Graphics.DrawImage(image2, 20.0F, 20.0F);
}

Private Sub DemonstratePropertyItem(ByVal e As PaintEventArgs)

    ' Create two images.
    Dim image1 As Image = Image.FromFile("c:\FakePhoto1.jpg")
    Dim image2 As Image = Image.FromFile("c:\FakePhoto2.jpg")

    ' Get a PropertyItem from image1.
    Dim propItem As PropertyItem = image1.GetPropertyItem(20624)

    ' Change the ID of the PropertyItem.
    propItem.Id = 20625

    ' Set the PropertyItem for image2.
    image2.SetPropertyItem(propItem)

    ' Draw the image.
    e.Graphics.DrawImage(image2, 20.0F, 20.0F)
End Sub

Remarques

Si le format d’image ne prend pas en charge les éléments de propriété, cette méthode lève ArgumentException le message « Propriété non prise en charge ». Si le format d’image prend en charge les éléments de propriété mais ne prend pas en charge la propriété particulière que vous tentez de définir, cette méthode ignore la tentative, mais ne lève pas d’exception.

Il est difficile de définir des éléments de propriété, car la PropertyItem classe n’a aucun constructeur public. Une façon de contourner cette restriction consiste à obtenir un PropertyItem en récupérant la valeur de propriété PropertyItems ou en appelant la GetPropertyItem méthode d’un Image qui contient déjà des éléments de propriété. Vous pouvez ensuite définir les champs du et le PropertyItem passer à SetPropertyItem.