Image.SetPropertyItem(PropertyItem) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Armazena um item de propriedade (metadado) 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 que deve ser guardado.
Exceções
O formato de imagem desta imagem não suporta itens de propriedade.
Exemplos
O seguinte exemplo de código demonstra como usar os GetPropertyItem métodos e.SetPropertyItem Este exemplo foi concebido para ser usado com Windows Forms. Para executar este exemplo, cole-o num formulário e trata o evento do Paint formulário chamando o DemonstratePropertyItem método, passando e por .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
Observações
Se o formato da imagem não suportar itens de propriedade, este método apresenta ArgumentException a mensagem "Propriedade não suportada." Se o formato da imagem suportar elementos de propriedade mas não suportar a propriedade específica que está a tentar definir, este método ignora a tentativa mas não lança exceção.
É difícil definir itens de propriedade, porque a PropertyItem classe não tem construtores públicos. Uma forma de contornar esta restrição é obter a PropertyItem recuperando o valor da PropertyItems propriedade ou chamando o GetPropertyItem método de um Image que já tem itens de propriedade. Depois podes definir os campos de e PropertyItem passar para SetPropertyItem.