ListBox.SelectedIndexCollection Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Representa a coleção que contém os índices dos itens selecionados num ListBox.
public: ref class ListBox::SelectedIndexCollection : System::Collections::IList
public class ListBox.SelectedIndexCollection : System.Collections.IList
type ListBox.SelectedIndexCollection = class
interface IList
interface ICollection
interface IEnumerable
Public Class ListBox.SelectedIndexCollection
Implements IList
- Herança
-
ListBox.SelectedIndexCollection
- Implementações
Exemplos
O exemplo seguinte demonstra como usar o FindString método para pesquisar todas as instâncias do texto de pesquisa nos itens do ListBox. O exemplo utiliza a versão do FindString método que permite especificar um índice de pesquisa inicial a partir do qual fazer uma pesquisa contínua de todos os itens do ListBox. O exemplo também demonstra como determinar quando o FindString método começa a procurar no topo da lista depois de chegar ao fundo da lista de itens, para evitar uma pesquisa recursiva. Uma vez que os itens são encontrados no ListBox, são selecionados usando o SetSelected método.
private:
void FindAllOfMyString( String^ searchString )
{
// Set the SelectionMode property of the ListBox to select multiple items.
listBox1->SelectionMode = SelectionMode::MultiExtended;
// Set our intial index variable to -1.
int x = -1;
// If the search string is empty exit.
if ( searchString->Length != 0 )
{
// Loop through and find each item that matches the search string.
do
{
// Retrieve the item based on the previous index found. Starts with -1 which searches start.
x = listBox1->FindString( searchString, x );
// If no item is found that matches exit.
if ( x != -1 )
{
// Since the FindString loops infinitely, determine if we found first item again and exit.
if ( listBox1->SelectedIndices->Count > 0 )
{
if ( x == listBox1->SelectedIndices[ 0 ] )
return;
}
// Select the item in the ListBox once it is found.
listBox1->SetSelected( x, true );
}
}
while ( x != -1 );
}
}
private void FindAllOfMyString(string searchString)
{
// Set the SelectionMode property of the ListBox to select multiple items.
listBox1.SelectionMode = SelectionMode.MultiExtended;
// Set our intial index variable to -1.
int x =-1;
// If the search string is empty exit.
if (searchString.Length != 0)
{
// Loop through and find each item that matches the search string.
do
{
// Retrieve the item based on the previous index found. Starts with -1 which searches start.
x = listBox1.FindString(searchString, x);
// If no item is found that matches exit.
if (x != -1)
{
// Since the FindString loops infinitely, determine if we found first item again and exit.
if (listBox1.SelectedIndices.Count > 0)
{
if(x == listBox1.SelectedIndices[0])
return;
}
// Select the item in the ListBox once it is found.
listBox1.SetSelected(x,true);
}
}while(x != -1);
}
}
Private Sub FindAllOfMyString(ByVal searchString As String)
' Set the SelectionMode property of the ListBox to select multiple items.
listBox1.SelectionMode = SelectionMode.MultiExtended
' Set our intial index variable to -1.
Dim x As Integer = -1
' If the search string is empty exit.
If searchString.Length <> 0 Then
' Loop through and find each item that matches the search string.
Do
' Retrieve the item based on the previous index found. Starts with -1 which searches start.
x = listBox1.FindString(searchString, x)
' If no item is found that matches exit.
If x <> -1 Then
' Since the FindString loops infinitely, determine if we found first item again and exit.
If ListBox1.SelectedIndices.Count > 0 Then
If x = ListBox1.SelectedIndices(0) Then
Return
End If
End If
' Select the item in the ListBox once it is found.
ListBox1.SetSelected(x, True)
End If
Loop While x <> -1
End If
End Sub
Observações
A ListBox.SelectedIndexCollection classe armazena os índices dos itens selecionados no ListBoxarquivo . Os índices armazenados em são ListBox.SelectedIndexCollection posições de índice dentro da ListBox.ObjectCollection classe. A ListBox.ObjectCollection classe armazena todos os itens exibidos no ListBoxarquivo .
A tabela seguinte é um exemplo de como armazena ListBox.ObjectCollection os itens do ListBox bem como os seus estados de seleção dentro de um exemplo ListBox.
| Index | Número | Estado de seleção dentro da ListBox |
|---|---|---|
| 0 | objeto1 | Não selecionado |
| 1 | objeto2 | Selecionado |
| 2 | objecto3 | Não selecionado |
| 3 | Objecto4 | Selecionado |
| 4 | object5 | Selecionado |
Com base no ListBox.ObjectCollection exemplo da tabela anterior, a tabela seguinte demonstra como o apareceria ListBox.SelectedIndexCollection .
| Index | Índice do item selecionado no ObjectCollection |
|---|---|
| 0 | 1 |
| 1 | 3 |
| 2 | 4 |
Pode usar as propriedades e métodos desta classe para realizar uma variedade de tarefas com a coleção. O Contains método permite-lhe determinar se uma posição de índice da ListBox.ObjectCollection classe pertence aos índices selecionados armazenados no ListBox.SelectedIndexCollection. Quando souber que o item está dentro da coleção, pode usar o IndexOf método para determinar onde uma posição ListBox.ObjectCollectionListBox específica do índice está armazenada.
Construtores
| Name | Description |
|---|---|
| ListBox.SelectedIndexCollection(ListBox) |
Inicializa uma nova instância da ListBox.SelectedIndexCollection classe. |
Propriedades
| Name | Description |
|---|---|
| Count |
Obtém o número de itens na coleção. |
| IsReadOnly |
Recebe um valor que indica se a coleção é apenas de leitura. |
| Item[Int32] |
Obtém o valor do índice no índice especificado dentro desta coleção. |
Métodos
| Name | Description |
|---|---|
| Add(Int32) |
Adiciona o ListBox na localização do índice especificada. |
| Clear() |
Remove todos os controlos da coleção. |
| Contains(Int32) |
Determina se o índice especificado está localizado dentro da coleção. |
| CopyTo(Array, Int32) |
Copia toda a coleção para um array existente num local especificado dentro do array. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetEnumerator() |
Devolve um enumerador para iterar pela coleção de índices selecionados. |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| IndexOf(Int32) |
Devolve o índice dentro do ListBox.SelectedIndexCollection do índice especificado a partir do ListBox.ObjectCollection de .ListBox |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| Remove(Int32) |
Remove o controlo especificado da coleção. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| ICollection.IsSynchronized |
Para uma descrição deste elemento, veja IsSynchronized. |
| ICollection.SyncRoot |
Para uma descrição deste elemento, veja SyncRoot. |
| IList.Add(Object) |
Para uma descrição deste elemento, veja Add(Object). |
| IList.Clear() |
Para uma descrição deste elemento, veja Clear(). |
| IList.Contains(Object) |
Para uma descrição deste elemento, veja Contains(Object). |
| IList.IndexOf(Object) |
Para uma descrição deste elemento, veja IndexOf(Object). |
| IList.Insert(Int32, Object) |
Para uma descrição deste elemento, veja Insert(Int32, Object). |
| IList.IsFixedSize |
Para uma descrição deste elemento, veja IsFixedSize. |
| IList.Item[Int32] |
Para uma descrição deste elemento, veja Item[Int32]. |
| IList.Remove(Object) |
Para uma descrição deste elemento, veja Remove(Object). |
| IList.RemoveAt(Int32) |
Para uma descrição deste elemento, veja RemoveAt(Int32). |
Métodos da Extensão
| Name | Description |
|---|---|
| AsParallel(IEnumerable) |
Permite a paralelização de uma consulta. |
| AsQueryable(IEnumerable) |
Converte um IEnumerable para um IQueryable. |
| Cast<TResult>(IEnumerable) |
Conjura os elementos de an IEnumerable para o tipo especificado. |
| OfType<TResult>(IEnumerable) |
Filtra os elementos de um IEnumerable com base num tipo especificado. |