Metafile::ConvertToEmfPlus(constGraphics*,constWCHAR*,INT*,EmfType,constWCHAR*) メソッド (gdiplusheaders.h)

Metafile::ConvertToEmfPlus メソッドは、このメタファイル オブジェクトを EMF+ 形式に変換します。

構文

Status ConvertToEmfPlus(
  [in] const Graphics *refGraphics,
  [in] const WCHAR    *filename,
       INT            *conversionFailureFlag,
  [in] EmfType        emfType,
  [in] const WCHAR    *description
);

パラメーター

[in] refGraphics

型: const Graphics*

変換されたメタファイルに格納されているレコードに状態 (アンチエイリアシング、補間などの設定) が適用される Graphics オブジェクトへのポインター。

[in] filename

型: const WCHAR*

変換されたメタファイルを保存するファイルの名前を指定する、null で終わるワイド文字列へのポインター。

conversionFailureFlag

TBD

[in] emfType

型: EmfType

省略可能。 変換されたファイルの形式が EmfTypeEmfPlusOnly 形式か EmfTypeEmfPlusDual 形式かを指定する EmfType 列挙体の要素。 EmfTypeEmfOnly を渡さないでください。 既定値は EmfTypeEmfPlusOnly です。

[in] description

型: const WCHAR*

省略可能。 変換されたメタファイルのヘッダーに格納されている null で終わるワイド文字列へのポインター。 既定値は NULL です。

戻り値

種類: 状態

メソッドが成功すると、 Status 列挙体の要素である OK が返されます。

メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。

解説

このメソッドは、 Metafile オブジェクト内の最初のレコードを変換されたレコードに置き換えます。 元の メタファイル オブジェクトのコピーを保持するには、 Clone メソッドを呼び出します。

emfType パラメーターを EmfTypeEmfPlusDual に設定した場合、変換されたメタファイルには拡張メタファイル (EMF) 表現と EMF+ 表現が含まれます。 EMF 表現は、新しく作成された EMF+ レコードから変換された EMF レコードではなく、元の EMF レコードのセットです。

戻り値を [OK] にし、 conversionSuccess で返される値を FALSE にすることができます。 場合によっては、いくつかの個々のレコードが完全な精度で変換できなかった場合でも、全体的な変換が成功したと見なされることがあります。 たとえば、元のメタファイルには、Windows GDI+ (または EMF+) でサポートされていないレコードまたは操作があり、その場合、それらのレコードまたは操作はエミュレートされます。

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	gdiplusheaders.h (Gdiplus.h を含む)
Library	Gdiplus.lib
[DLL]	Gdiplus.dll