CEdit::LimitText

Artikel
02/26/2013

Rufen Sie diese Funktion auf, um die Länge des Texts einzuschränken, die der Benutzer möglicherweise in ein Bearbeitungssteuerelement eingeben.

void LimitText(
   int nChars = 0 
);

Parameter

nChars
Gibt die Länge (in Bytes) des Textes an, den der Benutzer eingeben kann.Wenn dieser Parameter 0 ist, wird die Textlänge zu UINT_MAX Bytes festgelegt.Dies ist das Standardverhalten.

Hinweise

Die Textgrenze ändern, schränkt nur den Text ein, den der Benutzer eingeben kann.Es hat keine Auswirkungen auf jeden Text bereits im Bearbeitungssteuerelement, wirkt sich dies noch die Länge des Texts, der dem Bearbeitungssteuerelement durch die SetWindowText-Memberfunktion in CWnd kopiert wird.Wenn eine Anwendung die SetWindowText-Funktion verwendet, um mehr Text in ein Bearbeitungssteuerelement zu platzieren, als im Aufruf von LimitText angegeben wird, kann der Benutzer eines des Texts innerhalb des Bearbeitungssteuerelements löschen.aber trotzdem die Textgrenze den Benutzer beim Ersetzen des vorhandenen Text mit neuem Text, es sei denn, das Löschen der aktuellen Auswahl den Text bewirkt, dass unter die Textgrenze zu ab.

Hinweis
In Win32 (Windows NT und Windows 95/98), ersetzt SetLimitText diese Funktion.

Weitere Informationen finden Sie unter EM_LIMITTEXT in Windows SDK.

Beispiel

// 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);