CImage::GetExporterFilterString

Busque los formatos de imágenes disponibles para guardar imágenes.

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

Parámetros

strExporters
una referencia a un objeto de CSimpleString .Vea Comentarios para obtener más información.
aguidFileTypes
Una matriz de GUID, con cada elemento correspondiente a uno de los tipos de archivo de la cadena.En el ejemplo de pszAllFilesDescription siguiente, aguidFileTypes[0] es GUID_NULL y los valores restantes de la matriz es los formatos de archivo de imagen admitidos por el sistema operativo actual.

[!NOTA]

Para obtener una lista completa de constantes, vea Constantes de formato de archivo de imagen en Windows SDK.
pszAllFilesDescription
Si este parámetro no es NULL, la cadena de filtro tendrá un filtro adicional al principio de la lista.Este filtro tendrá el valor actual de pszAllFilesDescription para su descripción, y acepta archivos de cualquier extensión admitida por cualquier otro exportador en la lista.

Por ejemplo:
```
//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
El conjunto de bit marca especificar qué tipos de archivo a excluir de la lista.Los indicadores permitidos son:
- excludeGIF = archivos GIF de 0x01 Excludes.
- excludeBMP = archivos BMP de 0x02 Excludes (mapa de bits de Windows).
- excludeEMF = archivos de 0x04 Excludes EMF (metarchivo mejorado).
- excludeWMF = archivos de 0x08 Excludes WMF (metarchivo de Windows).
- excludeJPEG = archivos de 0x10 Excludes JPEG.
- excludePNG = archivos de 0x20 Excludes PNG.
- excludeTIFF = archivos TIFF de 0x40 Excludes.
- excludeIcon = archivos de 0x80 Excludes ICO (icono de Windows).
- excludeOther = 0x80000000 Excludes cualquier otro tipo de archivo no enumerado anteriormente.
- excludeDefaultLoad = 0 carga For, todos los tipos de archivo se incluye de forma predeterminada
- excludeDefaultSave = un nombre de excludeIcon | excludeEMF | excludeWMF For, estos archivos se excluyen de forma predeterminada porque normalmente tienen requisitos especiales.
chSeparator
El separador utilizado entre los formatos de imagen.Vea Comentarios para obtener más información.

Valor devuelto

HRESULTestándar.

Comentarios

Puede pasar la cadena resultante de formato al objeto MFC CFileDialog para exponer las extensiones de archivo de los formatos de imágenes disponibles en el archivo cuadro de diálogo Guardar como.

El strExporter de parámetro tiene el formato:

archivo description0|*.ext0|filedescription1|*.ext1|… descriptionn de archivo|*.extn||

donde “|” es el carácter separador especificado por chSeparator.Por ejemplo:

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

utilice el separador predeterminado “|” si pasa esta cadena a un objeto de MFC CFileDialog .Utilice el cuadro de diálogo de \0' if you pass this string to a common File Save de separador null '.