CImage::GetImporterFilterString

2008-09-17

更新 : 2007 年 11 月

イメージの読み込みに使用できるイメージ形式を取得します。

static HRESULT GetImporterFilterString(
   CSimpleString& strImporters,
   CSimpleArray< GUID >& aguidFileTypes,
   LPCTSTR pszAllFilesDescription = NULL,
   DWORD dwExclude = excludeDefaultLoad,
   TCHAR chSeparator = _T( '|' )
);

パラメータ

strImporters
CSimpleString オブジェクトへの参照。詳細については、「解説」を参照してください。
aguidFileTypes
GUID の配列。各要素は、文字列内のいずれかのファイル形式に対応します。以下の pszAllFilesDescription の例では、aguidFileTypes[0] は GUID_NULL であり、その他の配列値は現在のオペレーティングシステムがサポートするイメージファイル形式です。

メモ :

定数の一覧については、Windows SDK の「Image File Format Constants」を参照してください。
pszAllFilesDescription
このパラメータが NULL 以外の場合は、フィルタ文字列のリストの先頭にフィルタが 1 つ追加されます。pszAllFilesDescription の現在の値が、追加されるフィルタの説明になります。このフィルタでは、リスト内の他のフィルタがサポートする拡張子を持つすべてのファイルが受け入れられます。

次に例を示します。
```
//First filter in the list will be titled "All Image Files", and
//will accept files with any extension supported by any importer.
CImage::GetImporterFilterString( strImporters, aguidFileTypes, 
   _T("All Image Files"));
```
dwExclude
リストから除外するファイル形式を指定する、ビットフラグのセット。指定できるフラグを次に示します。
- excludeGIF = 0x01 GIF ファイルを除外します。
- excludeBMP = 0x02 BMP ファイル (Windows ビットマップ) を除外します。
- excludeEMF = 0x04 EMF ファイル (拡張メタファイル) を除外します。
- excludeWMF = 0x08 WMF ファイル (Windows メタファイル) を除外します。
- excludeJPEG = 0x10 JPEG ファイルを除外します。
- excludePNG = 0x20 PNG ファイルを除外します。
- excludeTIFF = 0x40 TIFF ファイルを除外します。
- excludeIcon = 0x80 ICO (Windows アイコン) ファイルを除外します。
- excludeOther = 0x80000000 上記以外のすべてのファイル形式を除外します。
- excludeDefaultLoad = 0 既定では、すべてのファイル形式を読み込み対象に含みます。
- excludeDefaultSave = excludeIcon | excludeEMF | excludeWMF これらのファイルは他のファイルとは条件が異なるため、既定では、保存できるファイル形式から除外されています。
chSeparator
イメージ形式を区切るために使用される区切り記号。詳細については、「解説」を参照してください。