CImage::GetImporterFilterString

Статья
06/09/2015

Образ найти форматирует доступен для загрузки образов.

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

Параметры

strImporters
Ссылка на объект CSimpleString. Дополнительные сведения см. в разделе Примечания.
aguidFileTypes
Массив GUID, с каждым элементом, соответствующий одному из типов файлов в строке. В примере, приведенном ниже, в pszAllFilesDescriptionaguidFileTypes[0] GUID_NULL с остальными значениями массива форматы файлов изображения, поддерживаемые текущим операционной системой.

Примечание

Полный список констант см. в разделе константы формата файла изображения в Windows SDK.
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 (растрового изображения Windows).
- excludeEMF = 0x04 исключить файлы расширенного метафайла (EMF).
- 0x08 =excludeWMF исключить файлы WMF (метафайла Windows).
- excludeJPEG = 0x10 исключить файлы JPEG.
- 0x20 =excludePNG исключить файлы PNG.
- 0x40 =excludeTIFF исключить файлы TIFF.
- excludeIcon = 0x80 исключить файлы значка ICO (Windows).
- excludeOther = 0x80000000 исключают любой другой тип файла не перечисленные выше.
- excludeDefaultLoad = 0 для загрузки по умолчанию включены все типы файлов
- excludeDefaultSave = excludeIcon | excludeEMF | excludeWMF для сохранения эти файлы исключенное по умолчанию, поскольку они обычно имеют особые требования.
chSeparator
Разделитель, используемый между форматами образа. Дополнительные сведения см. в разделе Примечания.

Заметки

Можно передать результирующую строку форматирования к конкретному объекту MFC CFileDialog для предоставления расширения файлов, доступных форматов образа в диалоговом окне File Open.

strImporter параметра имеет формат:

file description0|*.ext0|filedescription1|*.ext1|...описание файловn|*.extn||

where "|" указанный chSeparator знаков-разделителей. Примеры.

"Bitmap format|*.bmp|JPEG format|*.jpg|GIF format|*.gif|PNG format|*.png||"

По умолчанию используется разделитель "|" при передаче этой строки в объект MFC CFileDialog. Использование значения null в качестве разделителя "\0", если передать эту строку к общему компоненту File Open.