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

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

Overloads Public Sub EnumerateMetafile( _
   ByVal metafile As Metafile, _   ByVal destPoints() As Point, _   ByVal callback As Graphics.EnumerateMetafileProc, _   ByVal callbackData As IntPtr, _   ByVal imageAttr As ImageAttributes _)
[C#]
public void EnumerateMetafile(Metafilemetafile,Point[] destPoints,Graphics.EnumerateMetafileProccallback,IntPtrcallbackData,ImageAttributesimageAttr);
[C++]
public: void EnumerateMetafile(Metafile* metafile,PointdestPoints[],Graphics.EnumerateMetafileProc* callback,IntPtrcallbackData,ImageAttributes* imageAttr);
[JScript]
public function EnumerateMetafile(
   metafile : Metafile,destPoints : Point[],callback : Graphics.EnumerateMetafileProc,callbackData : IntPtr,imageAttr : ImageAttributes);

パラメータ

• metafile
  列挙する Metafile オブジェクト。
• destPoints
  描画するメタファイルのサイズと位置を決定する平行四辺形を定義する 3 つの Point 構造体の配列。
• callback
  メタファイル レコードの送信先のメソッドを指定する Graphics.EnumerateMetafileProc デリゲート。
• callbackData
  必須だが無視される内部ポインタ。このパラメータには、 IntPtr.Zero を渡すことができます。
• imageAttr
  描画イメージのイメージ属性情報を指定する ImageAttributes オブジェクト。

戻り値

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

解説

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

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

destPoints パラメータは、平行四辺形の 3 つの点を指定します。3 つの Point 構造体は、平行四辺形の左上隅、右上隅、および左下隅を表します。初めの 3 つの点から 4 番目の点を推定して、平行四辺形を形成します。描画するメタファイルは、平行四辺形に合わせてスケーリングされ、傾斜が設定されます。

メタファイルの書き込み時に指定された属性は、 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 オーバーロードの一覧