CComboBox::LimitText

Artigo
08/25/2010

Limita o comprimento em bytes do texto que o usuário pode inserir no controle de edição de uma caixa de combinação.

BOOL LimitText(
   int nMaxChars 
);

Parâmetros

nMaxChars
Especifica o comprimento (em bytes) do que o usuário pode digitar texto.Se este parâmetro for 0, o comprimento do texto é definido como 65.535 bytes.

Valor de retorno

Diferente de zero se for bem-sucedido.Se a chamada para uma caixa de combinação com o estilo de CBS_DROPDOWNLIST ou de uma caixa de combinação sem um controle de edição, o valor retornado é CB_ERR.

Comentários

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

LimitText limita o texto que o usuário pode digitar apenas. Ele não tem efeito sobre qualquer texto já no controle de edição quando a mensagem é enviada, nem afeta o tamanho do texto copiado para o controle de edição quando uma seqüência de caracteres em caixa de listagem estiver 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);