CImage::GetImporterFilterString

Artigo
08/25/2010

Localiza os formatos de imagem disponível para carregar imagens.

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

Parâmetros

strImporters
Uma referência a um CSimpleString objeto.See Comentários para obter mais informações.
aguidFileTypes
Uma matriz de GUIDs, com cada elemento corresponde a um dos tipos de arquivo na seqüência de caracteres.No exemplo da pszAllFilesDescription abaixo, aguidFileTypes[0] é GUID_NULL com o array restante valores são os formatos de arquivo de imagem suportados pelo sistema operacional corrente.

Observação:

Para obter uma lista completa de constantes, consulte Constantes de formato de arquivo imagem in the Windows SDK.
pszAllFilesDescription
Se este parâmetro não for NULO, a seqüência de caracteres de filtro terá um filtro adicional no início da lista.Este filtro terá o valor corrente de pszAllFilesDescription para sua descrição e aceita arquivos de qualquer extensão com o apoio de quaisquer Outros 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 importer.
CImage::GetImporterFilterString( strImporters, aguidFileTypes, 
   _T("All Image Files"));
```
dwExclude
Conjunto de sinalizadores de bit que especificam quais tipos de arquivo a serem excluídos da lista.Sinalizadores permitidos são:
- excludeGIF = 0 x 01 GIF exclui arquivos.
- excludeBMP = 0 x 02 exclui BMP (Windows Bitmap) arquivos.
- excludeEMF = 0x04 exclui EMF (metarquivo avançado) arquivos.
- excludeWMF = 0 x 08 exclui WMF (metarquivo do Windows) arquivos.
- excludeJPEG = 0 x 10 JPEG exclui arquivos.
- excludePNG = 0 x 20 PNG exclui arquivos.
- excludeTIFF = 0 x 40 TIFF exclui arquivos.
- excludeIcon = 0 x 80 ICO exclui (ícone do Windows) arquivos.
- excludeOther = 0 x 80000000 exclui qualquer Outros tipo de arquivo não listado acima.
- excludeDefaultLoad = 0 Para o arquivo de todos os tipos são incluídos por padrão de carga
- excludeDefaultSave = excludeIcon | excludeEMF | excludeWMF Para salvar, esses arquivos são excluídos por padrão porque eles geralmente possuem requisitos especiais.
chSeparator
O separador usado entre os formatos de imagem.See Comentários para obter mais informações.

Observação:
Para obter uma lista completa de constantes, consulte Constantes de formato de arquivo imagem in the Windows SDK.

Comentários

Você pode passar a seqüência de caracteres de formato resultante para o MFC CFileDialog objeto para expor as extensões de arquivo dos formatos de imagem disponível no em em aberto arquivo caixa de diálogo.

O parâmetro strImporter tem o formato:

arquivo description0|*.ext0|filedescription1|*.ext1|... arquivo descrição n|*.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 seqüência de caracteres para um MFC CFileDialog objeto. Use o separador nulo '\0' se você passar essa seqüência de caracteres para um comuns em em aberto arquivo caixa de diálogo.