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 -> int
Public Function Add (item As Object) As Integer
Parâmetros
- item
- Object
Um objeto que representa o item a ser adicionado à coleção.
Retornos
O índice baseado em zero do item na coleção.
Exceções
O item parâmetro era null.
Comentários
Esse método adiciona um item à caixa de combinação. Se a Sorted propriedade do ComboBox conjunto 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. Ocorrerá SystemException 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 a repinção durante o suplemento e o EndUpdate método para retomar a repinização. Você pode usar o Insert método para especificar o local na lista em que um item é adicionado. Quando um objeto é adicionado à coleção, ele chama o ComboBox método do ToString objeto para obter a cadeia de caracteres a ser exibida na lista.