Freigeben über


AfxFormatString1

Ersetzt die Zeichenfolge, die auf durch lpsz1 für alle Instanzen der Zeichen "%1" in der Vorlagenzeichenfolgenressource dargestellt wird, die von nIDS identifiziert wird.

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

Parameter

  • rString
    Ein Verweis auf einen CString-Objekt, das die resultierende Zeichenfolge enthält, nachdem der Ersatz ausgeführt wurde.

  • nIDS
    Das Ressourcen-ID der Vorlagenzeichenfolge, auf der der Ersatz ausgeführt wird.

  • lpsz1
    Eine Zeichenfolge, die die Formatzeichen "%1" in der Vorlagenzeichenfolge ersetzt.

Hinweise

Die neugeformte Zeichenfolge wird in rString gespeichert.Wenn die Zeichenfolge in der Zeichenfolgentabelle die Datei "%1" ist nicht gefunden, und lpsz1 ist gleich "C:\MYFILE.TXT", enthält rString die Zeichenfolge "C:\MYFILE.TXT" Datei nicht finden.Diese Funktion ist für die Formatierungszeichenfolgen nützlich, die zu Meldungsfeldern und zu anderen Fenstern gesendet werden.

Wenn die Formatzeichen "%1" in der Zeichenfolge mehrmals angezeigt werden, wird Unterstützung mehrerer Ersetzung gemacht.

Beispiel

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
}

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

AfxFormatString2

Konzepte

MFC-Makros und -globale Werte