CImage::GetExporterFilterString

Artikel
02/26/2013

Sucht die Bildformate, die zum Speichern von Bildern verfügbar sind.

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

Parameter

strExporters
Ein Verweis auf ein Objekt CSimpleString.Siehe Remarks weitere Informationen.
aguidFileTypes
Ein Array GUID, mit jedem Element entsprechend einem der Dateitypen in der Zeichenfolge.Im Beispiel in pszAllFilesDescription unten, ist aguidFileTypes[0] GUID_NULL und die restlichen Arraywerte sind die Bilddateiformate, die vom aktuellen Betriebssystem unterstützt werden.

Hinweis

Eine vollständige Liste von Konstanten, finden Sie unter Bilddatei-Format-Konstanten in Windows SDK.
pszAllFilesDescription
Wenn dieser Parameter nicht NULL ist, verfügt die Filterzeichenfolge einen zusätzlichen Filter am Anfang der Liste.Dieser Filter hat den aktuellen Wert von pszAllFilesDescription für ihre Beschreibung und akzeptiert Dateien jeder Erweiterung, die durch anderen Exporttool in der Liste unterstützt wird.

Beispiel:
```
//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
Satz von Bitflags, die die Dateitypen angeben, um in der Liste auszuschließen.Zulässige Flags sind:
- excludeGIF = 0x01 schließt GIF-Dateien aus.
- excludeBMP = 0x02 Schließt BMP-Dateien (Windows Bitmap) aus.
- excludeEMF = 0x04 schließt Dateien (EMF erweiterte Metadatei) aus.
- excludeWMF 0x08 = schließt Dateien WMF (Windows Metafile) aus.
- excludeJPEG 0x10 = schließt JPEG-Dateien aus.
- excludePNG = 0x20 schließt PNG ‑ Dateien aus.
- excludeTIFF 0x40 = schließt TIFF-Dateien aus.
- excludeIcon 0x80 = schließt Dateien ICO (Windows-Symbol) aus.
- excludeOther = 0x80000000 enthält einen anderen Dateityp aus, der nicht oben aufgeführt ist.
- excludeDefaultLoad = 0 für Auslastung, alle Dateitypen werden standardmäßig enthalten
- excludeDefaultSave = excludeIcon | excludeEMF | excludeWMF zum Speichern, diese Dateien werden standardmäßig ausgeschlossen, da sie normalerweise besondere Anforderungen haben.
chSeparator
Das Trennzeichen wird zwischen den Bildformaten.Siehe Remarks weitere Informationen.

Hinweis
Eine vollständige Liste von Konstanten, finden Sie unter Bilddatei-Format-Konstanten in Windows SDK.

Rückgabewert

Standard-HRESULT.

Hinweise

Sie können die resultierende Formatzeichenfolge an das Objekt MFC CFileDialog übergeben, um die Dateierweiterungen der verfügbaren Bildformate in der Datei-Abwehr als Dialogfeld verfügbar zu machen.

Das strExporter-Parameter hat das Format:

Datei description0|*.ext0|filedescription1|*.ext1|Datei descriptionn...|*.extn||

wobei "|" ist das Trennzeichen, das von chSeparator angegeben wird.Beispiel:

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

Verwenden Sie das standardmäßige Trennzeichen "|" wenn Sie diese Zeichenfolge auf ein Objekt MFC CFileDialog übergeben.Verwenden Sie NULL Trennzeichen" \ 0 ", wenn Sie diese Zeichenfolge in einen Gemeinschaftsdatei-Abwehrdialogfeld übergeben.