Classe de CFileDialog

Encapsula a caixa de diálogo comuns que é usada para o arquivo operações aberta ou salvamento de arquivo.

class CFileDialog : public CCommonDialog

Membros

Construtores public

métodos públicos

métodos protegidos

Membros públicos de dados

Comentários

Caixas de diálogo comuns permite que você implemente caixas de diálogo de arquivo seleção, por exemplo, Abrir Arquivo e Salvar como, de uma maneira de que é consistente com padrões do windows.

Você pode usar CFileDialog como é fornecido com o construtor, ou você pode derivar sua própria classe da caixa de diálogo de CFileDialog e escrever um construtor para atender às suas necessidades.Em ambos os casos, essas caixas de diálogo se comportar como caixas de diálogo padrão MFC porque eles são derivadas de Classe de CCommonDialog.CFileDialog depende do arquivo de COMMDLG.DLL que está incluído no windows.

A aparência e funcionalidade de CFileDialog com Windows Vista diferem das versões anteriores do windows.A opção CFileDialog automaticamente usa o novo estilo de Windows Vista sem alterações de código se um programa é compilado e executado em Windows Vista.Use o parâmetro de bVistaStyle no construtor para substituir manualmente esta atualização automática.A exceção à atualização automática é caixas de diálogo personalizadas.Não serão convertidos para o novo estilo.Para obter mais informações sobre o construtor, consulte CFileDialog::CFileDialog.

Observação
O sistema identificação do controle difere em Windows Vista de versões anteriores do windows quando você usa CFileDialog.Você deve atualizar todas as referências para os controles de CFileDialog no código antes que você possa mova seu projeto de uma versão anterior do windows.

Alguns métodos de CFileDialog não são suportados em Windows Vista.Verifique o tópico individual do método para obter informações sobre se o método é suportado.Além de isso, as seguintes funções herdadas não são suportadas em Windows Vista:

• CDialog::OnInitDialog

• CDialog::OnSetFont

As mensagens do windows para a classe de CFileDialog varia com base no sistema operacional que você está usando.Por exemplo, o Windows XP não oferece suporte CDialog::OnCancel e CDialog::OnOK para a classe de CFileDialog .Em o entanto, Windows Vista suportar-los.Para obter mais informações sobre as mensagens diferentes que são geradas e a ordem em que eles são recebidos, consulte exemplo de CFileDialog: Ordem de eventos de log.

Para usar um objeto de CFileDialog , primeiro crie o objeto usando o construtor de CFileDialog .Depois que a caixa de diálogo foi construída, você pode definir ou modificar os valores na estrutura de CFileDialog::m_ofn para inicializar valores ou estados dos controles de caixa de diálogo.A estrutura de m_ofn é do tipo OPENFILENAME.Para obter mais informações, consulte a estrutura de OPENFILENAME em Windows SDK.

Depois que você inicializa todos os controles de caixa de diálogo, chame o método de CFileDialog::DoModal para exibir a caixa de diálogo para que o usuário possa digite o caminho e o nome de arquivo.DoModal retorna se o usuário clicou em OK IDOK () ou o botão cancelar IDCANCEL ().Se DoModal retorna IDOK, você pode usar uma das funções de membro públicas de CFileDialog para recuperar informações colocada em pelo usuário.

Observação
Em Windows Vista, chamadas de vários a IFileDialog::SetFileTypes causa um erro.A segunda chamada a SetFileTypes para qualquer instância de CFileDialog retornará E_UNEXPECTED em Windows Vista.Qualquer ligação de controle SetFileTypesdo método de CFileDialog .Por exemplo, duas chamadas a CFileDialog::DoModal para a mesma instância de CFileDialog geram AFIRMAR.

CFileDialog inclui vários membros protegidos que permitem que você faça manipulação personalizada de violações de compartilhamento, de validação de nome de arquivo, e de notificação de alteração de caixa de listagem.Esses membros protegidos são funções de retorno de chamada que a maioria dos aplicativos não tem que usar como tratamento padrão é executada automaticamente.as entradas de mapa Mensagem- para essas funções não são necessárias porque eles são funções virtuais padrão.

Você pode usar a função de CommDlgExtendedError do windows para determinar se um erro ocorrer durante a inicialização da caixa de diálogo e para aprender mais sobre o erro.

A destruição de objetos de CFileDialog é processada automaticamente.Você não precisa chamar CDialog::EndDialog.

Para permitir que o usuário selecione de arquivos múltiplos, defina o parâmetro de OFN_ALLOWMULTISELECT antes de chamar DoModal.Você deve fornecer seu próprio buffer de nome de arquivo para acomodar a lista retornado de vários nomes de arquivo.Faça isso substituindo m_ofn.lpstrFile com um ponteiro para um buffer que você atribuiu, depois que você constrói CFileDialog, mas antes de chamar DoModal.

Além de isso, você deve definir m_ofn.nMaxFile usando o número de caracteres em buffer apontado por m_ofn.lpstrFile.Se você definir o número máximo de arquivos sejam selecionados a n, o tamanho do buffer é necessário n * (_MAX_PATH + 1) + 1.O primeiro item retornado em buffer é o caminho para a pasta onde os arquivos foram selecionados.Para Windows Vista- estilo caixas de diálogo, diretório e as cadeias de caracteres de nome de arquivo NULL- são finalizadas, com um caractere nulo extra após o nome do arquivo mais recente.Este formato permite que as caixas de diálogo do estilo para retornar nomes de arquivo demorada que incluem espaços.Para caixas de diálogo antiquadas, as cadeias de caracteres de diretório e nome de arquivo são separados por espaços e a função usa nomes de arquivo curtas para nomes de arquivo com espaços.

O exemplo seguinte demonstra como usar um buffer para recuperar e listar vários nomes de arquivo.

#define MAX_CFileDialog_FILE_COUNT 99
#define FILE_LIST_BUFFER_SIZE ((MAX_CFileDialog_FILE_COUNT * (MAX_PATH + 1)) + 1)

CString fileName;
wchar_t* p = fileName.GetBuffer( FILE_LIST_BUFFER_SIZE );
CFileDialog dlgFile(TRUE);
OPENFILENAME& ofn = dlgFile.GetOFN( );
ofn.Flags |= OFN_ALLOWMULTISELECT;
ofn.lpstrFile = p;
ofn.nMaxFile = FILE_LIST_BUFFER_SIZE;

dlgFile.DoModal();
fileName.ReleaseBuffer();

wchar_t* pBufEnd = p + FILE_LIST_BUFFER_SIZE - 2;
wchar_t* start = p;
while( ( p < pBufEnd ) && ( *p ) )
  p++;
if( p > start )
{
  _tprintf(_T("Path to folder where files were selected:  %s\r\n\r\n"), start );
  p++;

  int fileCount = 1;
  while( ( p < pBufEnd ) && ( *p ) )
  {
    start = p;
    while( ( p < pBufEnd ) && ( *p ) )
      p++;
    if( p > start )
      _tprintf(_T("%2d. %s\r\n"), fileCount, start );
    p++;
    fileCount++;
  }
}

Para alterar o tamanho do buffer em resposta ao usuário que selecionar vários nomes de arquivo, você deve derivar uma nova classe de CFileDialog e substituir o método de CFileDialog::OnFileNameChange .

Se você derivado uma nova classe de CFileDialog, você pode usar um mapa de mensagem para tratar todas as mensagens.Para estender tratamento de mensagem padrão, derive uma classe de CFileDialog, adicione um mapa de mensagem para a nova classe, e fornecer funções de membro para as novas mensagens.Você não precisará fornecer uma função de gancho para personalizar a caixa de diálogo.

Para personalizar a caixa de diálogo, derive uma classe de CFileDialog, forneça um modelo personalizado da caixa de diálogo, e adicionar um mapa de mensagens para processar as notificações dos controles estendidos.Passar todas as mensagens não processadas para a classe base.Você não precisa personalizar a função de gancho.

Quando você estiver usando o estilo de Windows Vista de CFileDialog, você não pode usar mapas de mensagem e modelos da caixa de diálogo.Em vez de isso, você deve usar interfaces COM para a funcionalidade semelhante.

Para obter mais informações sobre como usar CFileDialog, consulte Classes de caixa de diálogo comuns.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

CFileDialog

Requisitos

**Cabeçalho:**afxdlgs.h

Consulte também

Referência

Classe de CCommonDialog

Gráfico de hierarquia