Image.SetPropertyItem(PropertyItem) Methode

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Quelle:

Image.cs

Speichert ein Eigenschaftenelement (Metadaten) in diesem 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)

Parameter

propitem

PropertyItem

Das zu speichernde PropertyItem.

Ausnahmen

ArgumentException

Das Bildformat dieses Bilds unterstützt nicht die Eigenschaftselemente.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der GetPropertyItem Methoden und SetPropertyItem veranschaulicht. Dieses Beispiel ist für die Verwendung mit Windows Forms konzipiert. Um dieses Beispiel auszuführen, fügen Sie es in ein Formular ein, und behandeln Sie das Ereignis des FormularsPaint, indem Sie die DemonstratePropertyItem -Methode aufrufen und als PaintEventArgsübergebene.

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

Hinweise

Wenn das Bildformat keine Eigenschaftselemente ArgumentException unterstützt, wird diese Methode mit der Meldung "Eigenschaft nicht unterstützt" ausgelöst. Wenn das Bildformat Eigenschaftenelemente unterstützt, aber nicht die bestimmte Eigenschaft, die Sie festlegen möchten, unterstützt, ignoriert diese Methode den Versuch, löst jedoch keine Ausnahme aus.

Es ist schwierig, Eigenschaftselemente festzulegen, da die PropertyItem Klasse keine öffentlichen Konstruktoren aufweist. Eine Möglichkeit, diese Einschränkung zu umgehen, besteht darin, einen PropertyItem zu erhalten, indem sie den PropertyItems Eigenschaftswert abrufen oder die -Methode einer Image aufrufen, die GetPropertyItem bereits Über Eigenschaftenelemente verfügt. Anschließend können Sie die Felder von PropertyItem festlegen und an SetPropertyItemübergeben.