CImage::GetExporterFilterString

Artykuł
06/09/2015

Wyszukuje dostępne formaty obrazu zapisywanie obrazów.

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

Parametry

strExporters
Odwołanie do CSimpleString obiektu.Zobacz uwagi Aby uzyskać więcej informacji.
aguidFileTypes
Tablica identyfikatorów GUID, dla każdego elementu odpowiadających typów plików w ciągu.W przykładzie w pszAllFilesDescription poniżej, aguidFileTypes[0] jest GUID_NULL i pozostałe wartości tablicy są formaty plików obsługiwane przez bieżący system operacyjny.

[!UWAGA]

Aby uzyskać pełną listę stałych zobacz Stałe Format pliku obrazu w Windows SDK.
pszAllFilesDescription
Jeśli ten parametr nie jest NULL, ciąg filtru będzie jeden dodatkowy filtr na początku listy.Ten filtr będzie bieżącą wartość pszAllFilesDescription jego opis i akceptuje pliki obsługiwane przez każdego eksportera na liście rozszerzenia.

Na przykład:
```
//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
Ustawianie flagi bitowe określające typy plików, aby wykluczyć z listy.Flagi dopuszczalne są:
- excludeGIF = pliki GIF nie obejmuje 0x01.
- excludeBMP = 0x02 pliki wyklucza BMP (mapa bitowa Windows).
- excludeEMF = 0x04 pliki wyklucza EMF (rozszerzony metaplik).
- excludeWMF = 0x08 pliki wyklucza WMF (Windows Metafile).
- excludeJPEG = pliki JPEG wyklucza 0x10.
- excludePNG = pliki PNG nie obejmuje 0x20.
- excludeTIFF = 0x40 pliki TIFF nie obejmuje.
- excludeIcon = 0x80 pliki wyklucza ICO (ikona Windows).
- excludeOther = 0x80000000 wyklucza innego typu pliku, nie wymienionych powyżej.
- excludeDefaultLoad = 0 do ładowania plików wszystkich typów są domyślnie uwzględnione
- excludeDefaultSave = excludeIcon | excludeEMF | excludeWMF zapisywania, pliki te są wykluczane domyślnie, ponieważ zazwyczaj mają specjalne wymagania.
chSeparator
Separatory używane między formaty obrazu.Zobacz uwagi Aby uzyskać więcej informacji.

Wartość zwracana

Standard HRESULT.

Uwagi

Wynikowy ciąg formatu można przekazać swoje MFC CFileDialog obiektu narazić rozszerzenia pliku obrazu dostępne formaty w oknie dialogowym Zapisz jako.

Parametr strExporter w formacie:

plik description0|*.ext0|filedescription1|*.ext1|... opis plikun| * .rozn||

gdy ' |' jest znak separatora określony przez chSeparator.Na przykład:

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

Użyj separatora domyślnego ' |' Jeśli ten ciąg przekazać MFC CFileDialog obiektu.Użyj separatora null '\0', jeśli ten ciąg przekazać wspólne okno dialogowe Zapisywanie pliku.