CImage::GetExporterFilterString

Artigo
02/25/2013

Localiza uma imagem dos formatos disponíveis para salvar imagens.

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

Parâmetros

strExporters
Uma referência a um objeto de CSimpleString .Consulte Comentários para mais informações.
aguidFileTypes
Uma matriz de GUIDs, com cada elemento que corresponde a um dos tipos de arquivo na cadeia de caracteres.Em o exemplo abaixo, em pszAllFilesDescription, aguidFileTypes[0] é GUID_NULL e os outros valores da matriz é formatos de arquivo de imagem suportados pelo sistema operacional atual.

Observação

Para obter uma lista completa de constantes, consulte Constantes de formato de imagem em Windows SDK.
pszAllFilesDescription
Se este parâmetro não é NULO, a cadeia de caracteres filtro terá um filtro extra no início da lista.Este filtro terá o valor atual de pszAllFilesDescription para sua descrição, aceita arquivos de qualquer extensão suportada por qualquer outro exportador na lista.

Por exemplo:
```
//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
O conjunto de bits sinaliza especificar que os tipos de arquivo para excluir a lista.Os sinalizadores são permitidos:
- excludeGIF = 0x01 exclusões arquivos GIF.
- excludeBMP = 0x02 exclusões arquivos de BMP (bitmap do windows).
- excludeEMF = 0x04 exclusões arquivos de EMF (metarquivo aprimorado).
- excludeWMF = 0x08 exclusões arquivos de WMF (Windows Metafile).
- excludeJPEG = 0x10 exclusões arquivos JPEG.
- excludePNG = 0x20 exclusões arquivos PNG.
- excludeTIFF = 0x40 exclusões arquivos TIFF.
- excludeIcon = 0x80 exclusões arquivos de ICO (ícone do windows).
- excludeOther = 0x80000000 exclusões qualquer outro tipo de arquivo não listado acima.
- excludeDefaultLoad = 0 para o carregamento, todos os tipos de arquivo é incluído por padrão
- excludeDefaultSave = excludeIcon | excludeEMF | excludeWMF para salvar, esses arquivos são excluídos por padrão porque ele geralmente requisitos especiais.
chSeparator
O separador usado entre os formatos de imagem.Consulte Comentários para mais informações.

Observação
Para obter uma lista completa de constantes, consulte Constantes de formato de imagem em Windows SDK.

Valor de retorno

HRESULTpadrão.

Comentários

Você pode passar a cadeia de caracteres resultante de formato para o objeto MFC CFileDialog para expor as extensões de arquivo formatos de imagem disponíveis em salvamento de Arquivo como a caixa de diálogo.

O strExporter de parâmetro tem o formato:

arquivo description0|*.ext0|filedescription1|*.ext1|… description de arquivon|*.extn||

onde “|” é o caractere separador especificado por chSeparator.Por exemplo:

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

Use o separador padrão “|” se você passar essa cadeia de caracteres a um objeto MFC CFileDialog .Use “nulo separator \ 0 " se você passar essa cadeia de caracteres em uma caixa de diálogo para salvamento de Arquivo comum.