Compartilhar via


CFileFind::GetFileName

Chamar essa função de membro para obter o nome do arquivo encontrado.

virtual CString GetFileName( ) const;

Valor de retorno

O nome do arquivo mais-recente- encontrado.

Comentários

Você deve chamar FindNextFile pelo menos uma vez antes de chamar GetFileName.

GetFileName é uma das três funções de membro de CFileFind que retornam alguma forma de nome de arquivo. A lista a seguir descreve os três e como variam:

  • GetFileName retorna o nome de arquivo, incluindo a extensão. Por exemplo, chamando GetFileName para gerar uma mensagem de usuário no arquivo c:\myhtml\myfile.txt retorna o nome de arquivo myfile.txt.

  • GetFilePath retorna o caminho completo para o arquivo. Por exemplo, chamando GetFilePath para gerar uma mensagem de usuário no arquivo c:\myhtml\myfile.txt retorna o caminho do arquivo c:\myhtml\myfile.txt.

  • GetFileTitle retorna o nome de arquivo, excluindo de extensão de arquivo. Por exemplo, chamando GetFileTitle para gerar uma mensagem de usuário no arquivo c:\myhtml\myfile.txtretorna o título myfiledo arquivo.

Exemplo

CFileFind finder;
static const TCHAR szFileToFind[] = _T("C:\\WINDOWS\\SYSTEM.INI");

BOOL bResult = finder.FindFile(szFileToFind);

if (bResult)
{
   finder.FindNextFile();

   TRACE(_T("Root of %s is %s\n"), szFileToFind, 
      (LPCTSTR)finder.GetRoot());

   TRACE(_T("Title of %s is %s\n"), szFileToFind, 
      (LPCTSTR)finder.GetFileTitle());

   TRACE(_T("Path of %s is %s\n"), szFileToFind,
      (LPCTSTR)finder.GetFilePath());

   TRACE(_T("URL of %s is %s\n"), szFileToFind,
      (LPCTSTR)finder.GetFileURL());

   TRACE(_T("Name of %s is %s\n"), szFileToFind,
      (LPCTSTR)finder.GetFileName());

   finder.Close();
}
else
{
   TRACE(_T("You have no %s file.\n"), szFileToFind);
}

Saída

Assume que o arquivo C:\WINDOWS\SYSTEM.INI existe:

Root of C:\WINDOWS\SYSTEM.INI is C:\WINDOWS

Title of C:\WINDOWS\SYSTEM.INI is SYSTEM

Path of C:\WINDOWS\SYSTEM.INI is C:\WINDOWS\SYSTEM.INI

URL of C:\WINDOWS\SYSTEM.INI is file://C:\WINDOWS\SYSTEM.INI

Name of C:\WINDOWS\SYSTEM.INI is SYSTEM.INI

Requisitos

Cabeçalho: afx.h

Consulte também

Referência

Classe CFileFind

Gráfico da hierarquia

CFileFind::FindFile