Image.SetPropertyItem(PropertyItem) Metode

Definisi

Ruang nama:

System.Drawing

Rakitan:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Sumber:

Image.cs

Menyimpan item properti (sepotong metadata) di dalam ini 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

yang PropertyItem akan disimpan.

Pengecualian

ArgumentException

Format gambar gambar ini tidak mendukung item properti.

Contoh

Contoh kode berikut menunjukkan cara menggunakan GetPropertyItem metode dan SetPropertyItem . Contoh ini dirancang untuk digunakan dengan Formulir Windows. Untuk menjalankan contoh ini, tempelkan ke dalam formulir, dan tangani peristiwa formulir Paint dengan memanggil DemonstratePropertyItem metode , meneruskannya e sebagai 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

Keterangan

Jika format gambar tidak mendukung item properti, metode ini melemparkan ArgumentException dengan pesan "Properti tidak didukung." Jika format gambar mendukung item properti tetapi tidak mendukung properti tertentu yang coba Anda atur, metode ini mengabaikan upaya tetapi tidak melemparkan pengecualian.

Sulit untuk mengatur item properti, karena PropertyItem kelas tidak memiliki konstruktor publik. Salah satu cara untuk mengatasi pembatasan ini adalah dengan mendapatkan PropertyItem dengan mengambil PropertyItems nilai properti atau memanggil GetPropertyItem metode Image yang sudah memiliki item properti. Kemudian Anda dapat mengatur bidang PropertyItem dan meneruskannya ke SetPropertyItem.