ComboBox.ObjectCollection.Add(Object) Método
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.
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.