Compartilhar via


CComboBox::LimitText

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

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe de CComboBox

Gráfico de hierarquia

CB_LIMITTEXT