Método ListBox.RemoveItem (Access)

Remove um item da lista de valores exibida pelo controle caixa de listagem especificado.

Sintaxe

expressão. RemoveItem (Índice)

Expressão Uma variável que representa um objeto ListBox .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Índice Obrigatório Variant O item a ser removido da lista, expresso como um número ou texto de item.

Comentários

Esse método só será válido para controles de caixa combinação ou caixa de lista em formulários. Além disso, a propriedade RowSourceType do controle deve ser definida como Lista de Valores.

Lista números de item que começam do zero. Se o valor do argumento Index não corresponder a um número de item existente ou ao texto de um item existente, ocorrerá um erro.

Use o método AddItem para adicionar itens à lista de valores.

Exemplo

Este exemplo remove o item especificado da lista em um controle de caixa de listagem. Para a função funcione, você deve passar a ela um objeto de ListBox representando um controle de caixa de listagem em um formulário e um valor Variant que representa o item a ser removido.

Function RemoveListItem(ctrlListBox As ListBox, _ 
 ByVal varItem As Variant) As Boolean 
 
 ' Trap for errors. 
 On Error GoTo ERROR_HANDLER 
 
 ' Remove the list box item and set the return value 
 ' to True, indicating success. 
 ctrlListBox.RemoveItem Index:=varItem 
 RemoveListItem = True 
 
 ' Reset the error trap and exit the function. 
 On Error GoTo 0 
 Exit Function 
 
' Return False if an error occurs. 
ERROR_HANDLER: 
 RemoveListItem = False 
 
End Function

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.