Image.SetPropertyItem(PropertyItem) Image.SetPropertyItem(PropertyItem) Image.SetPropertyItem(PropertyItem) Image.SetPropertyItem(PropertyItem) Method

定義

この Image に、プロパティ項目 (メタデータの一部) を格納します。Stores a property item (piece of metadata) in this 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)

パラメーター

propitem
PropertyItem PropertyItem PropertyItem PropertyItem

格納される PropertyItemThe PropertyItem to be stored.

例外

このイメージのイメージ形式は、プロパティ項目をサポートしていません。The image format of this image does not support property items.

次のコード例は、使用する方法を示します、GetPropertyItemSetPropertyItemメソッド。The following code example demonstrates how to use the GetPropertyItem and SetPropertyItem methods. この例は、Windows フォームで使用する設計されています。This example is designed to be used with Windows Forms. この例を実行するフォームに貼り付けることと、フォームの処理Paintイベントを呼び出すことによって、DemonstratePropertyItemを渡してメソッドeとしてPaintEventArgsします。To run this example, paste it into a form, and handle the form's Paint event by calling the DemonstratePropertyItem method, passing e as 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

注釈

イメージ形式があるプロパティ項目をサポートしていない場合、このメソッドはスローArgumentExceptionメッセージ「プロパティはサポートされていません」。If the image format does not support property items, this method throws ArgumentException with the message "Property not supported." イメージ形式は、プロパティ項目をサポートしている設定しようとする特定のプロパティをサポートしない場合は、このメソッドは要求を無視しますが、例外はスローされません。If the image format supports property items but does not support the particular property you are attempting to set, this method ignores the attempt but does not throw an exception.

ため、プロパティの項目を設定することは困難です、PropertyItemクラスには、パブリック コンス トラクターがありません。It is difficult to set property items, because the PropertyItem class has no public constructors. この制限を回避する方法の 1 つは取得するため、PropertyItem取得することによって、PropertyItemsプロパティ値または通話、GetPropertyItemのメソッド、Imageプロパティ項目を既に持っています。One way to work around this restriction is to obtain a PropertyItem by retrieving the PropertyItems property value or calling the GetPropertyItem method of an Image that already has property items. フィールドを設定することができ、PropertyItemに渡すとSetPropertyItemします。Then you can set the fields of the PropertyItem and pass it to SetPropertyItem.

適用対象