CString 格式化和消息框顯示

提供數個函式來格式化和剖析 CString 物件。 每當您必須操作 CString 物件時，就可以使用這些函式，但對於格式化會出現在消息框文字中的字串特別有用。

此函式群組也包含用來顯示消息框的全域例程。

CString 功能

名稱	描述
AfxExtractSubString	從指定的來源字串擷取以單一字元分隔的子字串。
AfxFormatString1	以字串資料表中包含的字串中的格式字元%1 取代指定的字串。
AfxFormatString2	在字串數據表中包含的字串中，以兩個字串取代格式字元 「%1」 和 「%2」。
AfxMessageBox	顯示訊息方塊。

需求

頁眉 afxwin.h

AfxExtractSubString

這個全域函式可用來從指定的來源字串擷取子字串。

BOOL AFXAPI AfxExtractSubString (
    CString& rString,
    LPCTSTR lpszFullString,
    int iSubString,
    TCHAR chSep  = '\n');

參數

rString
CString將接收個別子字串之對象的參考。

lpszFullString
包含要從中擷取之字串全文的字串。

iSubString
要從 lpszFullString擷取之子字串之以零起始的索引。

chSep
用來分隔子字串的分隔符。

傳回值

TRUE 如果函式已成功擷取所提供索引處的子字串，則為 ;否則為 FALSE。

備註

當已知的單一字元分隔每個子字串時，此函式適用於從來源字串擷取多個子字串。 每次呼叫參數時， lpszFullString 此函式都會從參數的開頭搜尋。

如果 設定為 NULL 或函式到達 結尾lpszFullString，但找不到iSubString指定分隔符的 +1 次，則此函式會傳回 FALSE 。lpszFullString rString如果 lpszFullString 設定為 NULL，則參數將不會從其原始值修改;否則，如果無法擷取指定索引的子字串，rString參數就會設定為空字串。

範例

// The following example extracts a series of name, value pairs from a
// given source string:

// Input string consisting of a number of name, value pairs
LPCTSTR lpszSource = _T("\"Name\"=\"John Smith\"\n")
_T("\"Company\"=\"Contoso, Ltd\"\n\"Salary\"=\"25,000\"");

CString strNameValue; // an individual name, value pair

int i = 0; // substring index to extract
while (AfxExtractSubString(strNameValue, lpszSource, i))
{
   // Prepare to move to the next substring
   i++;

   CString strName, strValue; // individual name and value elements

   // Attempt to extract the name element from the pair
   if (!AfxExtractSubString(strName, strNameValue, 0, _T('=')))
   {
      // Pass an error message to the debugger for display
      OutputDebugString(_T("Error extracting name\r\n"));
      continue;
   }

   // Attempt to extract the value element from the pair
   if (!AfxExtractSubString(strValue, strNameValue, 1, _T('=')))
   {
      // Pass an error message to the debugger for display
      OutputDebugString(_T("Error extracting value element\r\n"));
      continue;
   }

   // Pass the name, value pair to the debugger for display
   CString strOutput = strName + _T(" equals ") + strValue + _T("\r\n");
   OutputDebugString(strOutput);
}

需求

頁眉 afxwin.h

AfxFormatString1

將所指向lpsz1的字串取代為 所識別nIDS之範本字串資源中的任何字元"%1"實例。

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

參數

rString
CString 物件的參考，在執行替代之後將會包含結果字串。

nIDS
要執行替代作業之範本字串的資源 ID。

lpsz1
字串，將取代範本字串中的格式字元 "%1" 。

備註

新格式的字串會儲存在 中 rString。 例如，如果字串資料表中的字串是 "File %1 not found"，且 lpsz1 等於 "C:\MYFILE.TXT"，則 rString 會包含字串 "File C:\MYFILE.TXT not found"。 此函式在為傳送到訊息方塊和其他視窗的字串進行格式化時，便可派上用場。

如果格式字元 "%1" 多次出現在字串中，則會進行多個替代。

範例

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
}

需求

頁眉 afxwin.h

AfxFormatString2

在所識別nIDS的範本字串資源中，將所指向lpsz1的字串取代為字元的任何實例"%1"，以及所指向lpsz2的"%2"字串。

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

參數

rString
的 CString 參考，這個參考會在執行替代之後包含結果字串。

nIDS
將執行替代之範本字串的字串數據表標識碼。

lpsz1
字串，將取代範本字串中的格式字元 "%1" 。

lpsz2
字串，將取代範本字串中的格式字元 "%2" 。

備註

新格式的字串會儲存在 中 rString。 例如，如果字串資料表中的字串是 ，則指向 "MYFILE.TXT"，而lpsz2指向 "C:\MYDIR"，則會rString包含字串 "File MYFILE.TXT not found in directory C:\MYDIR"。lpsz1"File %1 not found in directory %2"

如果格式字元 "%1" 或 "%2" 出現在字串中一次以上，則會進行多個替代。 它們不一定以數值順序排列。

範例

void DisplayFileNotFoundMessage(LPCTSTR pszFileName, LPCTSTR pszDirectory)
{
   CString strMessage;

   // The IDS_FILENOTFOUND string resource contains "Error: File %1 not 
   // found in directory %2"
   AfxFormatString2(strMessage, IDS_FILENOTFOUND2, pszFileName, pszDirectory);
   // In the previous call, substitute the actual file and directory 
   // names into the message string
   AfxMessageBox(strMessage);  // Display the error message
}

需求

頁眉 afxwin.h

AfxMessageBox

在螢幕上顯示消息框。

int AfxMessageBox(
    LPCTSTR lpszText,
    UINT nType = MB_OK,
    UINT nIDHelp = 0);

int AFXAPI AfxMessageBox(
    UINT nIDPrompt,
    UINT nType = MB_OK,
    UINT nIDHelp = (UINT) -1);

參數

lpszText
CString指向物件或以 Null 結束的字串，其中包含要顯示在消息框中的訊息。

nType
消息框的樣式。 將任何 消息框樣式 套用至方塊。

nIDHelp
訊息的說明內容識別碼;0 表示將使用應用程式的預設 [說明] 內容。

nIDPrompt
用來參考字串數據表中字串的唯一標識符。

傳回值

如果記憶體不足而無法顯示消息框，則為零;否則，會傳回下列其中一個值：

• IDABORT 已選取 [中止] 按鈕。

• IDCANCEL 已選取 [取消] 按鈕。

• IDIGNORE 已選取 [忽略] 按鈕。

• IDNO 已選取 [無] 按鈕。

• IDOK 已選取 [確定] 按鈕。

• IDRETRY 已選取 [重試] 按鈕。

• IDYES 已選取 [是] 按鈕。

如果消息框有 [取消] 按鈕， IDCANCEL 則會在按下 ESC 鍵或選取 [取消] 按鈕時傳回值。 如果消息框沒有 [取消] 按鈕，按下 ESC 鍵就沒有作用。

AfxFormatString1函式和 AfxFormatString2 可用於格式化出現在消息框中的文字。

備註

此多載函式的第一種形式會顯示消息框中所指向 lpszText 的文字字串，並使用 nIDHelp 來描述說明內容。 當使用者按下 [說明] 鍵 （通常是 F1） 時，會使用 [說明] 內容跳至相關聯的 [說明] 主題。

函式的第二種形式會使用標識碼為 nIDPrompt 的字串資源，在消息框中顯示訊息。 相關聯的 [說明] 頁面可透過 的值 nIDHelp找到。 如果使用的預設值 nIDHelp （-1），字串資源標識符 nIDPrompt會用於 [說明] 內容。 如需定義說明內容的詳細資訊，請參閱 技術附註 28。

範例

// A simple message box, with only the OK button.
AfxMessageBox(_T("Simple message box."));

// A message box that uses a string from a string table
// with yes and no buttons and the stop icon.
// NOTE: nStringID is an integer that contains a valid id of
// a string in the current resource.
AfxMessageBox(nStringID, MB_YESNO | MB_ICONSTOP);

另請參閱

宏和全域
CStringT 類