Image.SetPropertyItem-Methode

Speichert ein Eigenschaftenelement (Metadaten) in diesem Image.

Namespace: System.Drawing
Assembly: System.Drawing (in system.drawing.dll)

Syntax

'Declaration
Public Sub SetPropertyItem ( _
    propitem As PropertyItem _
)
'Usage
Dim instance As Image
Dim propitem As PropertyItem

instance.SetPropertyItem(propitem)

public void SetPropertyItem (
    PropertyItem propitem
)

public:
void SetPropertyItem (
    PropertyItem^ propitem
)

public void SetPropertyItem (
    PropertyItem propitem
)

public function SetPropertyItem (
    propitem : PropertyItem
)

Parameter

• propitem
  Das zu speichernde PropertyItem.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	Das Bildformat dieses Bilds unterstützt keine Eigenschaftenelemente.

Hinweise

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

Das Festlegen von Eigenschaftenelementen ist schwierig, da die PropertyItem-Klasse keine öffentlichen Konstruktoren beinhaltet. Ein Verfahren zum Umgehen dieser Einschränkung besteht darin, ein PropertyItem durch Abrufen des PropertyItems-Eigenschaftenwerts oder Aufrufen der GetPropertyItem-Methode eines Image abzurufen, das bereits über Eigenschaftenelemente verfügt. Dann können Sie die Felder des PropertyItem festlegen und dieses an SetPropertyItem übergeben.

Beispiel

Im folgenden Codebeispiel wird die Verwendung der GetPropertyItem-Methode und der SetPropertyItem-Methode veranschaulicht. Dieses Beispiel ist für die Verwendung mit Windows Forms vorgesehen. Zum Ausführen dieses Beispiels fügen Sie es in ein Formular ein, und behandeln Sie das Paint-Ereignis des Formulars, indem Sie die DemonstratePropertyItem-Methode aufrufen, wobei Sie e als PaintEventArgs übergeben.

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

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 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.set_Id(20625);

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

    // Draw the image.
    e.get_Graphics().DrawImage(image2, 20, 20);
} //DemonstratePropertyItem

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Image-Klasse
Image-Member
System.Drawing-Namespace