ListView.ListViewItemCollection.Add Método

Origem:

ListView.ListViewItemCollection.cs

Origem:

ListView.ListViewItemCollection.cs

Origem:

ListView.ListViewItemCollection.cs

Origem:

ListView.ListViewItemCollection.cs

Origem:

ListView.ListViewItemCollection.cs

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text);

public virtual System.Windows.Forms.ListViewItem Add(string text);

public virtual System.Windows.Forms.ListViewItem Add(string? text);

abstract member Add : string -> System.Windows.Forms.ListViewItem
override this.Add : string -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (text As String) As ListViewItem

Parâmetros

Devoluções

Isso ListViewItem foi acrescentado à coleção.

Observações

Pode usar esta versão do Add método para criar um novo ListViewItem para adicionar a um ListView controlo. O texto do novo ListViewItem adicionado ao controlo baseia-se no text parâmetro. Se quiser especificar uma imagem para o item, use a versão do Add método que aceita um índice de imagem como parâmetro. Se tens um existente ListViewItem que queres adicionar à coleção, usa a versão do Add método que aceita a ListViewItem como parâmetro.

Se a ListView.Sorting propriedade for definida para um valor diferente de SortOrder.None ou se a ListViewItemSorter propriedade estiver definida, a lista é ordenada após a adição do item. Caso contrário, o item é inserido no final da lista. Se a lista não estiver ordenada, pode usar o Insert método para inserir um item numa ListView posição específica. Para adicionar um conjunto de itens ao controlo numa única operação, use o AddRange método. Se quiseres usar o Add método para adicionar um grande número de itens ao controlo, usa os BeginUpdate métodos e EndUpdate para evitar que eles ListView repintem até que todos os itens sejam adicionados. Ao adicionar itens a um ListView, é mais eficiente ordenar primeiro os itens e depois adicionar novos itens.

Ver também

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

Origem:

ListView.ListViewItemCollection.cs

Origem:

ListView.ListViewItemCollection.cs

Origem:

ListView.ListViewItemCollection.cs

Origem:

ListView.ListViewItemCollection.cs

Origem:

ListView.ListViewItemCollection.cs

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::Windows::Forms::ListViewItem ^ value);

public virtual System.Windows.Forms.ListViewItem Add(System.Windows.Forms.ListViewItem value);

abstract member Add : System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItem
override this.Add : System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (value As ListViewItem) As ListViewItem

Parâmetros

Devoluções

Isso ListViewItem foi acrescentado à coleção.

Observações

Pode usar esta versão do Add método para adicionar um existente ListViewItem à coleção. Esta versão do Add método é normalmente usada para reutilizar itens de outros ListView controlos ou, se for ListViewItem criado manualmente, antes de o adicionar à coleção. Se quiseres criar um novo ListViewItem em vez de usar um item já existente, usa as outras versões do Add método.

Se a ListView.Sorting propriedade for definida para um valor diferente de SortOrder.None ou se a ListViewItemSorter propriedade estiver definida, a lista é ordenada após a adição do item. Caso contrário, o item é inserido no final da lista. Se a lista não estiver ordenada, pode usar o Insert método para inserir um item numa ListView posição específica. Para adicionar um conjunto de itens ao controlo numa única operação, use o AddRange método. Se quiseres usar o Add método para adicionar um grande número de itens ao controlo, usa os BeginUpdate métodos e EndUpdate para evitar que eles ListView repintem até que todos os itens sejam adicionados. Ao adicionar itens a um ListView, é mais eficiente ordenar primeiro os itens e depois adicionar novos itens.

Esta versão do Add método também é usada para atribuir a ListViewItem a um ListViewGroup.

Ver também

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

Origem:

ListView.ListViewItemCollection.cs

Origem:

ListView.ListViewItemCollection.cs

Origem:

ListView.ListViewItemCollection.cs

Origem:

ListView.ListViewItemCollection.cs

Origem:

ListView.ListViewItemCollection.cs

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text, int imageIndex);

public virtual System.Windows.Forms.ListViewItem Add(string text, int imageIndex);

public virtual System.Windows.Forms.ListViewItem Add(string? text, int imageIndex);

abstract member Add : string * int -> System.Windows.Forms.ListViewItem
override this.Add : string * int -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (text As String, imageIndex As Integer) As ListViewItem

Parâmetros

Devoluções

Isso ListViewItem foi acrescentado à coleção.

Observações

Pode usar esta versão do Add método para criar um novo ListViewItem para adicionar ao ListView controlo. O texto do novo ListViewItem adicionado ao controlo baseia-se no text parâmetro. Também pode especificar uma imagem para o item passando o índice dos ImageList atribuídos às ListView.LargeImageList propriedades e ListView.SmallImageList para o imageIndex parâmetro. (Tipicamente, as ListView.LargeImageList propriedades e ListView.SmallImageList usam as mesmas posições de índice para exibir imagens relacionadas.) Se não quiser especificar um índice de imagem para o item, use a versão do Add método que aceita apenas uma cadeia como parâmetro. Se tens um existente ListViewItem que queres adicionar à coleção, usa a versão do Add método que aceita a ListViewItem como parâmetro.

Se a ListView.Sorting propriedade for definida para um valor diferente de SortOrder.None ou se a ListViewItemSorter propriedade estiver definida, a lista é ordenada após a adição do item. Caso contrário, o item é inserido no final da lista. Se a lista não estiver ordenada, pode usar o Insert método para inserir um item numa ListView posição específica. Para adicionar um conjunto de itens ao controlo numa única operação, use o AddRange método. Se quiseres usar o Add método para adicionar um grande número de itens ao controlo, usa os BeginUpdate métodos e EndUpdate para evitar que eles ListView repintem até que todos os itens sejam adicionados. Ao adicionar itens a um ListView, é mais eficiente ordenar primeiro os itens e depois adicionar novos itens.

Ver também

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

Origem:

ListView.ListViewItemCollection.cs

Origem:

ListView.ListViewItemCollection.cs

Origem:

ListView.ListViewItemCollection.cs

Origem:

ListView.ListViewItemCollection.cs

Origem:

ListView.ListViewItemCollection.cs

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text, System::String ^ imageKey);

public virtual System.Windows.Forms.ListViewItem Add(string text, string imageKey);

public virtual System.Windows.Forms.ListViewItem Add(string? text, string? imageKey);

abstract member Add : string * string -> System.Windows.Forms.ListViewItem
override this.Add : string * string -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (text As String, imageKey As String) As ListViewItem

Parâmetros

Devoluções

Eles ListViewItem acrescentaram à coleção.

Observações

Se for ListView ordenado, o item é adicionado na ordem correta; caso contrário, é adicionado ao final da coleção.

Origem:

ListView.ListViewItemCollection.cs

Origem:

ListView.ListViewItemCollection.cs

Origem:

ListView.ListViewItemCollection.cs

Origem:

ListView.ListViewItemCollection.cs

Origem:

ListView.ListViewItemCollection.cs

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ key, System::String ^ text, int imageIndex);

public virtual System.Windows.Forms.ListViewItem Add(string key, string text, int imageIndex);

public virtual System.Windows.Forms.ListViewItem Add(string? key, string? text, int imageIndex);

abstract member Add : string * string * int -> System.Windows.Forms.ListViewItem
override this.Add : string * string * int -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (key As String, text As String, imageIndex As Integer) As ListViewItem

Parâmetros

Devoluções

Eles ListViewItem acrescentaram à coleção.

Exceções

Observações

Se for ListView ordenado, o item é adicionado na ordem correta; caso contrário, é adicionado ao final da coleção. A Name propriedade corresponde à chave para um ListViewItem no ListView.ListViewItemCollection.

O Add método define a Name propriedade para a chave especificada, para que o item possa ser recuperado pelo seu índice ou por chave.

Origem:

ListView.ListViewItemCollection.cs

Origem:

ListView.ListViewItemCollection.cs

Origem:

ListView.ListViewItemCollection.cs

Origem:

ListView.ListViewItemCollection.cs

Origem:

ListView.ListViewItemCollection.cs

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ key, System::String ^ text, System::String ^ imageKey);

public virtual System.Windows.Forms.ListViewItem Add(string key, string text, string imageKey);

public virtual System.Windows.Forms.ListViewItem Add(string? key, string? text, string? imageKey);

abstract member Add : string * string * string -> System.Windows.Forms.ListViewItem
override this.Add : string * string * string -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (key As String, text As String, imageKey As String) As ListViewItem

Parâmetros

Devoluções

Eles ListViewItem acrescentaram à coleção.

Observações

A Name propriedade corresponde à chave para um ListViewItem no ListView.ListViewItemCollection.

Se for ListView ordenado, o item é adicionado na ordem correta; caso contrário, é adicionado ao final da coleção. O Add método define a Name propriedade do item para a chave especificada, para que o item possa ser recuperado pelo seu índice ou pela chave.