Partilhar via


CListBox::SetCaretIndex

Define o retângulo de foco para o item no índice especificado em uma caixa de listagem múltipla seleção.

int SetCaretIndex(
   int nIndex,
   BOOL bScroll = TRUE 
);

Parâmetros

  • nIndex
    Especifica o índice com base zero de item para receber o retângulo de foco na caixa de listagem.

  • bScroll
    Se esse valor é 0, o item é rolado até que seja totalmente visível.Se esse valor não é 0, o item é rolado até que seja pelo menos parcialmente visível.

Valor de retorno

LB_ERR se ocorrer um erro.

Comentários

Se o item não estiver visível, esteja rolado no modo.

Exemplo

// Set the caret to be the middle item.
m_myListBox.SetCaretIndex(m_myListBox.GetCount()/2);
ASSERT(m_myListBox.GetCaretIndex() == m_myListBox.GetCount()/2);

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe de CListBox

Gráfico de hierarquia

CListBox::GetCaretIndex

LB_SETCARETINDEX