Partager via


CImage::GetExporterFilterString

Recherche des formats d'image disponibles pour enregistrer les images.

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

Paramètres

  • strExporters
    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 et 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 exporter.
    CImage::GetExporterFilterString( strExporters, 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.

Valeur de retour

HRESULTstandard.

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 sauvegarde de fichier en tant que boîte de dialogue.

Le strExporter 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 .Boîte de dialogue \0'if you pass this string to a common File Save utilisez séparateur null. '

Configuration requise

Header: atlimage.h

Voir aussi

Référence

Classe de CImage

CImage::GetImporterFilterString

CFileDialog::m_ofn

CFileDialog::GetFileExt

OPENFILENAME

CFileDialog::SetDefExt