Freigeben über

Image.GetPropertyItem-Methode

  • Artikel

Ruft das angegebene Eigenschaftenelement aus diesem Image ab.

Namespace: System.Drawing
Assembly: System.Drawing (in system.drawing.dll)

Syntax

'Declaration
Public Function GetPropertyItem ( _
    propid As Integer _
) As PropertyItem
'Usage
Dim instance As Image
Dim propid As Integer
Dim returnValue As PropertyItem

returnValue = instance.GetPropertyItem(propid)

public PropertyItem GetPropertyItem (
    int propid
)

public:
PropertyItem^ GetPropertyItem (
    int propid
)

public PropertyItem GetPropertyItem (
    int propid
)

public function GetPropertyItem (
    propid : int
) : PropertyItem

Parameter

  • propid
    Die ID des abzurufenden Eigenschaftenelements.

Rückgabewert

Das von dieser Methode abgerufene PropertyItem.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentException

Das Bildformat dieses Bilds unterstützt keine Eigenschaftenelemente.

Hinweise

Das Festlegen von Eigenschaftenelementen ist schwierig, da die PropertyItem-Klasse keine öffentlichen Konstruktoren beinhaltet. Ein Verfahren zum Umgehen dieser Einschränkung besteht darin, ein PropertyItem durch Abrufen des PropertyItems-Eigenschaftenwerts oder Aufrufen der GetPropertyItem-Methode eines Image abzurufen, das bereits über Eigenschaftenelemente verfügt. Dann können Sie die Felder von PropertyItem festlegen und es an SetPropertyItem übergeben.

Beispiel

Im folgenden Codebeispiel wird die Verwendung der GetPropertyItem-Methode und der SetPropertyItem-Methode veranschaulicht. Dieses Beispiel ist für die Verwendung mit Windows Forms vorgesehen. Zum Ausführen dieses Beispiels fügen Sie es in ein Formular ein, und behandeln Sie das Paint-Ereignis des Formulars, indem Sie die DemonstratePropertyItem-Methode aufrufen, wobei Sie e als PaintEventArgs übergeben.

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

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 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.set_Id(20625);

    // Set the PropertyItem for image2.
    image2.SetPropertyItem(propItem);

    // Draw the image.
    e.get_Graphics().DrawImage(image2, 20, 20);
} //DemonstratePropertyItem

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Image-Klasse
Image-Member
System.Drawing-Namespace