Image.SetPropertyItem(PropertyItem) Metodo

Definizione

Spazio dei nomi:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v8.0.0

Origine:

Image.cs

Archivia un elemento di proprietà (porzione di metadati) in questo oggetto 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)

Parametri

propitem

PropertyItem

Oggetto PropertyItem da archiviare.

Eccezioni

ArgumentException

Il formato di questa immagine non supporta elementi di proprietà.

Esempio

Nell'esempio di codice seguente viene illustrato come usare i GetPropertyItem metodi e SetPropertyItem . Questo esempio è progettato per essere usato con Windows Forms. Per eseguire questo esempio, incollarlo in un modulo e gestire l'evento del Paint modulo chiamando il DemonstratePropertyItem metodo , passando e come 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

Commenti

Se il formato dell'immagine non supporta gli elementi della proprietà, questo metodo genera ArgumentException il messaggio "Proprietà non supportata". Se il formato dell'immagine supporta gli elementi della proprietà ma non supporta la proprietà specifica che si sta tentando di impostare, questo metodo ignora il tentativo ma non genera un'eccezione.

È difficile impostare gli elementi di proprietà, perché la PropertyItem classe non dispone di costruttori pubblici. Un modo per aggirare questa restrizione consiste nel ottenere un PropertyItem oggetto recuperando il valore della PropertyItems proprietà o chiamando il GetPropertyItem metodo di un oggetto Image che dispone già di elementi di proprietà. È quindi possibile impostare i campi dell'oggetto PropertyItem e passarlo a SetPropertyItem.