Image.SetPropertyItem(PropertyItem) Метод

Определение

Пространство имен:

System.Drawing

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v8.0.0

Исходный код:

Image.cs

Сохраняет элемент свойства (часть метаданных) в 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)

Параметры

propitem

PropertyItem

PropertyItem для сохранения.

Исключения

ArgumentException

Формат этого изображения не поддерживает элементы свойств.

Примеры

В следующем примере кода показано, как использовать методы GetPropertyItem и SetPropertyItem . Этот пример предназначен для использования с Windows Forms. Чтобы выполнить этот пример, вставьте его в форму и обработайте событие формы Paint путем вызова DemonstratePropertyItem метода , передавая e как 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

Комментарии

Если формат изображения не поддерживает элементы свойств, этот метод выдает ArgumentException сообщение "Свойство не поддерживается". Если формат изображения поддерживает элементы свойств, но не поддерживает определенное свойство, которое вы пытаетесь задать, этот метод игнорирует попытку, но не создает исключение.

Трудно задать элементы свойств, так как класс не имеет открытых PropertyItem конструкторов. Один из способов обойти это ограничение — получить PropertyItemPropertyItems значение свойства или вызвать GetPropertyItem метод Image объекта , который уже содержит элементы свойств. Затем можно задать поля PropertyItem объекта и передать их в SetPropertyItem.