Bitmap.Clone

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

Bitmap.Clone メソッド (RectangleF, PixelFormat)

指定された PixelFormat 列挙体で定義されたこの Bitmap のセクションのコピーを作成します。

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

Visual Basic (宣言)

Public Function Clone ( _
    rect As RectangleF, _
    format As PixelFormat _
) As Bitmap

Visual Basic (使用法)

Dim instance As Bitmap
Dim rect As RectangleF
Dim format As PixelFormat
Dim returnValue As Bitmap

returnValue = instance.Clone(rect, format)

C#

public Bitmap Clone (
    RectangleF rect,
    PixelFormat format
)

C++

public:
Bitmap^ Clone (
    RectangleF rect, 
    PixelFormat format
)

J#

public Bitmap Clone (
    RectangleF rect, 
    PixelFormat format
)

JScript

public function Clone (
    rect : RectangleF, 
    format : PixelFormat
) : Bitmap

パラメータ

rect

この Bitmap のコピーする部分を定義します。

format

目的の Bitmap の PixelFormat 列挙体を指定します。

戻り値
このメソッドが作成する Bitmap。

例外

例外の種類	条件
OutOfMemoryException	rect は、ソース ビットマップ境界の外側です。
ArgumentException	rect の高さまたは幅は 0 です。

使用例

次の例は、Windows フォームでの使用を意図してデザインされており、Paint イベント ハンドラのパラメータである PaintEventArgs の e が必要です。このコードは次のアクションを実行します。

• Bitmap をファイルから 作成します。

• その Bitmap の一部分のクローンを作成します。

• クローン作成した部分を画面に描画します。

Visual Basic

Public Sub Clone_Example2(ByVal
 e As PaintEventArgs)

    ' Create a Bitmap object from a file.
    Dim myBitmap As New
 Bitmap("Grapes.jpg")

    ' Clone a portion of the Bitmap object.
    Dim cloneRect As New
 RectangleF(0, 0, 100, 100)
    Dim format As PixelFormat = myBitmap.PixelFormat
    Dim cloneBitmap As Bitmap = myBitmap.Clone(cloneRect,
 format)

    ' Draw the cloned portion of the Bitmap object.
    e.Graphics.DrawImage(cloneBitmap, 0, 0)
End Sub

C#

public void Clone_Example2(PaintEventArgs e)
{
             
    // Create a Bitmap object from a file.
    Bitmap myBitmap = new Bitmap("Grapes.jpg");
             
    // Clone a portion of the Bitmap object.
    RectangleF cloneRect = new RectangleF(0, 0, 100, 100);
    System.Drawing.Imaging.PixelFormat format = 
        myBitmap.PixelFormat;
    Bitmap cloneBitmap = myBitmap.Clone(cloneRect, format);
             
    // Draw the cloned portion of the Bitmap object.
    e.Graphics.DrawImage(cloneBitmap, 0, 0);
}

C++

public:
   void Clone_Example2( PaintEventArgs^ e )
   {
      // Create a Bitmap object from a file.
      Bitmap^ myBitmap = gcnew Bitmap( "Grapes.jpg" );

      // Clone a portion of the Bitmap object.
      RectangleF cloneRect = RectangleF(0,0,100,100);
      System::Drawing::Imaging::PixelFormat format = myBitmap->PixelFormat;
      Bitmap^ cloneBitmap = myBitmap->Clone( cloneRect, format );

      // Draw the cloned portion of the Bitmap object.
      e->Graphics->DrawImage( cloneBitmap, 0, 0 );
   }

プラットフォーム

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

参照

関連項目
Bitmap クラス
Bitmap メンバ
System.Drawing 名前空間

Bitmap.Clone メソッド (Rectangle, PixelFormat)

Rectangle 構造体と、指定された PixelFormat 列挙体で定義された、この Bitmap のセクションのコピーを作成します。

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

Visual Basic (宣言)

Public Function Clone ( _
    rect As Rectangle, _
    format As PixelFormat _
) As Bitmap

Visual Basic (使用法)

Dim instance As Bitmap
Dim rect As Rectangle
Dim format As PixelFormat
Dim returnValue As Bitmap

returnValue = instance.Clone(rect, format)

C#

public Bitmap Clone (
    Rectangle rect,
    PixelFormat format
)

C++

public:
Bitmap^ Clone (
    Rectangle rect, 
    PixelFormat format
)

J#

public Bitmap Clone (
    Rectangle rect, 
    PixelFormat format
)

JScript

public function Clone (
    rect : Rectangle, 
    format : PixelFormat
) : Bitmap

パラメータ

rect

この Bitmap のコピーする部分を定義します。座標は、この Bitmap の相対座標です。

format

目的の Bitmap の PixelFormat 列挙体を指定します。

戻り値
このメソッドが作成する新しい Bitmap オブジェクト。

例外

例外の種類	条件
OutOfMemoryException	rect は、ソース ビットマップ境界の外側です。
ArgumentException	rect の高さまたは幅は 0 です。

使用例

次の例は、Windows フォームでの使用を意図してデザインされており、Paint イベント ハンドラのパラメータである PaintEventArgs の e が必要です。このコードは次のアクションを実行します。

• Bitmap をファイルから 作成します。

• その Bitmap の一部分のクローンを作成します。

• クローン作成した部分を画面に描画します。

Visual Basic

Public Sub Clone_Example1(ByVal
 e As PaintEventArgs)

    ' Create a Bitmap object from a file.
    Dim myBitmap As New
 Bitmap("Grapes.jpg")

    ' Clone a portion of the Bitmap object.
    Dim cloneRect As New
 Rectangle(0, 0, 100, 100)
    Dim format As PixelFormat = myBitmap.PixelFormat
    Dim cloneBitmap As Bitmap = myBitmap.Clone(cloneRect,
 format)

    ' Draw the cloned portion of the Bitmap object.
    e.Graphics.DrawImage(cloneBitmap, 0, 0)
End Sub

C#

public void Clone_Example1(PaintEventArgs e)
{
             
    // Create a Bitmap object from a file.
    Bitmap myBitmap = new Bitmap("Grapes.jpg");
             
    // Clone a portion of the Bitmap object.
    Rectangle cloneRect = new Rectangle(0, 0, 100, 100);
    System.Drawing.Imaging.PixelFormat format = 
        myBitmap.PixelFormat;
    Bitmap cloneBitmap = myBitmap.Clone(cloneRect, format);
             
    // Draw the cloned portion of the Bitmap object.
    e.Graphics.DrawImage(cloneBitmap, 0, 0);
}

C++

public:
   void Clone_Example1( PaintEventArgs^ e )
   {
      // Create a Bitmap object from a file.
      Bitmap^ myBitmap = gcnew Bitmap( "Grapes.jpg" );

      // Clone a portion of the Bitmap object.
      Rectangle cloneRect = Rectangle(0,0,100,100);
      System::Drawing::Imaging::PixelFormat format = myBitmap->PixelFormat;
      Bitmap^ cloneBitmap = myBitmap->Clone( cloneRect, format );

      // Draw the cloned portion of the Bitmap object.
      e->Graphics->DrawImage( cloneBitmap, 0, 0 );
   }

プラットフォーム

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

参照

関連項目
Bitmap クラス
Bitmap メンバ
System.Drawing 名前空間

Bitmap.Clone メソッド

指定された PixelFormat で定義されたこの Bitmap のセクションのコピーを作成します。
オーバーロードの一覧

名前	説明
Bitmap.Clone ()	対象の Image の同一コピーを作成します。
Bitmap.Clone (Rectangle, PixelFormat)	Rectangle 構造体と、指定された PixelFormat 列挙体で定義された、この Bitmap のセクションのコピーを作成します。
Bitmap.Clone (RectangleF, PixelFormat)	指定された PixelFormat 列挙体で定義されたこの Bitmap のセクションのコピーを作成します。

参照

関連項目

Bitmap クラス
Bitmap メンバ
System.Drawing 名前空間