CImage::GetImporterFilterString

Artículo
02/19/2013

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

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

Parámetros

strImporters
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 con 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 importer.
CImage::GetImporterFilterString( strImporters, 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.

Comentarios

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

El strImporter 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 null “\ 0 " separator si pasa esta cadena en un cuadro de diálogo común de Abrir archivo .