Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

ListView.LargeImageList-Eigenschaft

 

Veröffentlicht: Oktober 2016

Ruft ab oder legt die ImageList verwenden, wenn die Elemente im Steuerelement als große Symbole angezeigt.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public ImageList LargeImageList { get; set; }

Eigenschaftswert

Type: System.Windows.Forms.ImageList

Ein ImageList enthält die Symbole verwendet wird, wenn die View Eigenschaft auf festgelegt ist LargeIcon. Die Standardwert ist null.

Die LargeImageList -Eigenschaft können Sie angeben, ein ImageList -Objekt, das verwendet werden, wenn Elemente mit großen Symbolen angezeigt (wenn die View Eigenschaft auf festgelegt ist LargeIcon). Die ListView -Steuerelement Grafiken zu formatieren, akzeptiert die ImageList Steuerelement unterstützt, wenn die Anzeige von Symbolen. Die ListView -Steuerelement besteht keine Beschränkung auf ICO-Dateien. Einmal eine ImageList zugewiesen wird die LargeImageList -Eigenschaft, die Sie festlegen können die ImageIndex -Eigenschaft jedes ListViewItem in der ListView -Steuerelement auf die Indexposition des entsprechenden Bilds in der ImageList. Die Größe der Symbole für die LargeImageList wird angegeben, indem die ImageSize.

Da nur ein Index kann, für angegeben werden die ListViewItem.ImageIndex -Eigenschaft, die ImageList in angegebenen Objekte die LargeImageList und SmallImageList Eigenschaften müssen dieselben Indexpositionen für die anzuzeigenden Bilder. Z. B. wenn die ImageIndex Eigenschaft ein ListViewItem festgelegt ist 0 ist, muss sich die Bilder für kleine und große Symbole an der gleichen Indexposition in der ImageList in angegebenen Objekte die LargeImageList und SmallImageList Eigenschaften.

System_CAPS_noteHinweis

Wenn die Bilder mit Schlüsseln angegeben sind, müssen Sie weiterhin kleine und große Versionen eines Bilds an der gleichen Indexposition in der jeweiligen Bildliste zu platzieren. Beim Wechseln zwischen Ansichten dient die Indexposition des Bilds in einer Liste suchen das Bild in der anderen Liste, unabhängig vom angegebenen Schlüsselwert.

Festlegen der ImageList verwendet, wenn Elemente mit kleinen Symbolen angezeigt (allen Ansichtsmodi außer LargeIcon), verwenden Sie die SmallImageList Eigenschaft. Wenn Sie Bilder, zur Anzeige der Status der verwenden verwenden möchten die StateImageList Eigenschaft.

Der folgende Code erstellt ein ListView -Steuerelement mit drei ListViewItem angegebenen Objekte und drei ListViewItem.ListViewSubItem für jedes Element angegebenen Objekte. Im Beispiel wird auch erstellt ColumnHeader Objekte die Unterelemente in der Detailansicht angezeigt. Zwei ImageList Objekte werden auch erstellt, im Beispiel zum Bereitstellen von Abbildern für die ListViewItem Objekte. Diese ImageList Objekte werden hinzugefügt, um die LargeImageList und SmallImageList Eigenschaften. Das Beispiel verwendet die folgenden Eigenschaften bei der Erstellung der ListView Steuerelement.

Dieses Beispiel ist es erforderlich, dass Sie den Code hinzugefügt haben eine Form und rufen die Methode im Beispiel aus dem Konstruktor oder eine andere Methode auf dem Formular erstellt. Das Beispiel erfordert auch, dass Bilder mit dem Namen MySmallImage1, MySmallImage2, MyLargeImage1, und MyLargeImage2 befinden sich im Stammverzeichnis von Laufwerk 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
Verfügbar seit 1.1
Zurück zum Anfang
Anzeigen: