AfxFormatString1
Carrega o recurso de seqüência de caracteres especificada e substitui os caracteres "% 1" para a seqüência de caracteres apontada porlpsz1.
void AfxFormatString1(
CString& rString,
UINT nIDS,
LPCTSTR lpsz1
);
Parâmetros
rString
Uma referência a um CString objeto que irá conter a seqüência de caracteres resultante após a substituição.nIDS
A ID de recurso da seqüência de caracteres do modelo no qual a substituição será executada.lpsz1
Uma seqüência de caracteres que substituirá o formato de caracteres "% 1" na seqüência de caracteres de modelo.
Comentários
A seqüência de caracteres recém-criada é armazenada no rString. Por exemplo, se a seqüência de caracteres na tabela de seqüência de caracteres é "Arquivo %1 não encontrado", elpsz1é igual a "C:\MYFILE.TXT", em seguida rStringirá conter a seqüência de caracteres "Arquivo C:\MYFILE.TXT não encontrado". Essa função é útil para formatação de seqüências de caracteres enviadas para outras janelas e caixas de mensagem.
Se os caracteres de formato "% 1" aparecem na seqüência de caracteres mais de uma vez, serão feitas várias substituições.
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