ComboBox.ObjectCollection.Add(Object) Método

Definição

Adiciona um item à lista de itens para um ComboBox.

public:
 int Add(System::Object ^ item);
public int Add(object item);
member this.Add : obj -> int
Public Function Add (item As Object) As Integer

Parâmetros

item
Object

Um objeto que representa o item para adicionar à coleção.

Devoluções

O índice base zero do item na coleção.

Exceções

O item parâmetro era null.

Observações

Este método adiciona um item à caixa de combo. Se a Sorted propriedade de o ComboBox for definida como true, o item é inserido na lista alfabeticamente. Caso contrário, o item é inserido no final da lista.

Uma representação visual do item é exibida na caixa combinada. Esta representação do conteúdo é especificada pela DisplayMember propriedade. Se a DisplayMember propriedade for null, o método do ToString item é chamado para obter a cadeia que é exibida na caixa combinada; caso contrário, a propriedade do objeto armazenado conforme especificado pela DisplayMember propriedade é exibida. A SystemException ocorre se não houver espaço suficiente disponível para armazenar o novo item. Para adicionar um conjunto de itens à caixa de combo, é melhor usar o AddRange método. Se optares por usar o Add método para adicionar vários itens à caixa combinada, usa o BeginUpdate método para suspender a repintura durante o anúncio e o EndUpdate método para retomar a repintura. Pode usar o Insert método para especificar a localização na lista onde um item é adicionado. Quando um objeto é adicionado à coleção, chama ComboBox o método do ToString objeto para obter a string a mostrar na lista.

Aplica-se a

Ver também