Partilhar via


ListViewItem.ListViewSubItemCollection.AddRange Método

Definição

Adiciona uma matriz de subitens à coleção.

Sobrecargas

AddRange(String[])

Cria novos subitens com base em uma matriz e os adiciona à coleção.

AddRange(ListViewItem+ListViewSubItem[])

Adiciona uma matriz de objetos ListViewItem.ListViewSubItem à coleção.

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.

AddRange(String[])

Cria novos subitens com base em uma matriz e os adiciona à coleção.

public:
 void AddRange(cli::array <System::String ^> ^ items);
public:
 void AddRange(... cli::array <System::String ^> ^ items);
public void AddRange (string[] items);
public void AddRange (params string[] items);
member this.AddRange : string[] -> unit
Public Sub AddRange (items As String())
Public Sub AddRange (ParamArray 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.

Comentários

Você pode usar essa versão do AddRange método 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. Você pode usar a outra versão do método que aceita uma matriz de cadeias de caracteres como um parâmetro para especificar a cor do primeiro plano, a cor da AddRange tela de fundo e a fonte para cada item que está sendo adicionado. Se você quiser reutilizar objetos existentes ListViewItem.ListViewSubItem e adicioná-los à coleção, poderá usar a versão do AddRange método que aceita uma matriz de ListViewItem.ListViewSubItem objetos como um parâmetro.

Se você quiser adicionar um único ListViewItem.ListViewSubItem, use o Add método . Você também pode usar o Insert método se quiser adicionar um único ListViewItem.ListViewSubItem em uma posição específica na coleção.

Confira também

Aplica-se a

AddRange(ListViewItem+ListViewSubItem[])

Adiciona uma matriz de objetos ListViewItem.ListViewSubItem à coleção.

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

Parâmetros

items
ListViewItem.ListViewSubItem[]

Uma matriz de objetos ListViewItem.ListViewSubItem a serem adicionados à coleção.

Comentários

Você pode usar esse método para reutilizar os subitems armazenados em um diferente ListViewItem. Se você quiser adicionar um único ListViewItem.ListViewSubItem objeto, use o Add método . Você também pode usar o Insert método se quiser adicionar um único ListViewItem.ListViewSubItem em uma posição específica na coleção.

Confira também

Aplica-se a

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.

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
Public Sub AddRange (items As String(), foreColor As Color, backColor As Color, font As Font)

Parâmetros

items
String[]

Uma matriz de cadeias de caracteres que representa o texto de cada subitem a ser adicionado à coleção.

foreColor
Color

Um Color que representa a cor de primeiro plano do subitem.

backColor
Color

Um Color que representa a cor da tela de fundo do subitem.

font
Font

Um Font que representa a face de tipos na qual exibir o texto do subitem.

Comentários

Você pode usar essa versão do AddRange método 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. Além disso, essa versão do AddRange método permite que você especifique a cor do primeiro plano, a cor da tela de fundo e a fonte para cada subitem. Você pode usar a outra versão do método que aceita uma matriz de cadeias de caracteres como um parâmetro se não quiser especificar a cor do primeiro plano, a cor da AddRange tela de fundo e as configurações de fonte para cada subitem. Se você quiser reutilizar objetos existentes ListViewItem.ListViewSubItem e adicioná-los à coleção, poderá usar a versão do AddRange método que aceita uma matriz de ListViewItem.ListViewSubItem objetos como um parâmetro.

Se você quiser adicionar um único ListViewItem.ListViewSubItem, use o Add método . Você também pode usar o Insert método se quiser adicionar um único ListViewItem.ListViewSubItem em uma posição específica na coleção.

Observação

Por padrão, os subitens usam a cor do primeiro plano, a cor da tela de fundo e a fonte especificadas para o item pai. Defina a ListViewItem.UseItemStyleForSubItems propriedade como false para impedir que os estilos de item pai substituam os estilos de subitem.

Confira também

Aplica-se a