Image.SetPropertyItem(PropertyItem) Método

Definición

Espacio de nombres:

System.Drawing

Ensamblado:

System.Drawing.Common.dll

Paquete:

System.Drawing.Common v8.0.0

Source:

Image.cs

Almacena un elemento de propiedad (fragmento de metadatos) en 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

PropertyItem que se va a almacenar.

Excepciones

ArgumentException

El formato de imagen de esta imagen no admite elementos de propiedad.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar los GetPropertyItem métodos y SetPropertyItem . Este ejemplo está diseñado para usarse con Windows Forms. Para ejecutar este ejemplo, péguelo en un formulario y controle el evento del Paint formulario llamando al DemonstratePropertyItem método , pasando 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

Comentarios

Si el formato de imagen no admite elementos de propiedad, este método inicia ArgumentException con el mensaje "Propiedad no admitida". Si el formato de imagen admite elementos de propiedad, pero no admite la propiedad concreta que está intentando establecer, este método omite el intento, pero no produce una excepción.

Es difícil establecer elementos de propiedad, ya que la PropertyItem clase no tiene constructores públicos. Una manera de solucionar esta restricción es obtener un PropertyItem mediante la recuperación del valor de propiedad PropertyItems o la llamada al GetPropertyItem método de un Image objeto que ya tiene elementos de propiedad. A continuación, puede establecer los campos de PropertyItem y pasarlos a SetPropertyItem.