Image.SetPropertyItem(PropertyItem) Metoda

Definicja

Przestrzeń nazw:

System.Drawing

Zestaw:

System.Drawing.Common.dll

Pakiet:

System.Drawing.Common v8.0.0

Źródło:

Image.cs

Przechowuje element właściwości (część metadanych) w tym obiekcie 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)

Parametry

propitem

PropertyItem

Element PropertyItem do przechowywania.

Wyjątki

ArgumentException

Format obrazu tego obrazu nie obsługuje elementów właściwości.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać GetPropertyItem metod i SetPropertyItem . Ten przykład jest przeznaczony do użycia z Windows Forms. Aby uruchomić ten przykład, wklej go w formularzu i obsłuż zdarzenie formularza Paint , wywołując metodę DemonstratePropertyItem , przekazując 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

Uwagi

Jeśli format obrazu nie obsługuje elementów właściwości, ta metoda zgłasza ArgumentException komunikat "Właściwość nie jest obsługiwana". Jeśli format obrazu obsługuje elementy właściwości, ale nie obsługuje określonej właściwości, którą próbujesz ustawić, ta metoda ignoruje próbę, ale nie zgłasza wyjątku.

Trudno jest ustawić elementy właściwości, ponieważ PropertyItem klasa nie ma publicznych konstruktorów. Jednym ze sposobów obejścia tego ograniczenia jest uzyskanie PropertyItem wartości właściwości przez pobranie PropertyItems wartości właściwości lub wywołanie GetPropertyItem metody Image , która ma już elementy właściwości. Następnie możesz ustawić pola elementu PropertyItem i przekazać je do SetPropertyItemelementu .