次の方法で共有

Graphics.EnumerateMetafile メソッド (Metafile, RectangleF, RectangleF, GraphicsUnit, Graphics.EnumerateMetafileProc, IntPtr, ImageAttributes)

  • [アーティクル]

指定したイメージ属性を使用して、 Metafile オブジェクトから選択された四角形のレコードをコールバック メソッドに一度に 1 つずつ送信して、指定した四角形内に表示します。

Overloads Public Sub EnumerateMetafile( _
   ByVal metafile As Metafile, _   ByVal destRect As RectangleF, _   ByVal srcRect As RectangleF, _   ByVal unit As GraphicsUnit, _   ByVal callback As Graphics.EnumerateMetafileProc, _   ByVal callbackData As IntPtr, _   ByVal imageAttr As ImageAttributes _)
[C#]
public void EnumerateMetafile(Metafilemetafile,RectangleFdestRect,RectangleFsrcRect,GraphicsUnitunit,Graphics.EnumerateMetafileProccallback,IntPtrcallbackData,ImageAttributesimageAttr);
[C++]
public: void EnumerateMetafile(Metafile* metafile,RectangleFdestRect,RectangleFsrcRect,GraphicsUnitunit,Graphics.EnumerateMetafileProc* callback,IntPtrcallbackData,ImageAttributes* imageAttr);
[JScript]
public function EnumerateMetafile(
   metafile : Metafile,destRect : RectangleF,srcRect : RectangleF,unit : GraphicsUnit,callback : Graphics.EnumerateMetafileProc,callbackData : IntPtr,imageAttr : ImageAttributes);

パラメータ

  • metafile
    列挙する Metafile オブジェクト。
  • destRect
    描画するメタファイルの位置とサイズを指定する RectangleF 構造体。
  • srcRect
    左上隅を基準に相対的に、描画するメタファイルの部分を指定する RectangleF 構造体。
  • unit
    srcRect パラメータで指定された四角形に含まれるメタファイルの部分の決定に使用される単位を指定する GraphicsUnit 列挙体のメンバ。
  • callback
    メタファイル レコードの送信先のメソッドを指定する Graphics.EnumerateMetafileProc デリゲート。
  • callbackData
    必須だが無視される内部ポインタ。このパラメータには、 IntPtr.Zero を渡すことができます。
  • imageAttr
    描画イメージのイメージ属性情報を指定する ImageAttributes オブジェクト。

戻り値

このメソッドは値を返しません。

解説

このメソッドは、指定したメタファイルに含まれるレコードを列挙します。各レコードは、 callback パラメータで指定されるコールバック メソッドに個別に送信されます。通常、コールバック メソッドは、 PlayRecord メソッドを呼び出してレコードを "再生" することにより描画します。

コールバック メソッドでは、 Metafile.PlayRecord を呼び出す場合、列挙する特定の Metafile オブジェクトの PlayRecord メソッドを呼び出す必要があります。

srcRect パラメータで指定された四角形の外側で行われる描画は無視されます。

メタファイルの書き込み時に指定された属性は、 imageAttr パラメータで指定されたイメージ属性に置き換えられます。

使用例

例については、 EnumerateMetafile を参照してください。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

Graphics クラス | Graphics メンバ | System.Drawing 名前空間 | Graphics.EnumerateMetafile オーバーロードの一覧