CImage::GetImporterFilterString

Article
03/04/2013

Recherche des formats d'image disponibles pour charger des images.

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

Paramètres

strImporters
Une référence à un objet de CSimpleString .Consultez Notes pour plus d'informations.
aguidFileTypes
Un tableau de GUID, chaque élément correspondant à l'un des types de fichier dans la chaîne.Dans l'exemple de pszAllFilesDescription ci-dessous, aguidFileTypes[0] est GUID_NULL avec les valeurs restantes de tableau sont les formats de fichier d'image pris en charge par le système d'exploitation actuel.

[!REMARQUE]

Pour une liste complète des constantes, consultez Constantes de format de fichier d'image dans Kit de développement logiciel Windows.
pszAllFilesDescription
Si ce paramètre n'est pas NULL, la chaîne de filtre aura un filtrage supplémentaire au début de la liste.Ce filtre a la valeur actuelle d' pszAllFilesDescription pour sa description, et reçoit des fichiers de toute extension prise en charge par tout autre outil type library exporter dans la liste.

Par exemple :
```
//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
L'ensemble de bits signale spécifier les types de fichier à exclure de la liste.Les balises sont autorisées :
- excludeGIF = 0x01 exclut les fichiers GIF.
- excludeBMP = 0x02 exclut les fichiers BMP (bitmaps Windows).
- excludeEMF = 0x04 exclut les fichiers EMF (métafichier amélioré).
- excludeWMF = 0x08 exclut les fichiers de WMF (Windows Metafile).
- excludeJPEG = 0x10 exclut les fichiers JPEG.
- excludePNG = 0x20 exclut les fichiers PNG.
- excludeTIFF = 0x40 exclut les fichiers TIFF.
- excludeIcon = 0x80 exclut les fichiers d'ICO (icône de windows).
- excludeOther = 0x80000000 exclut tout autre type de fichier non répertoriés ci-dessus.
- excludeDefaultLoad = 0 pour le chargement, tous les types de fichier sont inclus par défaut
- excludeDefaultSave = excludeIcon | excludeEMF | excludeWMF d'enregistrement, ces fichiers sont exclus par défaut car ils ont généralement des exigences particulières.
chSeparator
Le séparateur utilisé entre les formats d'image.Consultez Notes pour plus d'informations.

Notes

Vous pouvez passer la chaîne de format résultant à votre objet MFC CFileDialog pour exposer les extensions de fichier des formats d'image disponibles dans la boîte de dialogue de Ouvrir .

Le strImporter de paramètre a le format suivant :

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

où « | » est le caractère de séparation spécifié par chSeparator.Par exemple :

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

Utilisez le séparateur par défaut « | » si vous passez cette chaîne en un objet MFC CFileDialog .Utilisez « null de séparateur \ 0 " si vous passez cette chaîne dans une boîte de dialogue courante de Ouvrir .