Partilhar via


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

Classe CImage

CImage::GetImporterFilterString

CFileDialog::m_ofn   

CFileDialog::GetFileExt

OPENFILENAME

CFileDialog::SetDefExt

Outros recursos

CImage membros