ComboBox.ObjectCollection.Add(Object) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Adiciona um item à lista de itens para um ComboBox.
public:
int Add(System::Object ^ item);public int Add (object item);member this.Add : obj -> intPublic Function Add (item As Object) As IntegerParâmetros
- item
- Object
Um objeto que representa o item a ser adicionado à coleção.
Retornos
O índice de base zero do item na coleção.
Exceções
O parâmetro item era null.
Comentários
Esse método adiciona um item à caixa de combinação. Se a Sorted propriedade do ComboBox for definida truecomo , o item será inserido na lista em ordem alfabética. Caso contrário, o item será inserido no final da lista.
Uma representação visual do item é exibida na caixa de combinação. Essa representação de conteúdo é especificada pela DisplayMember propriedade . Se a DisplayMember propriedade for null, o método do ToString item será chamado para obter a cadeia de caracteres exibida na caixa de combinação; caso contrário, a propriedade do objeto armazenado conforme especificado pela DisplayMember propriedade será exibida. Um SystemException ocorrerá se não houver espaço suficiente disponível para armazenar o novo item. Para adicionar um conjunto de itens à caixa de combinação, é melhor usar o AddRange método . Se você optar por usar o Add método para adicionar vários itens à caixa de combinação, use o BeginUpdate método para suspender o repositório durante a adição e o EndUpdate método para retomar o repositório. Você pode usar o Insert método para especificar o local na lista em que um item é adicionado. Quando um objeto é adicionado à coleção, o chama o ComboBox método do ToString objeto para obter a cadeia de caracteres a ser exibida na lista.
