CEdit::LimitText

發行項
02/28/2013

呼叫此函式以限制使用者可輸入 Edit 控制項文字的長度。

void LimitText(
   int nChars = 0 
);

參數

nChars
指定的長度 (以位元組為單位使用者輸入的文字。如果這個參數為 0 時，文字長度設定為 UINT_MAX 位元組。這是預設行為。

備註

變更文字要求限制使用者輸入的文字。對於任何文字效果已經在編輯控制項，也不會影響文字的長度會複製到編輯控制項所在的 CWndSetWindowText 成員函式。如果應用程式會在 [ LimitText的使用 SetWindowText 函式放置多個文字放入編輯控制項呼叫，指定使用者可以刪除任何在編輯控制項中的文字。不過，除非，刪除目前選取範圍建立文字切換到 XML 文字，文字限制會防止使用者取代現有的文字與新文字。

注意事項
在 Win32 (Windows NT 和 Windows 95 /98)， SetLimitText 取代這個函式。

如需詳細資訊，請參閱 Windows SDK的 EM_LIMITTEXT 。

範例

// Limit the number of characters to be the maximum number visible.

// Get the text metrics for the edit; needed for the
// average character width.
TEXTMETRIC tm;
CDC* pDC = m_myEdit.GetDC();
pDC->GetTextMetrics(&tm);
m_myEdit.ReleaseDC(pDC);

CRect r;
m_myEdit.GetRect(&r);
m_myEdit.LimitText(r.Width()/tm.tmAveCharWidth);