Compartir a través de


CListBox::SelectString

Busca un elemento del cuadro de lista que coincide con la cadena especificada y, si se encuentra un elemento correspondiente, selecciona el elemento.

int SelectString( 
   int nStartAfter, 
   LPCTSTR lpszItem  
);

Parámetros

  • nStartAfter
    Contiene el índice de base cero del elemento antes del primer elemento que se buscará. Cuando la búsqueda alcanza el final del cuadro de lista, continúa desde la parte superior del cuadro de lista de nuevo al elemento especificado por nStartAfter. si es nStartAfter – 1, el cuadro de lista completo se busca desde el principio.

  • lpszItem
    Apunta a la cadena terminada en null para la que contiene el prefijo para buscar. La búsqueda no se distingue mayúsculas y minúsculas, por lo que esta cadena puede contener cualquier combinación de mayúsculas y minúsculas.

Valor devuelto

El índice del elemento seleccionado si la búsqueda se realizó correctamente. Si la búsqueda fue incorrecta, el valor devuelto es LB_ERR y la selección actual no cambia.

Comentarios

El cuadro de lista se desplaza en caso necesario, para colocar el elemento seleccionado en la vista.

Esta función miembro no se puede utilizar con un cuadro de lista con el estilo de LBS_MULTIPLESEL .

Un elemento se selecciona únicamente si su coincidencia inicial de caracteres (el punto inicial) que los caracteres de la cadena especificada por lpszItem.

Utilice la función miembro de FindString para buscar una cadena sin la selección del elemento.

Ejemplo

// The string to match.
LPCTSTR lpszmyString = _T("item 5");

// Select the item that begins with the specified string. 
int nIndex = m_myListBox.SelectString(0, lpszmyString);
ASSERT(nIndex != LB_ERR);

Requisitos

encabezado: afxwin.h

Vea también

Referencia

CListBox Class

Gráfico de jerarquías

CListBox::FindString

LB_SELECTSTRING