PropertyItem クラス

.NET Framework クラス ライブラリ リファレンス

PropertyItem クラス

メタデータ プロパティがイメージ ファイルに含まれるようにカプセル化します。継承はできません。

名前空間: System.Drawing.Imaging
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 PropertyItem

Visual Basic (使用法)

Dim instance As PropertyItem

C#

public sealed class PropertyItem

C++

public ref class PropertyItem sealed

J#

public final class PropertyItem

JScript

public final class PropertyItem

解説

このデータは、識別子、プロパティの長さ (バイト単位)、プロパティの型、およびプロパティ値へのポインタで構成されます。

使用例

PropertyItem クラスと Image.PropertyItems プロパティを使用して、イメージ ファイル内のメタデータの読み取りと表示を行う方法を次のコード例に示します。

この例は、System.Drawing.Imaging 名前空間をインポートする Windows フォームでの使用を意図してデザインされています。コードをフォームに貼り付け、システムのイメージ ファイルを指すように fakePhoto.jpg へのパスを変更します。フォームの Paint イベントを処理する際に ExtractMetaData メソッドを呼び出し、e を PaintEventArgs として渡します。

Visual Basic

Private Sub ExtractMetaData(ByVal
 e As PaintEventArgs)

    Try
        'Create an Image object. 
        Dim theImage As Image = New
 Bitmap("c:\fakePhoto.jpg")

        'Get the PropertyItems property from image.
        Dim propItems As PropertyItem() = theImage.PropertyItems

        'Set up the display.
        Dim font As New
 font("Arial", 10)
        Dim blackBrush As New
 SolidBrush(Color.Black)
        Dim X As Integer
 = 0
        Dim Y As Integer
 = 0

        'For each PropertyItem in the array, display the id, type, and
 length.
        Dim count As Integer
 = 0
        Dim propItem As PropertyItem
        For Each propItem In
 propItems

            e.Graphics.DrawString("Property Item "
 + count.ToString(), _
               font, blackBrush, X, Y)
            Y += font.Height

            e.Graphics.DrawString("   iD: 0x" &
 propItem.Id.ToString("x"), _
               font, blackBrush, X, Y)
            Y += font.Height

            e.Graphics.DrawString("   type: " &
 propItem.Type.ToString(), _
               font, blackBrush, X, Y)
            Y += font.Height

            e.Graphics.DrawString("   length: " &
 propItem.Len.ToString() & _
                " bytes", font, blackBrush, X, Y)
            Y += font.Height

            count += 1
        Next propItem

        font.Dispose()
    Catch ex As ArgumentException
        MessageBox.Show("There was an error. Make sure the path
 to the image file is valid.")
    End Try

End Sub

C#

private void ExtractMetaData(PaintEventArgs
 e)
{
    try
    {
        // Create an Image object. 
        Image theImage = new Bitmap("c:\\fakePhoto.jpg");

        // Get the PropertyItems property from image.
        PropertyItem[] propItems = theImage.PropertyItems;

        // Set up the display.
        Font font1 = new Font("Arial", 10);
        SolidBrush blackBrush = new SolidBrush(Color.Black);
        int X = 0;
        int Y = 0;

        // For each PropertyItem in the array, display the id, 
        // type, and length.
        int count = 0;
        foreach ( PropertyItem propItem in
 propItems )
        {
            e.Graphics.DrawString("Property Item " + 
                count.ToString(), font1, blackBrush, X, Y);
            Y += font1.Height;

            e.Graphics.DrawString("   ID: 0x" + 
                propItem.Id.ToString("x"), font1, blackBrush, X, Y);
            Y += font1.Height;

            e.Graphics.DrawString("   type: " +
                propItem.Type.ToString(), font1, blackBrush, X, Y);
            Y += font1.Height;

            e.Graphics.DrawString("   length: " + 
                propItem.Len.ToString() + 
                " bytes", font1, blackBrush, X, Y);
            Y += font1.Height;
            count += 1;
        }
        font1.Dispose();
    }
    catch(Exception)
    {
        MessageBox.Show("There was an error." + 
            "Make sure the path to the image file is valid.");
    }

}

C++

private:
   void ExtractMetaData( PaintEventArgs^ e )
   {
      try
      {
         
         // Create an Image object. 
         Image^ theImage = gcnew Bitmap( "c:\\fakePhoto.jpg" );
         
         // Get the PropertyItems property from image.
         array<PropertyItem^>^propItems = theImage->PropertyItems;
         
         // Set up the display.
         System::Drawing::Font^ font1 = gcnew System::Drawing::Font( "Arial",10
 );
         SolidBrush^ blackBrush = gcnew SolidBrush( Color::Black );
         int X = 0;
         int Y = 0;
         
         // For each PropertyItem in the array, display the id, 
         // type, and length.
         int count = 0;
         System::Collections::IEnumerator^ myEnum = propItems->GetEnumerator();
         while ( myEnum->MoveNext() )
         {
            PropertyItem^ propItem = safe_cast<PropertyItem^>(myEnum->Current);
            e->Graphics->DrawString( String::Format( "Property Item {0}",
 count ), font1, blackBrush, (float)X, (float)Y
 );
            Y += font1->Height;
            e->Graphics->DrawString( String::Format( "   ID: 0x{0}",
 propItem->Id.ToString( "x" ) ), font1, blackBrush, (float)X,
 (float)Y );
            Y += font1->Height;
            e->Graphics->DrawString( String::Format( "   type: {0}",
 propItem->Type ), font1, blackBrush, (float)X, (float)Y
 );
            Y += font1->Height;
            e->Graphics->DrawString( String::Format( "   length: {0} bytes",
 propItem->Len ), font1, blackBrush, (float)X, (float)Y
 );
            Y += font1->Height;
            count += 1;
         }
         delete font1;
      }
      catch ( Exception^ ) 
      {
         MessageBox::Show( "There was an error."
         "Make sure the path to the image file is valid." );
      }

   }

J#

private void ExtractMetaData(PaintEventArgs
 e)
{
    try {
        // Create an Image object. 
        Image theImage = new Bitmap("c:\\fakePhoto.jpg");

        // Get the PropertyItems property from image.
        PropertyItem propItems[] = theImage.get_PropertyItems();

        // Set up the display.
        Font font1 = new Font("Arial", 10);
        SolidBrush blackBrush = new SolidBrush(Color.get_Black());
        int X = 0;
        int Y = 0;

        // For each PropertyItem in the array, display the id, 
        // type, and length.
        int count = 0;

        //foreach (PropertyItem propItem in propItems)
        for (int iCtr = 0; iCtr < propItems.length;
 iCtr++) {
            PropertyItem propItem = propItems[iCtr];
            e.get_Graphics().DrawString("Property Item "  
                + System.Convert.ToString(count), font1, blackBrush, X, Y);
            Y += font1.get_Height();
            e.get_Graphics().DrawString("   ID: 0x" 
                + ((System.Int32)propItem.get_Id()).ToString("x"), font1,
 
                blackBrush, X, Y);
            Y += font1.get_Height();
            e.get_Graphics().DrawString("   type: "  
                + System.Convert.ToString(propItem.get_Type()), font1, 
                blackBrush, X, Y);
            Y += font1.get_Height();
            e.get_Graphics().DrawString("   length: "  
                + System.Convert.ToString(propItem.get_Len()) + " bytes",
 
                font1, blackBrush, X, Y);
            Y += font1.get_Height();
            count += 1;
        }
        font1.Dispose();
    }
    catch (System.Exception exp) {
        MessageBox.Show(("There was an error."  
            + "Make sure the path to the image file is valid."));
    }
} //ExtractMetaData

継承階層

System.Object
  System.Drawing.Imaging.PropertyItem

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
PropertyItem メンバ
System.Drawing.Imaging 名前空間
その他の技術情報
方法 : イメージ メタデータを読み取る