Image.SetPropertyItem(PropertyItem) Méthode

Définition

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

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 formulaire Paint 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 une exception ArgumentException avec 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 pas de constructeurs publics. L’une des façons de contourner cette restriction consiste à obtenir un PropertyItem en extrayant la PropertyItems valeur de la propriété ou en appelant la GetPropertyItem méthode d’un Image qui a déjà des éléments de propriété. Vous pouvez ensuite définir les champs du PropertyItem et le passer à SetPropertyItem .

S’applique à