ListViewItem Sınıf

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Denetimdeki bir ListView öğeyi temsil eder.

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

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

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

Public Class ListViewItem
Implements ICloneable, ISerializable

Devralma

Object

ListViewItem

Öznitelikler

TypeConverterAttribute SerializableAttribute

Uygulamalar

ICloneable ISerializable

Örnekler

Aşağıdaki kod örneği, üç ListViewItem nesne ve her öğe için üç ListViewItem.ListViewSubItem nesne belirtilmiş bir ListView denetim oluşturur. Örnek ayrıca alt öğeleri ayrıntılar görünümünde görüntülemek için nesneler oluşturur ColumnHeader . Kod örneğinde, nesnelere görüntü sağlamak için ListViewItem iki ImageList nesne de oluşturulur. Bu ImageList nesneler ve SmallImageList özelliklerine LargeImageList eklenir. Örnek, denetimi oluştururken ListView aşağıdaki özellikleri kullanır:

• View

• LabelEdit

• AllowColumnReorder

• CheckBoxes

• FullRowSelect

• GridLines

• Sorting

Kodu öğesine Form eklemeniz ve örnekte oluşturulan yöntemi oluşturucudan veya formdaki başka bir yöntemden çağırmanız gerekir. Örnek, , MySmallImage2, MyLargeImage1ve MyLargeImage2 adlı MySmallImage1görüntülerin C sürücüsünün kök dizininde yer almalarını gerektirir.

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

Açıklamalar

Denetim ListView , içindekine ListBox benzer ve bir öğe listesi görüntüler. Temel fark, denetimin ListView öğelerin kullanıcı tarafından görüntülenebileceği bir dizi farklı yol sağlamasıdır. ListViewItem sınıfı, denetimde görüntülenen ListView bir öğeyle ilişkili görünümü, davranışı ve verileri tanımlar. ListViewItem nesneleri denetimde ListView dört farklı görünümden birinde görüntülenebilir. Öğeler büyük veya küçük simgeler veya dikey bir listede küçük simgeler olarak görüntülenebilir. Öğeler, üst öğeyle ilgili bilgiler içeren alt öğelere de sahip olabilir. Dördüncü görünüm stili olan ayrıntılar görünümü, öğeyi ve alt öğeleri bir alt öğede görüntülenen bilgileri tanımlamak için kullanılabilecek sütun üst bilgileriyle bir kılavuzda görüntülemenizi sağlar.

sınıfının özelliklerinin ListViewItem çoğu, ilişkili olduğu denetimdeki ListView öğenin görünümünü değiştirmenin yollarını sağlar. BackColor, ForeColorve Font özellikleri, öğenin metninin denetimde görüntülenme biçimini değiştirmenize ListView olanak sağlar. özelliği, ImageIndex denetimine atanan içinden ImageList yükleneceğini görüntüyü belirtmenize ListView olanak tanır (veya SmallImageList özelliklerini ListViewayarlayarakLargeImageList). Öğeler, kullanıcıdan öğe seçimlerini denetime benzer şekilde almak için CheckedListBox onay kutularını görüntüleyebilir. Bir öğenin işaretli olup olmadığını belirlemek veya çalışma zamanında onay kutusunu seçmek veya temizlemek için özelliğini kullanabilirsiniz Checked . İlişkili ListView denetimin özelliği olarak ayarlandığında Details ve sütunlar denetimin içinde ListView ListView.ColumnHeaderCollection tanımlandığında View öğeler herhangi bir sayıda alt öğe görüntüleyebilir. sınıfının yöntemini ListViewItem.ListViewSubItemCollection çağırarak Add bir öğeye alt öğeler ekleyebilirsiniz. özelliği, SubItems sınıfına ve üyelerine ListViewItem.ListViewSubItemCollection erişim kazanmanızı sağlar.

sınıfının bazı özellikleri ve yöntemleri ListViewItem , denetimdeki özelliklerin ve yöntemlerin öğeye ListView özgü sürümleridir. Örneğin, EnsureVisible yöntemi yöntemin sürümüne ListView benzer, ancak ListViewItem sürüm yalnızca geçerli öğeyi etkiler.

sınıfı ListViewItem , yöntemlerin sürümleri ListView olmayan yöntemler de sağlar. yöntemi, BeginEdit kullanıcının öğenin metnini değiştirebilmesi için öğenin metnini düzenleme moduna yerleştirir (denetimin LabelEdit ListView özelliği olarak trueayarlandığında). Clone yöntemi, diğer ListView denetimlerde yeniden kullanmak üzere mevcut ListViewItem nesnelerin kopyalarını oluşturmanıza olanak tanır.

Oluşturucular

ListViewItem()	ListViewItem sınıfının yeni bir örneğini varsayılan değerlerle başlatır.
ListViewItem(ListViewGroup)	sınıfının yeni bir örneğini ListViewItem başlatır ve belirtilen gruba atar.
ListViewItem(ListViewItem+ListViewSubItem[], Int32)	Öğenin simgesinin ListViewItem görüntü dizini konumu ve bir nesne dizisi ile sınıfının yeni bir örneğini ListViewItem.ListViewSubItem başlatır.
ListViewItem(ListViewItem+ListViewSubItem[], Int32, ListViewGroup)	Öğenin simgesinin ListViewItem görüntü dizini konumu ve bir nesne dizisi ListViewItem.ListViewSubItem ile sınıfının yeni bir örneğini başlatır ve öğeyi belirtilen gruba atar.
ListViewItem(ListViewItem+ListViewSubItem[], String)	Belirtilen alt öğeleri ve görüntüyü kullanarak sınıfının yeni bir örneğini ListViewItem başlatır.
ListViewItem(ListViewItem+ListViewSubItem[], String, ListViewGroup)	Belirtilen alt öğeleri, görüntüyü ve grubu ile sınıfının yeni bir örneğini ListViewItem başlatır.
ListViewItem(SerializationInfo, StreamingContext)	Belirtilen serileştirme bilgileri ve akış bağlamı ile sınıfının yeni bir örneğini ListViewItem başlatır.
ListViewItem(String)	Belirtilen öğe metniyle sınıfının yeni bir örneğini ListViewItem başlatır.
ListViewItem(String, Int32)	Belirtilen öğe metni ve öğe simgesinin ListViewItem görüntü dizini konumuyla sınıfın yeni bir örneğini başlatır.
ListViewItem(String, Int32, ListViewGroup)	Belirtilen öğe metni ve öğe simgesinin ListViewItem görüntü dizini konumuyla sınıfın yeni bir örneğini başlatır ve öğeyi belirtilen gruba atar.
ListViewItem(String, ListViewGroup)	Belirtilen öğe metniyle sınıfının yeni bir örneğini ListViewItem başlatır ve belirtilen gruba atar.
ListViewItem(String, String)	Belirtilen metin ve görüntüyle sınıfının yeni bir örneğini ListViewItem başlatır.
ListViewItem(String, String, ListViewGroup)	Belirtilen metin, görüntü ve grupla sınıfının yeni bir örneğini ListViewItem başlatır.
ListViewItem(String[])	Sınıfın ListViewItem yeni bir örneğini, alt öğeleri temsil eden bir dize dizisiyle başlatır.
ListViewItem(String[], Int32)	Öğenin simgesinin ListViewItem görüntü dizini konumu ve alt öğeleri temsil eden dize dizisiyle sınıfının yeni bir örneğini başlatır.
ListViewItem(String[], Int32, Color, Color, Font)	Öğenin simgesinin ListViewItem görüntü dizini konumu, ön plan rengi, arka plan rengi ve öğenin yazı tipi ve alt öğeleri temsil eden dize dizisi ile sınıfının yeni bir örneğini başlatır.
ListViewItem(String[], Int32, Color, Color, Font, ListViewGroup)	Öğenin simgesinin ListViewItem görüntü dizini konumu, ön plan rengi, arka plan rengi ve öğenin yazı tipi ve alt öğeleri temsil eden dize dizisi ile sınıfının yeni bir örneğini başlatır. Öğeyi belirtilen gruba atar.
ListViewItem(String[], Int32, ListViewGroup)	Öğenin simgesinin ListViewItem görüntü dizini konumu ve alt öğeleri temsil eden dize dizisiyle sınıfının yeni bir örneğini başlatır ve öğeyi belirtilen gruba atar.
ListViewItem(String[], ListViewGroup)	Sınıfın ListViewItem yeni bir örneğini alt öğeleri temsil eden dize dizisiyle başlatır ve öğeyi belirtilen gruba atar.
ListViewItem(String[], String)	Belirtilen öğe ve alt metin ve görüntü ile sınıfının yeni bir örneğini ListViewItem başlatır.
ListViewItem(String[], String, Color, Color, Font)	Belirtilen metni, görüntüyü, renkleri ve yazı tipini içeren alt öğeleri ile sınıfının yeni bir örneğini ListViewItem başlatır.
ListViewItem(String[], String, Color, Color, Font, ListViewGroup)	Belirtilen metni, görüntüyü, renkleri, yazı tipini ve grubu içeren alt öğeleriyle sınıfının yeni bir örneğini ListViewItem başlatır.
ListViewItem(String[], String, ListViewGroup)	Sınıfın ListViewItem yeni bir örneğini, belirtilen metin, görüntü ve grubu içeren alt sınıflarla başlatır.

Özellikler

BackColor	Öğe metninin arka plan rengini alır veya ayarlar.
Bounds	Alt öğeler de dahil olmak üzere öğenin sınırlayıcı dikdörtgenini alır.
Checked	Öğenin denetlenip denetlenmediğini belirten bir değer alır veya ayarlar.
Focused	Öğenin denetim içinde ListView odaklanıp odaklanmadığını belirten bir değer alır veya ayarlar.
Font	Öğe tarafından görüntülenen metnin yazı tipini alır veya ayarlar.
ForeColor	Öğe metninin ön plan rengini alır veya ayarlar.
Group	Öğenin atandığı grubu alır veya ayarlar.
ImageIndex	Öğe için görüntülenen görüntünün dizinini alır veya ayarlar.
ImageKey	Öğe için görüntülenen görüntünün anahtarını alır veya ayarlar.
ImageList	ImageList Öğeyle birlikte görüntülenen görüntüyü içeren öğesini alır.
IndentCount	girintisinin artırıldığı ListViewItemküçük resim genişliklerinin sayısını alır veya ayarlar.
Index	Denetim içindeki öğenin sıfır tabanlı dizinini ListView alır.
ListView	Öğeyi ListView içeren denetimi alır.
Name	Bu ListViewItemile ilişkili adı alır veya ayarlar.
Position	öğesinin sol üst köşesinin ListViewItemkonumunu alır veya ayarlar.
Selected	Öğenin seçili olup olmadığını belirten bir değer alır veya ayarlar.
StateImageIndex	Öğe için görüntülenen durum görüntüsünün dizinini (öğenin durumunu gösteren seçili veya temizlenmiş onay kutusu gibi bir görüntü) alır veya ayarlar.
SubItems	Öğenin tüm alt maddelerini içeren bir koleksiyon alır.
Tag	Öğeyle ilişkilendirilecek verileri içeren bir nesneyi alır veya ayarlar.
Text	Öğenin metnini alır veya ayarlar.
ToolTipText	Fare işaretçisi üzerinde ListViewItembekletildiğinde gösterilen metni alır veya ayarlar.
UseItemStyleForSubItems	Öğenin , ForeColorve BackColor özelliklerinin tüm alt öğeleri için kullanılıp kullanılmadığını Fontbelirten bir değer alır veya ayarlar.

Yöntemler

BeginEdit()	Öğe metnini düzenleme moduna yerleştirir.
Clone()	Öğenin özdeş bir kopyasını oluşturur.
Deserialize(SerializationInfo, StreamingContext)	Öğe seri durumdan çıkarılır.
EnsureVisible()	Gerekirse denetimin içeriğini kaydırarak öğenin denetim içinde görünür olmasını sağlar.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
FindNearestItem(SearchDirectionHint)	içinde belirtilen yönde arama yaparak bir sonraki öğeyi ListViewItembulur.
GetBounds(ItemBoundsPortion)	Öğe için sınırlayıcı dikdörtgenin belirtilen bölümünü alır.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetSubItemAt(Int32, Int32)	Belirtilen koordinatlarda öğesinin ListViewItem alt öğesini döndürür.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
Remove()	Öğeyi ilişkili ListView denetiminden kaldırır.
Serialize(SerializationInfo, StreamingContext)	Öğeyi serileştirir.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür.

Belirtik Arabirim Kullanımları

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Öğeyi serileştirir.

Ayrıca bkz.

• ListView
• ListViewItem.ListViewSubItem
• ListView Denetimi (Windows Forms)