Compartilhar via


AfxFormatString1

Substitui a cadeia de caracteres apontada por lpsz1 para todas as instâncias de caracteres “%1 " no recurso de cadeia de caracteres de modelo identificado por nIDS.

void AfxFormatString1(  CString& rString,  UINT nIDS,  LPCTSTR lpsz1 ); 

Parâmetros

  • rString
    Uma referência a um objeto de CString que contém a cadeia de caracteres resultante depois que a substituição é executada.

  • nIDS
    A identificação de recurso de cadeia de caracteres do modelo em que a substituição será executada.

  • lpsz1
    Uma cadeia de caracteres que substitui os caracteres de formato “%1 " na cadeia de caracteres do modelo.

Comentários

A cadeia de caracteres recentemente formada é armazenada em rString.Por exemplo, se a cadeia de caracteres na tabela de cadeia de caracteres “é Arquivo %1” não encontrado, e lpsz1 é igual a “C:\MYFILE.TXT”, então rString conterá a cadeia de caracteres “C:\MYFILE.TXT Arquivo não foi encontrado.”Essa função é útil para formatar cadeias de caracteres enviadas às caixas de mensagem e outras janelas.

Se os caracteres de formato “%1 " aparece na cadeia de caracteres mais de uma vez, várias alternativas serão feitos.

Exemplo

void DisplayFileNotFoundMessage(LPCTSTR pszFileName)
{
   CString strMessage;

   // The IDS_FILENOTFOUND string resource contains "Error: File %1 not found"
   AfxFormatString1(strMessage, IDS_FILENOTFOUND, pszFileName);
   // In the previous call, substitute the actual file name for the
   // %1 placeholder
   AfxMessageBox(strMessage);  // Display the error message
}

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

AfxFormatString2

Conceitos

Globais e Macros do MFC