Image.SetPropertyItem(PropertyItem) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Stocke un élément de propriété (métadonnées) dans cet objet 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)
Paramètres
- propitem
- PropertyItem
PropertyItem à stocker.
Exceptions
Le format d’image de cette image ne prend pas en charge les éléments de propriété.
Exemples
L’exemple de code suivant montre comment utiliser le GetPropertyItem et SetPropertyItem méthodes. Cet exemple est conçu pour être utilisé avec Windows Forms. Pour exécuter cet exemple, collez-le dans un formulaire et gérez l’événement du Paint formulaire en appelant la DemonstratePropertyItem
méthode , en passant e
comme 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
Remarques
Si le format d’image ne prend pas en charge les éléments de propriété, cette méthode lève ArgumentException le message « Propriété non prise en charge ». Si le format d’image prend en charge les éléments de propriété, mais ne prend pas en charge la propriété particulière que vous tentez de définir, cette méthode ignore la tentative, mais ne lève pas d’exception.
Il est difficile de définir des éléments de propriété, car la PropertyItem classe n’a aucun constructeur public. Une façon de contourner cette restriction consiste à obtenir un PropertyItem en récupérant la valeur de propriété PropertyItems ou en appelant la GetPropertyItem méthode d’un Image qui contient déjà des éléments de propriété. Vous pouvez ensuite définir les champs du et le PropertyItem passer à SetPropertyItem.