Partager via


AfxFormatString1

Remplace la chaîne pointée pointe vers lpsz1 pour toutes les instances des caractères « %1 " dans la ressource de type chaîne en modèle identifiée par nIDS.

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

Paramètres

  • rString
    Une référence à un objet d' CString qui contiendra la chaîne résultante après la substitution soit exécutée.

  • nIDS
    L'ID de ressource de chaîne de modèle sur lequel la substitution est exécutée.

  • lpsz1
    Une chaîne qui remplace les caractères de format « %1 " dans la chaîne de modèle.

Notes

La chaîne récemment formée est stockée dans rString.Par exemple, si la chaîne dans la table de chaînes est « fichier %1 introuvable », et lpsz1 est égal à « C:\MYFILE.TXT », puis rString contient la chaîne « fichier C:\MYFILE.TXT introuvable ».Cette fonction est utile pour mettre en forme des chaînes envoyées dans les messages et d'autres fenêtres.

Si les caractères de format « %1 " apparaissent dans la chaîne plusieurs fois, plusieurs substitutions sont effectuées.

Exemple

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
}

Configuration requise

En-tête : afxwin.h

Voir aussi

Référence

AfxFormatString2

Concepts

Macro MFC et Globals