CImage::GetExporterFilterString

Articolo
03/05/2013

Cerca i formati immagine disponibili per salvare le immagini.

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

Parametri

strExporters
Un riferimento a un oggetto CSimpleString.Vedere Note per ulteriori informazioni.
aguidFileTypes
Una matrice di GUID, con ogni elemento corrispondente a uno dei tipi di file nella stringa.Nell'esempio in pszAllFilesDescription riportato di seguito, aguidFileTypes[0] è GUID_NULL e i valori rimanenti della matrice viene i formati di file immagine supportati dal sistema operativo corrente.

[!NOTA]

Per un elenco completo delle costanti, vedere Costanti di formato di file immagine in Windows SDK.
pszAllFilesDescription
Se questo parametro non è NULL, la stringa di filtro avrà un filtro aggiuntivo inizio dell'elenco.Questo filtro avrà il valore corrente pszAllFilesDescription per la descrizione e accetta i file di qualsiasi estensione supportata da qualsiasi altro esportazione nell'elenco.

Di seguito è riportato un esempio:
```
//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
Set di flag di bit che specificano i tipi di file da escludere dall'elenco.i flag consentiti sono:
- excludeGIF = 0x01 esclusi i file GIF.
- excludeBMP = 0x02 esclusi i file BMP bitmap di Windows.
- excludeEMF = 0x04 esclusi i file EMF (Enhanced Metafile).
- excludeWMF = 0x08 esclusi i file WMF (metafile Windows).
- excludeJPEG = 0x10 esclusi i file JPEG.
- excludePNG = 0x20 esclusi i file PNG.
- excludeTIFF = 0x40 esclusi i file TIFF.
- excludeIcon = 0x80 esclusi i file di icona (ICO di Windows.
- excludeOther = 0x80000000 esclude qualsiasi altro tipo di file non elencato in.
- excludeDefaultLoad = 0 per il caricamento, tutti i tipi di file è incluso per impostazione predefinita
- excludeDefaultSave = excludeIcon | excludeEMF | excludeWMF per il salvataggio, questi file esclusi per impostazione predefinita perché in genere vi sono requisiti particolari.
chSeparator
Il separatore utilizzato tra i formati di immagine.Vedere Note per ulteriori informazioni.

Valore restituito

HRESULTstandard.

Note

È possibile passare la stringa di formato risultante a un oggetto MFC CFileDialog per esporre le estensioni di file dei formati immagine disponibili in salvataggio di file come finestra di dialogo.

Lo strExporter di parametro ha il formato seguente:

file description0|*.ext0|filedescription1|*.ext1|… descriptionn del file|*.extn||

dove "|" è il carattere separatore specificato da chSeparator.Di seguito è riportato un esempio:

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

Utilizzare il separatore predefinito "|" se si passa la stringa a un oggetto MFC CFileDialog.Utilizzare null "\ 0 " separator se si passa questa stringa in una finestra di dialogo di salvataggio file comune.