Image.SetPropertyItem(PropertyItem) メソッド

  • リファレンス

定義

名前空間:
System.Drawing
アセンブリ:
System.Drawing.Common.dll
アセンブリ:
System.Drawing.dll
パッケージ:
System.Drawing.Common v6.0.0
パッケージ:
System.Drawing.Common v7.0.0
パッケージ:
System.Drawing.Common v8.0.0
パッケージ:
System.Drawing.Common v9.0.0-preview.2.24128.3
ソース:
Image.cs
ソース:
Image.cs
ソース:
Image.cs

この 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。

例外

ArgumentException

このイメージのイメージ形式は、プロパティ項目をサポートしていません。

例

次のコード例では、 メソッドと SetPropertyItem メソッドの使用方法をGetPropertyItem示します。 この例は、Windows フォームで使用するように設計されています。 この例を実行するには、フォームに貼り付け、 メソッドを呼び出して フォームのPaintイベントをDemonstratePropertyItem処理し、 を としてPaintEventArgs渡eします。

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

注釈

イメージ形式でプロパティ項目がサポートされていない場合、このメソッドは "Property not supported" というメッセージをスロー ArgumentException します。イメージ形式でプロパティ項目がサポートされているが、設定しようとしている特定のプロパティがサポートされていない場合、このメソッドは試行を無視しますが、例外はスローしません。

クラスにパブリック コンストラクターがないため、プロパティ項目を PropertyItem 設定することは困難です。 この制限を回避する方法の 1 つは、プロパティ値を取得するか、既にPropertyItemsプロパティ項目を持つ の メソッドを呼び出GetPropertyItemすことによって をImage取得PropertyItemすることです。 その後、 の PropertyItem フィールドを設定し、 に SetPropertyItem渡すことができます。

適用対象