CComboBox::LimitText

Artigo
06/10/2015

Limitar o tamanho em bytes de texto que o usuário pode inserir o controle de edição de uma caixa de combinação.

BOOL LimitText( 
   int nMaxChars  
);

Parâmetros

nMaxChars
Especifica o comprimento (em bytes) de texto que o usuário pode inserir. Se esse parâmetro é 0, o tamanho do texto é definido como 65.535 bytes.

Valor de retorno

Diferente de zero se com êxito. Se chamado para uma caixa de combinação com o estilo CBS_DROPDOWNLIST ou para uma caixa de combinação sem um controle de edição, o valor de retorno é CB_ERR.

Comentários

Se a caixa de combinação não tem o estilo CBS_AUTOHSCROLL, definir o limite de texto para ser maior do que o tamanho do controle de edição não terá efeito.

LimitText limita apenas texto que o usuário pode inserir. Não tem efeito em qualquer texto já no controle de edição quando a mensagem é enviada, ou afeta o tamanho do texto copiado para o controle de edição quando uma cadeia de caracteres na caixa de seleção está selecionada.

Exemplo

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