Partager via


AfxFormatString1

Remplace la chaîne vers laquelle pointe lpsz1 pour les instances de caractères " %1 " de la ressource de chaîne de modèle identifiée par nIDS.

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

Paramètres

  • rString
    Référence à un objet CString qui contient la chaîne résultante une fois la substitution effectuée.

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

  • lpsz1
    Chaîne qui remplacera des 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 le fichier « %1 » introuvable, et lpsz1 est égale à « C:\MYFILE.TXT", alors rString contiendra la chaîne « fichier C:\MYFILE.TXT introuvable ». Cette fonction est utile pour mettre en forme des chaînes envoyées aux boîtes de messages et d'autres fenêtres.

Si les caractères de format " %1 " s'affichent dans la chaîne à plusieurs reprises, 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