CComboBox::LimitText

Artikel
06/10/2015

Beschränkt die Länge in Bytes des Texts ein, den der Benutzer in das Bearbeitungssteuerelement eines Kombinationsfelds eingeben kann.

BOOL LimitText( 
   int nMaxChars  
);

Parameter

nMaxChars
Gibt die Länge (in Bytes) des Textes an, den der Benutzer eingeben kann. Wenn dieser Parameter 0 ist, wird die Textlänge auf 65.535 Bytes festgelegt.

Rückgabewert

Ungleich 0 (null), wenn erfolgreich. Wenn es für ein Kombinationsfeld mit dem Format CBS_DROPDOWNLIST oder für ein Kombinationsfeld ohne ein Bearbeitungssteuerelement aufgerufen wird, ist der Rückgabewert CB_ERR.

Hinweise

Wenn das Kombinationsfeld nicht das Format CBS_AUTOHSCROLL verfügt, hat das Festlegen der Textgrenze, um als die Größe des Bearbeitungssteuerelements größer ist keine Auswirkungen.

LimitText schränkt nur den Text ein, den der Benutzer eingeben kann. Er hat keine Auswirkungen auf jeden Text bereits im Bearbeitungssteuerelement, wenn die Meldung gesendet wird, hat dies noch die Länge des Texts, der dem Bearbeitungssteuerelement kopiert wird, wenn eine Zeichenfolge im Listenfeld ausgewählt ist.

Beispiel

// Limit the number of characters in the combo box's edit control to 
// be the maximum number visible. 

// Get the text metrics for the combo box; needed for the 
// average character width.
TEXTMETRIC tm;
CDC* pDCCB = m_pComboBox->GetDC();
pDCCB->GetTextMetrics(&tm);
m_pComboBox->ReleaseDC(pDCCB);

CRect rect;
m_pComboBox->GetClientRect(&rect);

m_pComboBox->LimitText(rect.Width() / tm.tmAveCharWidth);