CFileDialog:: CFileDialog

CFileDialog (BOOLbOpenFileDialog,LPCTSTRlpszDefExt=NULL,LPCTSTRlpszFileNamenula,DWORDdwFlags=OFN_HIDEREADONLY| =OFN_OVERWRITEPROMPT,LPCTSTRlpszFilter=Nula,CWnd *pParentWnd=Nulo);

Parâmetros

bOpenFileDialog

Defina como TRUE para construir uma caixa de diálogo Abrir ficheiro ou falso para construir uma caixa de diálogo arquivo Salvar como.

lpszDefExt

A extensão de nome de arquivo padrão. Se o usuário não incluir uma extensão na caixa de edição nome do arquivo, a extensão especificada por lpszDefExt é automaticamente acrescentada ao nome do arquivo. Se este parâmetro é NULL, sem extensão de arquivo é acrescentado.

lpszFileName

Caixa de edição nome do arquivo inicial que aparece no nome de arquivo. Se for NULL, nenhum nome de arquivo inicialmente exibida.

dwFlags

Uma combinação de um ou mais sinalizadores que permitem que você personalize a caixa de diálogo. Para obter uma descrição desses sinalizadores, consulte o OPENFILENAME estrutura na documentação do Win32 SDK. Se você modificar o m_ofn.Sinalizadores estrutura membro, use um operador bit a bit ou suas alterações para manter o comportamento padrão intactos.

lpszFilter

Uma série de pares de Cadeia de caracteres que especificam filtros você pode aplicar para o arquivo. Se você especificar filtros de arquivo, somente os arquivos selecionados aparecerão na caixa de listagem de arquivos. Consulte a seção "Comentários" para obter mais informações sobre como trabalhar com filtros de arquivo.

pParentWnd

Um ponteiro para janela pai ou proprietário do objeto de caixa de diálogo de arquivo.

Observações

Chame essa função para construir um padrão Windows caixa de diálogo caixa-objeto de arquivo. Um arquivo abrir ou arquivo Salvar como caixa de diálogo é construída, depending on o valor de bOpenFileDialog.

Para permitir que o usuário selecionar Múltiplo arquivos, defina o Sinalizar de OFN_ALLOWMULTISELECT antes de chamar DoModal. Você precisará fornecer seu próprio buffer de nome de arquivo para acomodar a lista retornada de Múltiplo nomes de arquivo. Fazer isso, substituindo m_ofn. lpstrFile por um ponteiro para um buffer que você tiver alocado, depois de construir a CFileDialog, mas antes de chamar DoModal. Além disso, você deve definir m_ofn.nMaxFile com o número de caracteres no buffer apontado por m_ofn. lpstrFile.

Para permitir que o usuário redimensionar uma caixa de diálogo do explorador-estilo usando o mouse ou teclado, defina o sinalizador OFN_ENABLESIZING . A definição deste sinalizador é necessária somente se você fornecer um procedimento de gancho ou modelo personalizado. O sinalizador funciona apenas com uma caixa de diálogo do estilo do Explorer; caixas de diálogo do estilo antigo não permite redimensionamento.

O parâmetro lpszFilter é usado para determinar o tipo de nome de arquivo que deve ter um arquivo a ser exibido na caixa de listagem de arquivo. A primeira seqüência de caracteres do par de Cadeia de caracteres descreve o filtro; a segunda cadeia de caracteres indica a extensão de arquivo para usar. Várias extensões podem ser especificadas usando ";" como o delimitador. A Cadeia de caracteres termina com dois ' |' caracteres, seguidos por um caractere Nulo . Você também pode usar um objeto de CString para este parâmetro.

Por exemplo, o Microsoft Excel permite que os usuários abrir arquivos com extensões.XLC (gráfico) ou.XLS (planilha), entre outros. O filtro para o Excel poderia ser escrito como:

static char BASED_CODE szFilter [] = "arquivos de gráfico (*.xlc) | *. xlc|Arquivos de planilha (xls) | *. xls|Arquivos de dados (*.xlc; xls) | *. xlc; *.* xls|Todos os arquivos (*. *) | *. * | | " 

Visão geral de CFileDialogMembros de classe | Gráfico de hierarquia

Consulte tambémnbsp;CFileDialog:: DoModal, :: GetOpenFileName, :: GetSaveFileName, OPENFILENAME

Index