Image.SetPropertyItem(PropertyItem) Metoda

Definice

Obor názvů:

System.Drawing

Sestavení:

System.Drawing.Common.dll

Balíček:

System.Drawing.Common v8.0.0

Zdroj:

Image.cs

Ukládá položku vlastnosti (část metadat) v tomto Imagesouboru .

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)

Parametry

propitem

PropertyItem

Hodnota PropertyItem , která se má uložit.

Výjimky

ArgumentException

Formát obrázku tohoto obrázku nepodporuje položky vlastností.

Příklady

Následující příklad kódu ukazuje, jak používat GetPropertyItem metody a SetPropertyItem . Tento příklad je navržený pro použití s model Windows Forms. Pokud chcete spustit tento příklad, vložte ho do formuláře a opracujte Paint událost formuláře voláním DemonstratePropertyItem metody a předáním e jako 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

Poznámky

Pokud formát obrázku nepodporuje položky vlastností, vyvolá tato metoda ArgumentException zprávu "Vlastnost není podporována". Pokud formát obrázku podporuje položky vlastností, ale nepodporuje konkrétní vlastnost, kterou se pokoušíte nastavit, tato metoda tento pokus ignoruje, ale nevyvolá výjimku.

Je obtížné nastavit položky vlastností, protože PropertyItem třída nemá žádné veřejné konstruktory. Jedním ze způsobů, jak toto omezení obejít, je získat PropertyItem hodnotu vlastnosti načtením PropertyItems hodnoty vlastnosti nebo voláním GetPropertyItem metody Image , která již obsahuje položky vlastností. Potom můžete nastavit pole a předat ho PropertyItem do SetPropertyItem.