Image.SetPropertyItem(PropertyItem) Metoda

Definice

Obor názvů:

System.Drawing

Sestavení:

System.Drawing.Common.dll

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

Uložená PropertyItem .

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 a SetPropertyItem metody. Tento příklad je navržený tak, aby se používal s Windows Forms. Pokud chcete tento příklad spustit, vložte ho do formuláře a zpracujte událost formuláře Paint 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í, tato metoda vyvolá 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 ignoruje pokus, 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 načtením PropertyItems hodnoty vlastnosti nebo voláním GetPropertyItem metody Image , která již obsahuje položky vlastnosti. Potom můžete nastavit pole PropertyItem a předat je .SetPropertyItem