Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo ListView.ColumnHeaderCollection.Add (String, Int32, HorizontalAlignment)

 

Data di pubblicazione: ottobre 2016

Aggiunge un'intestazione di colonna alla raccolta con il testo specificato, la larghezza e impostazioni di allineamento.

Spazio dei nomi:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public virtual ColumnHeader Add(
	string text,
	int width,
	HorizontalAlignment textAlign
)

Parametri

text
Type: System.String

Il testo da visualizzare nell'intestazione di colonna.

width
Type: System.Int32

Larghezza iniziale dell'intestazione di colonna.

textAlign
Type: System.Windows.Forms.HorizontalAlignment

Uno dei valori di HorizontalAlignment.

Valore restituito

Type: System.Windows.Forms.ColumnHeader

Il ColumnHeader che è stato creato e aggiunto alla raccolta.

È possibile utilizzare questa versione di Add per creare un nuovo metodo ColumnHeader da aggiungere alla raccolta. Il testo del nuovo ColumnHeader aggiunto per il controllo è basato sul text parametro. Questa versione di Add metodo consente inoltre di specificare la larghezza della colonna e l'allineamento del testo nell'intestazione di colonna. Se si dispone di un oggetto esistente ColumnHeader che si desidera aggiungere alla raccolta, utilizzare la versione di Add metodo che accetta un ColumnHeader come parametro.

Quando si aggiungono le intestazioni di colonna, vengono aggiunti alla fine della raccolta. Per inserire un'intestazione di colonna nella raccolta in una posizione specifica, utilizzare il Insert metodo. Per aggiungere un set di intestazioni di colonna alla raccolta in un'unica operazione, utilizzare il AddRange metodo.

L'esempio di codice seguente crea un ListView controllo con tre ListViewItem oggetti specificati e tre ListViewItem.ListViewSubItem oggetti specificati per ogni elemento. Nell'esempio viene creata anche ColumnHeader oggetti da visualizzare gli elementi secondari nella visualizzazione dei dettagli. Due ImageList gli oggetti vengono creati anche nell'esempio di codice per fornire immagini per il ListViewItem oggetti. Questi ImageList gli oggetti vengono aggiunti per il LargeImageList e SmallImageList proprietà. L'esempio utilizza le seguenti proprietà per la creazione di ListView controllo:

Si presuppone di aver aggiunto il codice per un Form e chiamare il metodo creato nell'esempio dal costruttore o un altro metodo nel form. Nell'esempio si presuppone inoltre che le immagini denominate MySmallImage1, MySmallImage2, MyLargeImage1, e MyLargeImage2 si trovano nella directory radice dell'unità C.

private void CreateMyListView()
{
	// Create a new ListView control.
	ListView listView1 = new ListView();
	listView1.Bounds = new Rectangle(new Point(10,10), new Size(300,200));

	// Set the view to show details.
	listView1.View = View.Details;
	// Allow the user to edit item text.
	listView1.LabelEdit = true;
	// Allow the user to rearrange columns.
	listView1.AllowColumnReorder = true;
	// Display check boxes.
	listView1.CheckBoxes = true;
	// Select the item and subitems when selection is made.
	listView1.FullRowSelect = true;
	// Display grid lines.
	listView1.GridLines = true;
	// Sort the items in the list in ascending order.
	listView1.Sorting = SortOrder.Ascending;

	// Create three items and three sets of subitems for each item.
	ListViewItem item1 = new ListViewItem("item1",0);
	// Place a check mark next to the item.
	item1.Checked = true;
	item1.SubItems.Add("1");
	item1.SubItems.Add("2");
	item1.SubItems.Add("3");
	ListViewItem item2 = new ListViewItem("item2",1);
	item2.SubItems.Add("4");
	item2.SubItems.Add("5");
	item2.SubItems.Add("6");
	ListViewItem item3 = new ListViewItem("item3",0);
	// Place a check mark next to the item.
	item3.Checked = true;
	item3.SubItems.Add("7");
	item3.SubItems.Add("8");
	item3.SubItems.Add("9");

	// Create columns for the items and subitems.
	// Width of -2 indicates auto-size.
	listView1.Columns.Add("Item Column", -2, HorizontalAlignment.Left);
	listView1.Columns.Add("Column 2", -2, HorizontalAlignment.Left);
	listView1.Columns.Add("Column 3", -2, HorizontalAlignment.Left);
	listView1.Columns.Add("Column 4", -2, HorizontalAlignment.Center);

	//Add the items to the ListView.
          		listView1.Items.AddRange(new ListViewItem[]{item1,item2,item3});

	// Create two ImageList objects.
	ImageList imageListSmall = new ImageList();
	ImageList imageListLarge = new ImageList();

	// Initialize the ImageList objects with bitmaps.
	imageListSmall.Images.Add(Bitmap.FromFile("C:\\MySmallImage1.bmp"));
	imageListSmall.Images.Add(Bitmap.FromFile("C:\\MySmallImage2.bmp"));
	imageListLarge.Images.Add(Bitmap.FromFile("C:\\MyLargeImage1.bmp"));
	imageListLarge.Images.Add(Bitmap.FromFile("C:\\MyLargeImage2.bmp"));

	//Assign the ImageList objects to the ListView.
	listView1.LargeImageList = imageListLarge;
	listView1.SmallImageList = imageListSmall;

	// Add the ListView to the control collection.
	this.Controls.Add(listView1);
}

.NET Framework
Disponibile da 1.1
Torna all'inizio
Mostra: