ListViewItem.ListViewSubItemCollection.AddRange Método

Definição

Adiciona uma matriz de subitens à coleção.Adds an array of subitems to the collection.

Sobrecargas

AddRange(String[])

Cria novos subitens com base em uma matriz e os adiciona à coleção.Creates new subitems based on an array and adds them to the collection.

AddRange(ListViewItem+ListViewSubItem[])

Adiciona uma matriz de objetos ListViewItem.ListViewSubItem à coleção.Adds an array of ListViewItem.ListViewSubItem objects to the collection.

AddRange(String[], Color, Color, Font)

Cria novos subitens com base em uma matriz e os adiciona à coleção com a fonte, cor da tela de fundo e cor de primeiro plano especificadas.Creates new subitems based on an array and adds them to the collection with specified foreground color, background color, and font.

AddRange(String[])

Cria novos subitens com base em uma matriz e os adiciona à coleção.Creates new subitems based on an array and adds them to the collection.

public:
 void AddRange(cli::array <System::String ^> ^ items);
public void AddRange (string[] items);
member this.AddRange : string[] -> unit
Public Sub AddRange (items As String())

Parâmetros

items
String[]

Uma matriz de cadeias de caracteres que representa o texto de cada subitem a ser adicionado à coleção.An array of strings representing the text of each subitem to add to the collection.

Comentários

Você pode usar essa versão do método AddRange para adicionar uma matriz de cadeias de caracteres à coleção, em que cada cadeia de caracteres na coleção representa o texto de um novo subitem.You can use this version of the AddRange method to add an array of strings to the collection, where each string in the collection represents the text of a new subitem. Você pode usar a outra versão do método AddRange que aceita uma matriz de cadeias de caracteres como um parâmetro para especificar a cor do primeiro plano, a cor do plano de fundo e a fonte para cada item que está sendo adicionado.You can use the other version of the AddRange method that accepts an array of strings as a parameter to specify the foreground color, background color, and font for each item being added. Se você quiser reutilizar os objetos ListViewItem.ListViewSubItem existentes e adicioná-los à coleção, poderá usar a versão do método AddRange que aceita uma matriz de objetos ListViewItem.ListViewSubItem como um parâmetro.If you want to reuse existing ListViewItem.ListViewSubItem objects and add them to the collection, you can use the version of the AddRange method that accepts an array of ListViewItem.ListViewSubItem objects as a parameter.

Se você quiser adicionar um único ListViewItem.ListViewSubItem, use o método Add.If you want to add a single ListViewItem.ListViewSubItem, use the Add method. Você também pode usar o método Insert se quiser adicionar um único ListViewItem.ListViewSubItem em uma posição específica na coleção.You can also use the Insert method if you want to add a single ListViewItem.ListViewSubItem at a specific position in the collection.

Veja também

AddRange(ListViewItem+ListViewSubItem[])

Adiciona uma matriz de objetos ListViewItem.ListViewSubItem à coleção.Adds an array of ListViewItem.ListViewSubItem objects to the collection.

public:
 void AddRange(cli::array <System::Windows::Forms::ListViewItem::ListViewSubItem ^> ^ items);
public void AddRange (System.Windows.Forms.ListViewItem.ListViewSubItem[] items);
member this.AddRange : System.Windows.Forms.ListViewItem.ListViewSubItem[] -> unit
Public Sub AddRange (items As ListViewItem.ListViewSubItem())

Parâmetros

items
ListViewItem.ListViewSubItem[]

Uma matriz de objetos ListViewItem.ListViewSubItem a serem adicionados à coleção.An array of ListViewItem.ListViewSubItem objects to add to the collection.

Comentários

Você pode usar esse método para reutilizar os subitens armazenados em um ListViewItemdiferente.You can use this method to reuse the subitems stored in a different ListViewItem. Se você quiser adicionar um único objeto ListViewItem.ListViewSubItem, use o método Add.If you want to add a single ListViewItem.ListViewSubItem object, use the Add method. Você também pode usar o método Insert se quiser adicionar um único ListViewItem.ListViewSubItem em uma posição específica na coleção.You can also use the Insert method if you want to add a single ListViewItem.ListViewSubItem at a specific position in the collection.

Veja também

AddRange(String[], Color, Color, Font)

Cria novos subitens com base em uma matriz e os adiciona à coleção com a fonte, cor da tela de fundo e cor de primeiro plano especificadas.Creates new subitems based on an array and adds them to the collection with specified foreground color, background color, and font.

public:
 void AddRange(cli::array <System::String ^> ^ items, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Drawing::Font ^ font);
public void AddRange (string[] items, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font font);
member this.AddRange : string[] * System.Drawing.Color * System.Drawing.Color * System.Drawing.Font -> unit

Parâmetros

items
String[]

Uma matriz de cadeias de caracteres que representa o texto de cada subitem a ser adicionado à coleção.An array of strings representing the text of each subitem to add to the collection.

foreColor
Color

Um Color que representa a cor de primeiro plano do subitem.A Color that represents the foreground color of the subitem.

backColor
Color

Um Color que representa a cor da tela de fundo do subitem.A Color that represents the background color of the subitem.

font
Font

Um Font que representa a face de tipos na qual exibir o texto do subitem.A Font that represents the typeface to display the subitem's text in.

Comentários

Você pode usar essa versão do método AddRange para adicionar uma matriz de cadeias de caracteres à coleção, em que cada cadeia de caracteres na coleção representa o texto de um novo subitem.You can use this version of the AddRange method to add an array of strings to the collection, where each string in the collection represents the text of a new subitem. Além disso, essa versão do método AddRange permite que você especifique a cor do primeiro plano, a cor do plano de fundo e a fonte de cada subitem.In addition, this version of the AddRange method allows you to specify the foreground color, background color, and font for each subitem. Você pode usar a outra versão do método AddRange que aceita uma matriz de cadeias de caracteres como um parâmetro se você não quiser especificar cor de primeiro plano, cor do plano de fundo e configurações de fonte para cada subitem.You can use the other version of the AddRange method that accepts an array of strings as a parameter if you do not want to specify foreground color, background color, and font settings for each subitem. Se você quiser reutilizar os objetos ListViewItem.ListViewSubItem existentes e adicioná-los à coleção, poderá usar a versão do método AddRange que aceita uma matriz de objetos ListViewItem.ListViewSubItem como um parâmetro.If you want to reuse existing ListViewItem.ListViewSubItem objects and add them to the collection, you can use the version of the AddRange method that accepts an array of ListViewItem.ListViewSubItem objects as a parameter.

Se você quiser adicionar um único ListViewItem.ListViewSubItem, use o método Add.If you want to add a single ListViewItem.ListViewSubItem, use the Add method. Você também pode usar o método Insert se quiser adicionar um único ListViewItem.ListViewSubItem em uma posição específica na coleção.You can also use the Insert method if you want to add a single ListViewItem.ListViewSubItem at a specific position in the collection.

Observação

Por padrão, os subitens usam a cor de primeiro plano, a cor do plano de fundo e a fonte especificada para o item pai.By default, subitems use the foreground color, background color, and font specified for the parent item. Defina a propriedade ListViewItem.UseItemStyleForSubItems como false para impedir que os estilos do item pai substituam os estilos do subitem.Set the ListViewItem.UseItemStyleForSubItems property to false to prevent the parent item styles from overriding the subitem styles.

Veja também

Aplica-se a