CImage::GetExporterFilterString
Localiza os formatos de imagem disponível 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 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 e os valores da matriz restantes 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 exporter. CImage::GetExporterFilterString( strExporters, 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.
Valor de retorno
Um padrão HRESULT.
Comentários
Você pode passar a seqüência de caracteres de formato resultante para o MFC CFileDialog objeto para expor sistema autônomo extensões de arquivo dos formatos de imagem disponível na caixa de diálogo Arquivo Salvar sistema autônomo.
O parâmetro strExporter 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 uma caixa de diálogo Salvar arquivo comum.
Requisitos
Cabeçalho: atlimage.h
Consulte também
Referência
CImage::GetImporterFilterString