Image.SetPropertyItem(PropertyItem) Método

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v8.0.0

Origem:

Image.cs

Armazena um item de propriedade (parte de metadados) neste 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)

Parâmetros

propitem

PropertyItem

O PropertyItem a ser armazenado.

Exceções

ArgumentException

O formato de imagem dessa imagem não dá suporte a itens de propriedade.

Exemplos

O exemplo de código a seguir demonstra como usar os GetPropertyItem métodos e SetPropertyItem . Este exemplo foi projetado para ser usado com Windows Forms. Para executar este exemplo, cole-o em um formulário e manipule o evento do Paint formulário chamando o DemonstratePropertyItem método , passando e como 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

Comentários

Se o formato de imagem não der suporte a itens de propriedade, esse método gerará ArgumentException com a mensagem "Propriedade sem suporte". Se o formato de imagem der suporte a itens de propriedade, mas não der suporte à propriedade específica que você está tentando definir, esse método ignorará a tentativa, mas não gerará uma exceção.

É difícil definir itens de propriedade, porque a PropertyItem classe não tem construtores públicos. Uma maneira de contornar essa restrição é obter um PropertyItem recuperando o valor da PropertyItems propriedade ou chamando o GetPropertyItem método de um Image que já tem itens de propriedade. Em seguida, você pode definir os campos do PropertyItem e passá-lo para SetPropertyItem.