Propriedade ListIndex

Aplicável a

Você pode usar a propriedade ListIndex para determinar qual item é selecionado em um caixa de listagem ou caixa de combinação. Longo de leitura/gravação.

expressão.ListIndex

expressão Obrigatória. Uma expressão que retorna um dos objetos na lista Aplica-se a.

Comentários

A propriedade ListIndex é um inteiro entre 0 e o número total de itens em uma caixa de listagem ou caixa de combinação menos 1. O Access define o valor da propriedade ListIndex quando um item é selecionado numa caixa de listagem ou parte da caixa de listagem de uma caixa de combinação. O valor da propriedade ListIndex do primeiro item em uma lista é 0, o valor do segundo item é 1, e assim por diante.

Essa propriedade só está disponível usando um código Visual Basic for Applications (VBA) ou macro. Você só pode ler essa propriedade no modo Formulário e no modo Folha de Dados. Essa propriedade é somente leitura e não está disponível em outros modos de exibição.

O valor da propriedade ListIndex também está disponível definindo-se a propriedade BoundColumn como 0 para uma caixa de combinação ou caixa de listagem. Se a propriedade BoundColumn estiver definida como 0, o campo de tabela subjacente ao qual está associada a caixa de combinação ou a caixa de listagem conterá o mesmo valor que a configuração de propriedade ListIndex.

As caixas de listagem também têm uma propriedade MultiSelect que permite aos usuários selecionar vários itens a partir do controle. Quando várias seleções são feitas em uma caixa de listagem, você pode determinar quais itens são selecionados usando a propriedade Selected do controle. A propriedade Selected é uma matriz de valores de 0 ao valor da propriedade ListCount menos 1. Para cada item na caixa de listagem, a propriedade Selected será Verdadeiro se o item estiver selecionado e Falso se ele não estiver selecionado.

A coleção ItemsSelected também fornece uma maneira de acessar dados nas linhas selecionadas de uma caixa de listagem ou caixa de combinação.

Exemplo

Para retornar o valor da propriedade ListIndex, você pode usar o seguinte:

Dim l As Long
l = Forms(formname).Controls(controlname).ListIndex

Para configurar o valor da propriedade ListIndex, você pode usar o seguinte:

Forms(formname).Controls(controlname).SetFocus
Forms(formname).Controls(controlname).ListIndex = index

Em que formname e controlname são os nomes do formulário e caixa de listagem ou controle da caixa de combinação, respectivamente, expressos como valores Cadeia de caracteres, e índice é o valor de índice do item.