ListViewItem Sınıf

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

ListViewItem.cs

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]
[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

Devralma

Object

ListViewItem

Öznitelikler

TypeConverterAttribute SerializableAttribute DynamicallyAccessedMembersAttribute

Uygulamalar

ICloneable ISerializable

Örnekler

Aşağıdaki kod örneği, belirtilen üç ListViewItem nesne ve her öğe için üç ListViewItem.ListViewSubItem nesne belirtilen 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 . Ayrıca kod örneğinde nesnelere yönelik görüntüler sağlamak için ListViewItem iki ImageList nesne 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, , , MySmallImage2MyLargeImage1ve 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 olarak ya da dikey listede küçük simgeler olarak görüntülenebilir. Öğeler, üst öğeyle ilgili bilgileri 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 başlıkları içeren bir kılavuzda görüntülemenizi sağlar.

sınıfının özelliklerinin ListViewItem çoğu, öğenin ilişkili olduğu denetimdeki ListView 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 görüntüden ImageList yüklenecek görüntüyü belirtmenize ListView olanak tanır (veya SmallImageList özelliklerini ListViewayarlayarakLargeImageList). Öğeler, kullanıcıdan öğe seçimlerini denetime benzer bir ş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 denetimin içinde ListViewListView.ColumnHeaderCollection sütunlar tanımlandığında View öğeler istediğiniz sayıda alt öğe görüntüleyebilir. Sınıfın yöntemini ListViewItem.ListViewSubItemCollection çağırarak bir öğeye Add 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 ( LabelEdit denetimin ListView özelliği olarak ayarlandığında true). Clone yöntemi, diğer ListView denetimlerde yeniden kullanmak üzere mevcut ListViewItem nesnelerin kopyalarını oluşturmanıza olanak tanır.

Oluşturucular

Name	Description
ListViewItem()	varsayılan değerlerle ListViewItem sınıfının yeni bir örneğini 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, 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[], 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[], 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(ListViewItem+ListViewSubItem[], String)	Belirtilen alt öğeleri ve görüntüyü kullanarak sınıfın ListViewItem yeni bir örneğini 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, Int32, ListViewGroup)	Belirtilen öğe metni ve öğenin 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, 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, ListViewGroup)	Sınıfın ListViewItem yeni bir örneğini belirtilen öğe metniyle başlatır ve belirtilen gruba atar.
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, String)	Belirtilen metin ve görüntüyle 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, 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 yeni bir örneğini başlatır. Öğeyi belirtilen gruba atar.
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 yeni bir örneğini başlatır.
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[], Int32)	Öğenin simgesinin ListViewItem görüntü dizini konumu ve alt öğeleri temsil eden dize dizisiyle sınıfın yeni bir örneğini başlatır.
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, Color, Color, Font, ListViewGroup)	Sınıfın ListViewItem yeni bir örneğini, belirtilen metni, görüntüyü, renkleri, yazı tipini ve grubu içeren alt öğeleriyle başlatır.
ListViewItem(String[], String, Color, Color, Font)	Sınıfın ListViewItem yeni bir örneğini, belirtilen metni, resmi, renkleri ve yazı tipini içeren alt öğeleriyle 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.
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[])	Sınıfın ListViewItem yeni bir örneğini, alt öğeleri temsil eden dize dizisiyle başlatır.

Özellikler

Name	Description
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 işaretli olup olmadığını 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	girintisi için 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 (öğenin durumunu gösteren seçili veya temizlenmiş onay kutusu gibi bir resim) dizinini 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

Name	Description
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()	Öğenin denetim içinde görünür olmasını sağlar ve gerekirse denetimin içeriğini kaydırarak.
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.
GetSubItemAt(Int32, Int32)	Belirtilen koordinatlarda öğesinin alt öğesini ListViewItem döndürür.
Remove()	Öğeyi ilişkili ListView denetiminden kaldırır.
Serialize(SerializationInfo, StreamingContext)	Öğeyi serileştirir.
ToString()	Geçerli nesneyi temsil eden bir dize döndürür.

Belirtik Arabirim Kullanımları

Name	Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Öğeyi serileştirir.

Ayrıca bkz.

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