CImage::GetImporterFilterString

發行項
02/28/2013

尋找影像格式適用於載入影像。

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 常數。
pszAllFilesDescription
如果這個參數不是 NULL，篩選條件字串在清單的開頭會有其他篩選條件。這個篩選條件會有 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 (視窗、點陣圖) 檔案。
- 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
分隔符號使用的影像格式。請參閱備註以取得詳細資訊。