CImage::GetExporterFilterString

Статья
06/09/2015

Образ найти форматирует доступный для сохранения изображений.

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

Параметры

strExporters
Ссылка на объект 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 exporter.
CImage::GetExporterFilterString( strExporters, 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
Разделитель, используемый между форматами образа. Дополнительные сведения см. в разделе Примечания.

Возвращаемое значение

Стандартное HRESULT.

Заметки

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

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

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", если передать эту строку в диалоговое окно сохранения общего файла.