Compartir a través de


AfxFormatString1

Sustituye la cadena indicada por a lpsz1 para cualquier instancia de los caracteres “%1 " en el recurso de cadena de la plantilla identificado por nIDS.

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

Parámetros

  • rString
    Una referencia a un objeto de CString que contendrá la cadena resultante después de realizar la sustitución.

  • nIDS
    El Id. de recurso de la cadena de la plantilla en la que la sustitución se realizará.

  • lpsz1
    Una cadena que reemplazará los caracteres de formato “%1" en la cadena de la plantilla.

Comentarios

La cadena recién formado se almacena en rString. Por ejemplo, si la cadena en la tabla de cadenas es “archivo %1 no encontrado”, y lpsz1 es igual a “C:\MYFILE.TXT", a rString contendrá la cadena “archivo C:\MYFILE.TXT no encontrado”. Esta función resulta útil para dar formato a las cadenas enviadas a los cuadros de mensaje y a otras ventanas.

Si los caracteres de formato “%1 " aparecen en la cadena más de una vez, las sustituciones varios se crearán.

Ejemplo

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

Encabezado: afxwin.h

Vea también

Referencia

AfxFormatString2

Conceptos

Macros y variables globales de MFC