ListViewItem Kelas

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Sumber:

ListViewItem.cs

Mewakili item dalam ListView kontrol.

public ref class ListViewItem : ICloneable, System::Runtime::Serialization::ISerializable

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ListViewItemConverter))]
[System.Serializable]
[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
public class ListViewItem : ICloneable, System.Runtime.Serialization.ISerializable

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ListViewItemConverter))>]
[<System.Serializable>]
[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
type ListViewItem = class
    interface ICloneable
    interface ISerializable

Public Class ListViewItem
Implements ICloneable, ISerializable

Warisan

Object

ListViewItem

Atribut

TypeConverterAttribute SerializableAttribute DynamicallyAccessedMembersAttribute

Penerapan

ICloneable ISerializable

Contoh

Contoh kode berikut membuat ListView kontrol dengan tiga ListViewItem objek yang ditentukan dan tiga ListViewItem.ListViewSubItem objek yang ditentukan untuk setiap item. Contoh ini juga membuat ColumnHeader objek untuk menampilkan subitem dalam tampilan detail. Dua ImageList objek juga dibuat dalam contoh kode untuk menyediakan gambar untuk ListViewItem objek. Objek ini ImageList ditambahkan ke LargeImageList properti dan SmallImageList . Contoh menggunakan properti berikut dalam membuat ListView kontrol:

• View

• LabelEdit

• AllowColumnReorder

• CheckBoxes

• FullRowSelect

• GridLines

• Sorting

Anda perlu menambahkan kode ke dan memanggil metode yang Form dibuat dalam contoh dari konstruktor atau metode lain pada formulir. Contohnya mengharuskan gambar bernama MySmallImage1, MySmallImage2, MyLargeImage1, dan MyLargeImage2 terletak di direktori akar drive C.

private:
   void CreateMyListView()
   {
      // Create a new ListView control.
      ListView^ listView1 = gcnew ListView;
      listView1->Bounds = Rectangle(Point(10,10),System::Drawing::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 = gcnew 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 = gcnew ListViewItem( "item2",1 );
      item2->SubItems->Add( "4" );
      item2->SubItems->Add( "5" );
      item2->SubItems->Add( "6" );
      ListViewItem^ item3 = gcnew 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.
      array<ListViewItem^>^temp1 = {item1,item2,item3};
      listView1->Items->AddRange( temp1 );

      // Create two ImageList objects.
      ImageList^ imageListSmall = gcnew ImageList;
      ImageList^ imageListLarge = gcnew 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 );
   }

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);
}

Private Sub CreateMyListView()
    ' Create a new ListView control.
    Dim listView1 As 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.
    Dim item1 As 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")
    Dim item2 As New ListViewItem("item2", 1)
    item2.SubItems.Add("4")
    item2.SubItems.Add("5")
    item2.SubItems.Add("6")
    Dim item3 As 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.
    Dim imageListSmall As New ImageList()
    Dim imageListLarge As 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.
    Me.Controls.Add(listView1)
End Sub

Keterangan

ListView Kontrol mirip dengan ListBox di tempat kontrol menampilkan daftar item. Perbedaan utamanya adalah kontrol ListView menyediakan sejumlah cara yang berbeda item dapat dilihat oleh pengguna. Kelas ListViewItem menentukan tampilan, perilaku, dan data yang terkait dengan item yang ditampilkan dalam ListView kontrol. ListViewItem objek dapat ditampilkan dalam ListView kontrol di salah satu dari empat tampilan yang berbeda. Item dapat ditampilkan sebagai ikon besar atau kecil atau sebagai ikon kecil dalam daftar vertikal. Item juga dapat memiliki subitem yang berisi informasi yang terkait dengan item induk. Gaya tampilan keempat, tampilan detail, memungkinkan Anda menampilkan item dan subitemnya dalam kisi dengan header kolom yang dapat digunakan untuk mengidentifikasi informasi yang ditampilkan dalam subitem.

Sebagian besar properti ListViewItem kelas menyediakan cara untuk mengubah tampilan item dalam kontrol yang ListView terkait dengannya. Properti BackColor, ForeColor, dan Font memungkinkan Anda mengubah cara teks item ditampilkan dalam ListView kontrol. Properti ImageIndex memungkinkan Anda menentukan gambar yang akan dimuat dari ImageList yang ditetapkan ke ListView kontrol (dengan mengatur LargeImageList properti atau SmallImageList dari ListView). Item dapat menampilkan kotak centang untuk mendapatkan pilihan item dari pengguna dengan cara yang mirip CheckedListBox dengan kontrol. Anda dapat menggunakan Checked properti untuk menentukan apakah item dicentang, atau untuk memilih atau mengosongkan kotak centang pada waktu proses. Item dapat menampilkan sejumlah subitem saat View properti kontrol terkait ListView diatur ke Details dan kolom ditentukan dalam ListView.ColumnHeaderCollectionListView kontrol. Anda dapat menambahkan subitem ke item dengan memanggil Add metode ListViewItem.ListViewSubItemCollection kelas. Properti SubItems ini memungkinkan Anda untuk mendapatkan akses ke ListViewItem.ListViewSubItemCollection kelas dan anggotanya.

Beberapa properti dan metode ListViewItem kelas adalah versi properti dan metode khusus item dalam ListView kontrol. Misalnya, EnsureVisible metode ini mirip ListView dengan versi metode , tetapi ListViewItem versi hanya memengaruhi item saat ini.

Kelas ini ListViewItem juga menyediakan metode yang bukan versi ListView metode. Metode menempatkan BeginEdit teks item ke mode edit sehingga pengguna dapat mengubah teks item (saat LabelEdit properti ListView kontrol diatur ke true). Metode ini Clone memungkinkan Anda membuat salinan objek yang ListViewItem ada untuk digunakan kembali di kontrol lain ListView .

Konstruktor

Nama	Deskripsi
ListViewItem()	Menginisialisasi instans baru kelas ListViewItem dengan nilai default.
ListViewItem(ListViewGroup)	Menginisialisasi instans ListViewItem baru kelas dan menetapkannya ke grup yang ditentukan.
ListViewItem(ListViewItem+ListViewSubItem[], Int32, ListViewGroup)	Menginisialisasi instans ListViewItem baru kelas dengan posisi indeks gambar ikon item dan array ListViewItem.ListViewSubItem objek, dan menetapkan item ke grup yang ditentukan.
ListViewItem(ListViewItem+ListViewSubItem[], Int32)	Menginisialisasi instans ListViewItem baru kelas dengan posisi indeks gambar ikon item dan array ListViewItem.ListViewSubItem objek.
ListViewItem(ListViewItem+ListViewSubItem[], String, ListViewGroup)	Menginisialisasi instans ListViewItem baru kelas dengan subitem, gambar, dan grup yang ditentukan.
ListViewItem(ListViewItem+ListViewSubItem[], String)	Menginisialisasi instans ListViewItem baru kelas dengan subitem dan gambar yang ditentukan.
ListViewItem(SerializationInfo, StreamingContext)	Menginisialisasi instans ListViewItem baru kelas dengan informasi serialisasi dan konteks streaming yang ditentukan.
ListViewItem(String, Int32, ListViewGroup)	Menginisialisasi instans ListViewItem baru kelas dengan teks item yang ditentukan dan posisi indeks gambar ikon item, dan menetapkan item ke grup yang ditentukan.
ListViewItem(String, Int32)	Menginisialisasi instans ListViewItem baru kelas dengan teks item yang ditentukan dan posisi indeks gambar ikon item.
ListViewItem(String, ListViewGroup)	Menginisialisasi instans ListViewItem baru kelas dengan teks item yang ditentukan dan menetapkannya ke grup yang ditentukan.
ListViewItem(String, String, ListViewGroup)	Menginisialisasi instans ListViewItem baru kelas dengan teks, gambar, dan grup yang ditentukan.
ListViewItem(String, String)	Menginisialisasi instans ListViewItem baru kelas dengan teks dan gambar yang ditentukan.
ListViewItem(String)	Menginisialisasi instans ListViewItem baru kelas dengan teks item yang ditentukan.
ListViewItem(String[], Int32, Color, Color, Font, ListViewGroup)	Menginisialisasi instans ListViewItem baru kelas dengan posisi indeks gambar ikon item; warna latar depan, warna latar belakang, dan font item; dan array string yang mewakili subitem. Menetapkan item ke grup yang ditentukan.
ListViewItem(String[], Int32, Color, Color, Font)	Menginisialisasi instans ListViewItem baru kelas dengan posisi indeks gambar ikon item; warna latar depan, warna latar belakang, dan font item; dan array string yang mewakili subitem.
ListViewItem(String[], Int32, ListViewGroup)	Menginisialisasi instans ListViewItem baru kelas dengan posisi indeks gambar ikon item dan array string yang mewakili subitem, dan menetapkan item ke grup yang ditentukan.
ListViewItem(String[], Int32)	Menginisialisasi instans ListViewItem baru kelas dengan posisi indeks gambar ikon item dan array string yang mewakili subitem.
ListViewItem(String[], ListViewGroup)	Menginisialisasi instans ListViewItem baru kelas dengan array string yang mewakili subitem, dan menetapkan item ke grup yang ditentukan.
ListViewItem(String[], String, Color, Color, Font, ListViewGroup)	Menginisialisasi instans ListViewItem baru kelas dengan subitem yang berisi teks, gambar, warna, font, dan grup yang ditentukan.
ListViewItem(String[], String, Color, Color, Font)	Menginisialisasi instans ListViewItem baru kelas dengan subitem yang berisi teks, gambar, warna, dan font yang ditentukan.
ListViewItem(String[], String, ListViewGroup)	Menginisialisasi instans ListViewItem baru kelas dengan subitem yang berisi teks, gambar, dan grup yang ditentukan.
ListViewItem(String[], String)	Menginisialisasi instans ListViewItem baru kelas dengan item dan teks dan gambar subitem yang ditentukan.
ListViewItem(String[])	Menginisialisasi instans ListViewItem baru kelas dengan array string yang mewakili subitem.

Properti

Nama	Deskripsi
BackColor	Mendapatkan atau mengatur warna latar belakang teks item.
Bounds	Mendapatkan persegi panjang pembatas item, termasuk subitem.
Checked	Mendapatkan atau menetapkan nilai yang menunjukkan apakah item dicentang.
Focused	Mendapatkan atau menetapkan nilai yang menunjukkan apakah item memiliki fokus dalam ListView kontrol.
Font	Mendapatkan atau mengatur font teks yang ditampilkan oleh item.
ForeColor	Mendapatkan atau mengatur warna latar depan teks item.
Group	Mendapatkan atau mengatur grup tempat item ditetapkan.
ImageIndex	Mendapatkan atau mengatur indeks gambar yang ditampilkan untuk item.
ImageKey	Mendapatkan atau mengatur kunci untuk gambar yang ditampilkan untuk item.
ImageList	ImageList Mendapatkan yang berisi gambar yang ditampilkan dengan item .
IndentCount	Mendapatkan atau mengatur jumlah lebar gambar kecil untuk mengindentasi ListViewItem.
Index	Mendapatkan indeks berbasis nol dari item dalam ListView kontrol.
ListView	ListView Mendapatkan kontrol yang berisi item.
Name	Mendapatkan atau mengatur nama yang terkait dengan ini ListViewItem.
Position	Mendapatkan atau mengatur posisi sudut ListViewItemkiri atas .
Selected	Mendapatkan atau menetapkan nilai yang menunjukkan apakah item dipilih.
StateImageIndex	Mendapatkan atau mengatur indeks gambar status (gambar seperti kotak centang yang dipilih atau dikosongkan yang menunjukkan status item) yang ditampilkan untuk item tersebut.
SubItems	Mendapatkan koleksi yang berisi semua subitem item.
Tag	Mendapatkan atau mengatur objek yang berisi data untuk dikaitkan dengan item.
Text	Mendapatkan atau mengatur teks item.
ToolTipText	Mendapatkan atau mengatur teks yang ditampilkan saat penunjuk mouse berada di ListViewItem.
UseItemStyleForSubItems	Mendapatkan atau menetapkan nilai yang menunjukkan apakah Fontproperti , , ForeColordan BackColor untuk item digunakan untuk semua subitemnya.

Metode

Nama	Deskripsi
BeginEdit()	Tempatkan teks item ke mode edit.
Clone()	Membuat salinan item yang identik.
Deserialize(SerializationInfo, StreamingContext)	Mendeserialisasi item.
EnsureVisible()	Memastikan bahwa item terlihat dalam kontrol, menggulir konten kontrol, jika perlu.
FindNearestItem(SearchDirectionHint)	Menemukan item berikutnya dari ListViewItem, mencari ke arah yang ditentukan.
GetBounds(ItemBoundsPortion)	Mengambil bagian yang ditentukan dari persegi panjang pembatas untuk item.
GetSubItemAt(Int32, Int32)	Mengembalikan subitem dari ListViewItem pada koordinat yang ditentukan.
Remove()	Menghapus item dari kontrol terkait ListView .
Serialize(SerializationInfo, StreamingContext)	Menserialisasi item.
ToString()	Mengembalikan string yang mewakili objek saat ini.

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Menserialisasi item.

Lihat juga

• ListView
• ListViewItem.ListViewSubItem
• Kontrol ListView (Formulir Windows)