ListViewItem Konstruktoren
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Initialisiert eine neue Instanz der ListViewItem-Klasse.
Überlädt
ListViewItem() |
Initialisiert eine neue Instanz der ListViewItem-Klasse mit Standardwerten. |
ListViewItem(String[], String, Color, Color, Font, ListViewGroup) |
Initialisiert eine neue Instanz der ListViewItem-Klasse mit Unterelementen, die den angegebenen Text, das angegebene Bild, die angegebene Gruppe sowie die angegebenen Farben und die angegebene Schriftart enthalten. |
ListViewItem(String[], Int32, Color, Color, Font, ListViewGroup) |
Initialisiert eine neue Instanz der ListViewItem-Klasse mit der Indexposition des Bilds für das Elementsymbol, der Vorder- und Hintergrundfarbe und Schriftart des Elements, sowie einem Array von Zeichenfolgen, die Unterelemente darstellen. Weist das Element der angegebenen Gruppe zu. |
ListViewItem(String[], String, Color, Color, Font) |
Initialisiert eine neue Instanz der ListViewItem-Klasse mit Unterelementen, die den angegebenen Text, das angegebene Bild sowie die angegebenen Farben und die angegebene Schriftart enthalten. |
ListViewItem(String[], Int32, Color, Color, Font) |
Initialisiert eine neue Instanz der ListViewItem-Klasse mit der Indexposition des Bilds für das Elementsymbol, der Vorder- und Hintergrundfarbe und Schriftart des Elements, sowie einem Array von Zeichenfolgen, die Unterelemente darstellen. |
ListViewItem(ListViewItem+ListViewSubItem[], String, ListViewGroup) |
Initialisiert eine neue Instanz der ListViewItem-Klasse mit den angegebenen Unterelementen, dem angegebenen Bild und der angegebenen Gruppe. |
ListViewItem(ListViewItem+ListViewSubItem[], Int32, ListViewGroup) |
Initialisiert eine neue Instanz der ListViewItem-Klasse mit der Indexposition des Bilds für das Elementsymbol und einem Array von ListViewItem.ListViewSubItem-Objekten, und weist das Element der angegebenen Gruppe zu. |
ListViewItem(String[], String, ListViewGroup) |
Initialisiert eine neue Instanz der ListViewItem-Klasse mit Unterelementen, die den angegebenen Text, das angegebene Bild und die angegebene Gruppe enthalten. |
ListViewItem(String[], Int32, ListViewGroup) |
Initialisiert eine neue Instanz der ListViewItem-Klasse mit der Indexposition des Bilds für das Elementsymbol und einem Array von Zeichenfolgen, die Unterelemente darstellen, und weist das Element der angegebenen Gruppe zu. |
ListViewItem(String, String, ListViewGroup) |
Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Text, dem angegebenen Bild und der angegebenen Gruppe. |
ListViewItem(ListViewItem+ListViewSubItem[], String) |
Initialisiert eine neue Instanz der ListViewItem-Klasse mit den angegebenen Unterelementen und dem angegebenen Bild. |
ListViewItem(String, Int32, ListViewGroup) |
Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Elementtext und der Indexposition des Bilds für das Elementsymbol, und weist das Element der angegebenen Gruppe zu. |
ListViewItem(String[], ListViewGroup) |
Initialisiert eine neue Instanz der ListViewItem-Klasse mit einem Array von Zeichenfolgen, die Unterelemente darstellen, und weist das Element der angegebenen Gruppe zu. |
ListViewItem(String[], String) |
Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Element, dem angegebenen Unterelementtext und dem angegebenen Bild. |
ListViewItem(String[], Int32) |
Initialisiert eine neue Instanz der ListViewItem-Klasse mit der Indexposition des Bilds für das Elementsymbol und einem Array von Zeichenfolgen, die Unterelemente darstellen. |
ListViewItem(String, ListViewGroup) |
Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Elementtext und weist diese der angegebenen Gruppe zu. |
ListViewItem(String, String) |
Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Text und dem angegebenen Bild. |
ListViewItem(String, Int32) |
Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Elementtext und der Indexposition des Bilds für das Elementsymbol. |
ListViewItem(SerializationInfo, StreamingContext) |
Initialisiert eine neue Instanz der ListViewItem-Klasse mit den angegebenen Serialisierungsinformationen und dem angegebenen Streamingkontext |
ListViewItem(ListViewGroup) |
Initialisiert eine neue Instanz der ListViewItem-Klasse und weist diese der angegebenen Gruppe zu. |
ListViewItem(String[]) |
Initialisiert eine neue Instanz der ListViewItem-Klasse mit einem Array von Zeichenfolgen, die Unterelemente darstellen. |
ListViewItem(String) |
Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Elementtext. |
ListViewItem(ListViewItem+ListViewSubItem[], Int32) |
Initialisiert eine neue Instanz der ListViewItem-Klasse mit der Indexposition des Bilds für das Elementsymbol und einem Array von ListViewItem.ListViewSubItem-Objekten. |
ListViewItem()
Initialisiert eine neue Instanz der ListViewItem-Klasse mit Standardwerten.
public:
ListViewItem();
public ListViewItem ();
Public Sub New ()
Beispiele
Im folgenden Codebeispiel wird ein ListView Steuerelement mit drei ListViewItem angegebenen Objekten und drei ListViewItem.ListViewSubItem für jedes Element angegebenen Objekten erstellt. Im Beispiel werden auch Objekte erstellt ColumnHeader , um die Unterelemente in der Detailansicht anzuzeigen. Im Codebeispiel werden auch zwei ImageList -Objekte erstellt, um Bilder für die ListViewItem -Objekte bereitzustellen. Diese ImageList Objekte werden den LargeImageList Eigenschaften und SmallImageList hinzugefügt. Im Beispiel werden die folgenden Eigenschaften zum Erstellen des Steuerelements ListView verwendet:
Sie müssen den Code zu einem Form hinzufügen und die im Beispiel erstellte Methode aus dem Konstruktor oder einer anderen Methode im Formular aufrufen. Für das Beispiel müssen sich Bilder mit den Namen MySmallImage1
, MySmallImage2
, MyLargeImage1
und MyLargeImage2
im Stammverzeichnis von Laufwerk C befinden.
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
Gilt für:
ListViewItem(String[], String, Color, Color, Font, ListViewGroup)
Initialisiert eine neue Instanz der ListViewItem-Klasse mit Unterelementen, die den angegebenen Text, das angegebene Bild, die angegebene Gruppe sowie die angegebenen Farben und die angegebene Schriftart enthalten.
public:
ListViewItem(cli::array <System::String ^> ^ items, System::String ^ imageKey, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Drawing::Font ^ font, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string[] items, string imageKey, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font font, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string[]? items, string? imageKey, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font? font, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string[] * string * System.Drawing.Color * System.Drawing.Color * System.Drawing.Font * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageKey As String, foreColor As Color, backColor As Color, font As Font, group As ListViewGroup)
Parameter
- items
- String[]
Ein Zeichenfolgenarray, das den Text für die Unterelemente für das ListViewItem darstellt.
- imageKey
- String
Der Name des Bilds in der ImageList der besitzenden ListView, in der das Element angezeigt werden soll.
- group
- ListViewGroup
Die ListViewGroup, der das Element zugewiesen werden soll.
Hinweise
Mit dieser Version des Konstruktors können Sie die Gruppe angeben, zu der ein Element gehört.
Der imageKey
Parameter gibt ein Bild im an, das ImageList dem besitzenden ListView Steuerelement zugeordnet ist, auf das mit der ImageList -Eigenschaft zugegriffen werden kann.
Hinweis
ListView Gruppen sind nur unter Windows XP und der Windows Server 2003-Familie (Windows XP Home Edition, Windows XP Professional, Windows Server 2003) verfügbar. Weitere Informationen finden Sie in der Übersicht für die ListViewGroup.
Gilt für:
ListViewItem(String[], Int32, Color, Color, Font, ListViewGroup)
Initialisiert eine neue Instanz der ListViewItem-Klasse mit der Indexposition des Bilds für das Elementsymbol, der Vorder- und Hintergrundfarbe und Schriftart des Elements, sowie einem Array von Zeichenfolgen, die Unterelemente darstellen. Weist das Element der angegebenen Gruppe zu.
public:
ListViewItem(cli::array <System::String ^> ^ items, int imageIndex, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Drawing::Font ^ font, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string[] items, int imageIndex, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font font, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string[]? items, int imageIndex, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font? font, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string[] * int * System.Drawing.Color * System.Drawing.Color * System.Drawing.Font * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageIndex As Integer, foreColor As Color, backColor As Color, font As Font, group As ListViewGroup)
Parameter
- items
- String[]
Ein Array von Zeichenfolgen, die Unterelemente des neuen Elements darstellen.
- imageIndex
- Int32
Der nullbasierte Bildindex in der ImageList, die der ListView zugeordnet ist, die das Element enthält.
- group
- ListViewGroup
Die ListViewGroup, der das Element zugewiesen werden soll.
Hinweise
Mit dieser Version des Konstruktors können Sie die Gruppe angeben, zu der ein Element gehört.
Hinweis
ListView Gruppen sind nur unter Windows XP und der Windows Server 2003-Familie (Windows XP Home Edition, Windows XP Professional, Windows Server 2003) verfügbar. Weitere Informationen finden Sie in der Übersicht für die ListViewGroup.
Weitere Informationen
Gilt für:
ListViewItem(String[], String, Color, Color, Font)
Initialisiert eine neue Instanz der ListViewItem-Klasse mit Unterelementen, die den angegebenen Text, das angegebene Bild sowie die angegebenen Farben und die angegebene Schriftart enthalten.
public:
ListViewItem(cli::array <System::String ^> ^ items, System::String ^ imageKey, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Drawing::Font ^ font);
public ListViewItem (string[] items, string imageKey, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font font);
public ListViewItem (string[]? items, string? imageKey, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font? font);
new System.Windows.Forms.ListViewItem : string[] * string * System.Drawing.Color * System.Drawing.Color * System.Drawing.Font -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageKey As String, foreColor As Color, backColor As Color, font As Font)
Parameter
- items
- String[]
Ein Zeichenfolgenarray, das den Text für Unterelemente für das ListViewItem darstellt.
- imageKey
- String
Der Name des Bilds in der ImageList der besitzenden ListView, in der das Element angezeigt werden soll.
Hinweise
Der imageKey
Parameter gibt ein Bild im an, das ImageList dem besitzenden ListView Steuerelement zugeordnet ist, auf das mit der ImageList -Eigenschaft zugegriffen werden kann.
Gilt für:
ListViewItem(String[], Int32, Color, Color, Font)
Initialisiert eine neue Instanz der ListViewItem-Klasse mit der Indexposition des Bilds für das Elementsymbol, der Vorder- und Hintergrundfarbe und Schriftart des Elements, sowie einem Array von Zeichenfolgen, die Unterelemente darstellen.
public:
ListViewItem(cli::array <System::String ^> ^ items, int imageIndex, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Drawing::Font ^ font);
public ListViewItem (string[] items, int imageIndex, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font font);
public ListViewItem (string[]? items, int imageIndex, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font? font);
new System.Windows.Forms.ListViewItem : string[] * int * System.Drawing.Color * System.Drawing.Color * System.Drawing.Font -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageIndex As Integer, foreColor As Color, backColor As Color, font As Font)
Parameter
- items
- String[]
Ein Array von Zeichenfolgen, die Unterelemente des neuen Elements darstellen.
- imageIndex
- Int32
Der nullbasierte Bildindex in der ImageList, die der ListView zugeordnet ist, die das Element enthält.
Beispiele
Im folgenden Codebeispiel wird ein Formular erstellt, das ein ListView Steuerelement enthält, das Elemente manuell sortiert, wenn auf eine Spalte im ListView Steuerelement geklickt wird. Im Beispiel wird eine Klasse namens ListViewItemComparer
definiert, die die System.Collections.IComparer Schnittstelle implementiert, die den ListViewItem Vergleich durchführt. Im Beispiel wird eine instance von ListViewItemComparer
erstellt und verwendet, um die ListViewItemSorter -Eigenschaft des ListView Steuerelements festzulegen. Der Sort Methodenaufruf im ColumnClick Ereignishandler verwendet die in ListViewItemComparer
definierten Methoden, um die Art von Elementen basierend auf der Spalte auszuführen, auf die geklickt wird.
#using <System.dll>
#using <System.Drawing.dll>
#using <System.Windows.Forms.dll>
using namespace System;
using namespace System::Windows::Forms;
using namespace System::Drawing;
using namespace System::Collections;
// Implements the manual sorting of items by columns.
ref class ListViewItemComparer: public IComparer
{
private:
int col;
public:
ListViewItemComparer()
{
col = 0;
}
ListViewItemComparer( int column )
{
col = column;
}
virtual int Compare( Object^ x, Object^ y )
{
return String::Compare( (dynamic_cast<ListViewItem^>(x))->SubItems[ col ]->Text,
(dynamic_cast<ListViewItem^>(y))->SubItems[ col ]->Text );
}
};
public ref class ListViewSortForm: public Form
{
private:
ListView^ listView1;
public:
ListViewSortForm()
{
// Create ListView items to add to the control.
array<String^>^temp0 = {"Banana","a","b","c"};
ListViewItem^ listViewItem1 = gcnew ListViewItem( temp0,-1,Color::Empty,Color::Yellow,nullptr );
array<String^>^temp1 = {"Cherry","v","g","t"};
ListViewItem^ listViewItem2 = gcnew ListViewItem( temp1,-1,Color::Empty,Color::Red,
gcnew System::Drawing::Font( "Microsoft Sans Serif",8.25F,FontStyle::Regular,GraphicsUnit::Point,0 ) );
array<String^>^temp2 = {"Apple","h","j","n"};
ListViewItem^ listViewItem3 = gcnew ListViewItem( temp2,-1,Color::Empty,Color::Lime,nullptr );
array<String^>^temp3 = {"Pear","y","u","i"};
ListViewItem^ listViewItem4 = gcnew ListViewItem( temp3,-1,Color::Empty,Color::FromArgb( 192, 128, 156 ),nullptr );
//Initialize the ListView control and add columns to it.
this->listView1 = gcnew ListView;
// Set the initial sorting type for the ListView.
this->listView1->Sorting = SortOrder::None;
// Disable automatic sorting to enable manual sorting.
this->listView1->View = View::Details;
// Add columns and set their text.
this->listView1->Columns->Add( gcnew ColumnHeader );
this->listView1->Columns[ 0 ]->Text = "Column 1";
this->listView1->Columns[ 0 ]->Width = 100;
listView1->Columns->Add( gcnew ColumnHeader );
listView1->Columns[ 1 ]->Text = "Column 2";
listView1->Columns->Add( gcnew ColumnHeader );
listView1->Columns[ 2 ]->Text = "Column 3";
listView1->Columns->Add( gcnew ColumnHeader );
listView1->Columns[ 3 ]->Text = "Column 4";
// Suspend control logic until form is done configuring form.
this->SuspendLayout();
// Add Items to the ListView control.
array<ListViewItem^>^temp4 = {listViewItem1,listViewItem2,listViewItem3,listViewItem4};
this->listView1->Items->AddRange( temp4 );
// Set the location and size of the ListView control.
this->listView1->Location = Point(10,10);
this->listView1->Name = "listView1";
this->listView1->Size = System::Drawing::Size( 300, 100 );
this->listView1->TabIndex = 0;
// Enable editing of the items in the ListView.
this->listView1->LabelEdit = true;
// Connect the ListView::ColumnClick event to the ColumnClick event handler.
this->listView1->ColumnClick += gcnew ColumnClickEventHandler( this, &ListViewSortForm::ColumnClick );
// Initialize the form.
this->ClientSize = System::Drawing::Size( 400, 400 );
array<Control^>^temp5 = {this->listView1};
this->Controls->AddRange( temp5 );
this->Name = "ListViewSortForm";
this->Text = "Sorted ListView Control";
// Resume lay[Out] of* the form.
this->ResumeLayout( false );
}
private:
// ColumnClick event handler.
void ColumnClick( Object^ /*o*/, ColumnClickEventArgs^ e )
{
// Set the ListViewItemSorter property to a new ListViewItemComparer
// object. Setting this property immediately sorts the
// ListView using the ListViewItemComparer object.
this->listView1->ListViewItemSorter = gcnew ListViewItemComparer( e->Column );
}
};
[System::STAThreadAttribute]
int main()
{
Application::Run( gcnew ListViewSortForm );
}
using System;
using System.Windows.Forms;
using System.Drawing;
using System.Collections;
namespace ListViewSortFormNamespace
{
public class ListViewSortForm : Form
{
private ListView listView1;
public ListViewSortForm()
{
// Create ListView items to add to the control.
ListViewItem listViewItem1 = new ListViewItem(new string[] {"Banana","a","b","c"}, -1, Color.Empty, Color.Yellow, null);
ListViewItem listViewItem2 = new ListViewItem(new string[] {"Cherry","v","g","t"}, -1, Color.Empty, Color.Red, new Font("Microsoft Sans Serif", 8.25F, FontStyle.Regular, GraphicsUnit.Point, ((System.Byte)(0))));
ListViewItem listViewItem3 = new ListViewItem(new string[] {"Apple","h","j","n"}, -1, Color.Empty, Color.Lime, null);
ListViewItem listViewItem4 = new ListViewItem(new string[] {"Pear","y","u","i"}, -1, Color.Empty, Color.FromArgb(((System.Byte)(192)), ((System.Byte)(128)), ((System.Byte)(156))), null);
//Initialize the ListView control and add columns to it.
this.listView1 = new ListView();
// Set the initial sorting type for the ListView.
this.listView1.Sorting = SortOrder.None;
// Disable automatic sorting to enable manual sorting.
this.listView1.View = View.Details;
// Add columns and set their text.
this.listView1.Columns.Add(new ColumnHeader());
this.listView1.Columns[0].Text = "Column 1";
this.listView1.Columns[0].Width = 100;
listView1.Columns.Add(new ColumnHeader());
listView1.Columns[1].Text = "Column 2";
listView1.Columns.Add(new ColumnHeader());
listView1.Columns[2].Text = "Column 3";
listView1.Columns.Add(new ColumnHeader());
listView1.Columns[3].Text = "Column 4";
// Suspend control logic until form is done configuring form.
this.SuspendLayout();
// Add Items to the ListView control.
this.listView1.Items.AddRange(new ListViewItem[] {listViewItem1,
listViewItem2,
listViewItem3,
listViewItem4});
// Set the location and size of the ListView control.
this.listView1.Location = new Point(10, 10);
this.listView1.Name = "listView1";
this.listView1.Size = new Size(300, 100);
this.listView1.TabIndex = 0;
// Enable editing of the items in the ListView.
this.listView1.LabelEdit = true;
// Connect the ListView.ColumnClick event to the ColumnClick event handler.
this.listView1.ColumnClick += new ColumnClickEventHandler(ColumnClick);
// Initialize the form.
this.ClientSize = new Size(400, 400);
this.Controls.AddRange(new Control[] {this.listView1});
this.Name = "ListViewSortForm";
this.Text = "Sorted ListView Control";
// Resume layout of the form.
this.ResumeLayout(false);
}
// ColumnClick event handler.
private void ColumnClick(object o, ColumnClickEventArgs e)
{
// Set the ListViewItemSorter property to a new ListViewItemComparer
// object. Setting this property immediately sorts the
// ListView using the ListViewItemComparer object.
this.listView1.ListViewItemSorter = new ListViewItemComparer(e.Column);
}
[System.STAThreadAttribute()]
public static void Main()
{
Application.Run(new ListViewSortForm());
}
}
// Implements the manual sorting of items by columns.
class ListViewItemComparer : IComparer
{
private int col;
public ListViewItemComparer()
{
col = 0;
}
public ListViewItemComparer(int column)
{
col = column;
}
public int Compare(object x, object y)
{
return String.Compare(((ListViewItem)x).SubItems[col].Text, ((ListViewItem)y).SubItems[col].Text);
}
}
}
Imports System.Windows.Forms
Imports System.Drawing
Imports System.Collections
Namespace ListViewSortFormNamespace
Public Class ListViewSortForm
Inherits Form
Private listView1 As ListView
Public Sub New()
' Create ListView items to add to the control.
Dim listViewItem1 As New ListViewItem(New String() {"Banana", "a", "b", "c"}, -1, Color.Empty, Color.Yellow, Nothing)
Dim listViewItem2 As New ListViewItem(New String() {"Cherry", "v", "g", "t"}, -1, Color.Empty, Color.Red, New Font("Microsoft Sans Serif", 8.25F, FontStyle.Regular, GraphicsUnit.Point, CType(0, System.Byte)))
Dim listViewItem3 As New ListViewItem(New String() {"Apple", "h", "j", "n"}, -1, Color.Empty, Color.Lime, Nothing)
Dim listViewItem4 As New ListViewItem(New String() {"Pear", "y", "u", "i"}, -1, Color.Empty, Color.FromArgb(CType(192, System.Byte), CType(128, System.Byte), CType(156, System.Byte)), Nothing)
'Initialize the ListView control and add columns to it.
Me.listView1 = New ListView
' Set the initial sorting type for the ListView.
Me.listView1.Sorting = SortOrder.None
' Disable automatic sorting to enable manual sorting.
Me.listView1.View = View.Details
' Add columns and set their text.
Me.listView1.Columns.Add(New ColumnHeader)
Me.listView1.Columns(0).Text = "Column 1"
Me.listView1.Columns(0).Width = 100
listView1.Columns.Add(New ColumnHeader)
listView1.Columns(1).Text = "Column 2"
listView1.Columns.Add(New ColumnHeader)
listView1.Columns(2).Text = "Column 3"
listView1.Columns.Add(New ColumnHeader)
listView1.Columns(3).Text = "Column 4"
' Suspend control logic until form is done configuring form.
Me.SuspendLayout()
' Add Items to the ListView control.
Me.listView1.Items.AddRange(New ListViewItem() {listViewItem1, listViewItem2, listViewItem3, listViewItem4})
' Set the location and size of the ListView control.
Me.listView1.Location = New Point(10, 10)
Me.listView1.Name = "listView1"
Me.listView1.Size = New Size(300, 100)
Me.listView1.TabIndex = 0
' Enable editing of the items in the ListView.
Me.listView1.LabelEdit = True
' Connect the ListView.ColumnClick event to the ColumnClick event handler.
AddHandler Me.listView1.ColumnClick, AddressOf ColumnClick
' Initialize the form.
Me.ClientSize = New Size(400, 400)
Me.Controls.AddRange(New Control() {Me.listView1})
Me.Name = "ListViewSortForm"
Me.Text = "Sorted ListView Control"
' Resume layout of the form.
Me.ResumeLayout(False)
End Sub
' ColumnClick event handler.
Private Sub ColumnClick(ByVal o As Object, ByVal e As ColumnClickEventArgs)
' Set the ListViewItemSorter property to a new ListViewItemComparer
' object. Setting this property immediately sorts the
' ListView using the ListViewItemComparer object.
Me.listView1.ListViewItemSorter = New ListViewItemComparer(e.Column)
End Sub
End Class
' Implements the manual sorting of items by columns.
Class ListViewItemComparer
Implements IComparer
Private col As Integer
Public Sub New()
col = 0
End Sub
Public Sub New(ByVal column As Integer)
col = column
End Sub
Public Function Compare(ByVal x As Object, ByVal y As Object) As Integer _
Implements IComparer.Compare
Return [String].Compare(CType(x, ListViewItem).SubItems(col).Text, CType(y, ListViewItem).SubItems(col).Text)
End Function
End Class
End Namespace
Weitere Informationen
Gilt für:
ListViewItem(ListViewItem+ListViewSubItem[], String, ListViewGroup)
Initialisiert eine neue Instanz der ListViewItem-Klasse mit den angegebenen Unterelementen, dem angegebenen Bild und der angegebenen Gruppe.
public:
ListViewItem(cli::array <System::Windows::Forms::ListViewItem::ListViewSubItem ^> ^ subItems, System::String ^ imageKey, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, string imageKey, System.Windows.Forms.ListViewGroup group);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, string? imageKey, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : System.Windows.Forms.ListViewItem.ListViewSubItem[] * string * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (subItems As ListViewItem.ListViewSubItem(), imageKey As String, group As ListViewGroup)
Parameter
- subItems
- ListViewItem.ListViewSubItem[]
Ein Array von ListViewItem.ListViewSubItem-Objekten, das die Unterelemente von ListViewItem darstellt.
- imageKey
- String
Der Name des Bilds in der ImageList der besitzenden ListView, in der das Element angezeigt werden soll.
- group
- ListViewGroup
Die ListViewGroup, der das Element zugewiesen werden soll.
Hinweise
Diese Version des Konstruktors ist nützlich, wenn Sie Objekte erstellen ListViewItem.ListViewSubItem , bevor Sie sie einem ListViewItem hinzufügen (z. B. um eine spezielle Formatierung anzugeben oder die Unterelemente in mehreren Elementen zu verwenden). Außerdem können Sie die Gruppe angeben, zu der ein Element gehört.
Der imageKey
Parameter gibt ein Bild in dem an, das ImageList dem besitzenden ListView Steuerelement zugeordnet ist, auf das mit der ImageList -Eigenschaft zugegriffen werden kann.
Hinweis
ListView Gruppen sind nur unter Windows XP und der Windows Server 2003-Familie (Windows XP Home Edition, Windows XP Professional, Windows Server 2003) verfügbar. Weitere Informationen finden Sie in der Übersicht für die ListViewGroup.
Gilt für:
ListViewItem(ListViewItem+ListViewSubItem[], Int32, ListViewGroup)
Initialisiert eine neue Instanz der ListViewItem-Klasse mit der Indexposition des Bilds für das Elementsymbol und einem Array von ListViewItem.ListViewSubItem-Objekten, und weist das Element der angegebenen Gruppe zu.
public:
ListViewItem(cli::array <System::Windows::Forms::ListViewItem::ListViewSubItem ^> ^ subItems, int imageIndex, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, int imageIndex, System.Windows.Forms.ListViewGroup group);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, int imageIndex, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : System.Windows.Forms.ListViewItem.ListViewSubItem[] * int * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (subItems As ListViewItem.ListViewSubItem(), imageIndex As Integer, group As ListViewGroup)
Parameter
- subItems
- ListViewItem.ListViewSubItem[]
Ein Array vom Typ ListViewItem.ListViewSubItem, das die Unterelemente des Elements darstellt.
- imageIndex
- Int32
Der nullbasierte Bildindex in der ImageList, die der ListView zugeordnet ist, die das Element enthält.
- group
- ListViewGroup
Die ListViewGroup, der das Element zugewiesen werden soll.
Hinweise
Diese Version des Konstruktors ist nützlich, wenn Sie Objekte erstellen ListViewItem.ListViewSubItem , bevor Sie sie einem ListViewItem Objekt hinzufügen (z. B. um spezielle Formatierungen anzugeben oder die Unterelemente in mehreren Elementen zu verwenden). Außerdem können Sie die Gruppe angeben, zu der ein Element gehört.
Hinweis
ListView Gruppen sind nur unter Windows XP und der Windows Server 2003-Familie (Windows XP Home Edition, Windows XP Professional, Windows Server 2003) verfügbar. Weitere Informationen finden Sie in der Übersicht für die ListViewGroup.
Weitere Informationen
Gilt für:
ListViewItem(String[], String, ListViewGroup)
Initialisiert eine neue Instanz der ListViewItem-Klasse mit Unterelementen, die den angegebenen Text, das angegebene Bild und die angegebene Gruppe enthalten.
public:
ListViewItem(cli::array <System::String ^> ^ items, System::String ^ imageKey, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string[] items, string imageKey, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string[]? items, string? imageKey, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string[] * string * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageKey As String, group As ListViewGroup)
Parameter
- items
- String[]
Ein Zeichenfolgenarray, das den Text für Unterelemente von ListViewItem darstellt.
- imageKey
- String
Der Name des Bilds in der ImageList der besitzenden ListView, in der das Element angezeigt werden soll.
- group
- ListViewGroup
Die ListViewGroup, der das Element zugewiesen werden soll.
Hinweise
Mit dieser Version des Konstruktors können Sie die Gruppe angeben, zu der ein Element gehört.
Der imageKey
Parameter gibt ein Bild in dem an, das ImageList dem besitzenden ListView Steuerelement zugeordnet ist, auf das mit der ImageList -Eigenschaft zugegriffen werden kann.
Hinweis
ListView Gruppen sind nur unter Windows XP und der Windows Server 2003-Familie (Windows XP Home Edition, Windows XP Professional, Windows Server 2003) verfügbar. Weitere Informationen finden Sie in der Übersicht für die ListViewGroup.
Gilt für:
ListViewItem(String[], Int32, ListViewGroup)
Initialisiert eine neue Instanz der ListViewItem-Klasse mit der Indexposition des Bilds für das Elementsymbol und einem Array von Zeichenfolgen, die Unterelemente darstellen, und weist das Element der angegebenen Gruppe zu.
public:
ListViewItem(cli::array <System::String ^> ^ items, int imageIndex, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string[] items, int imageIndex, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string[]? items, int imageIndex, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string[] * int * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageIndex As Integer, group As ListViewGroup)
Parameter
- items
- String[]
Ein Array von Zeichenfolgen, die Unterelemente des neuen Elements darstellen.
- imageIndex
- Int32
Der nullbasierte Bildindex in der ImageList, die der ListView zugeordnet ist, die das Element enthält.
- group
- ListViewGroup
Die ListViewGroup, der das Element zugewiesen werden soll.
Hinweise
Mit dieser Version des Konstruktors können Sie die Gruppe angeben, zu der ein Element gehört.
Hinweis
ListView Gruppen sind nur unter Windows XP und der Windows Server 2003-Familie (Windows XP Home Edition, Windows XP Professional, Windows Server 2003) verfügbar. Weitere Informationen finden Sie in der Übersicht für die ListViewGroup.
Weitere Informationen
Gilt für:
ListViewItem(String, String, ListViewGroup)
Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Text, dem angegebenen Bild und der angegebenen Gruppe.
public:
ListViewItem(System::String ^ text, System::String ^ imageKey, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string text, string imageKey, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string? text, string? imageKey, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string * string * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (text As String, imageKey As String, group As ListViewGroup)
Parameter
- text
- String
Der für das Element anzuzeigende Text. Der Text darf nicht länger als 259 Zeichen sein.
- imageKey
- String
Der Name des Bilds in der ImageList der besitzenden ListView, in der das Element angezeigt werden soll.
- group
- ListViewGroup
Die ListViewGroup, der das Element zugewiesen werden soll.
Hinweise
Mit dieser Version des Konstruktors können Sie die Gruppe angeben, zu der ein Element gehört.
Der imageKey
Parameter gibt ein Bild in dem an, das ImageList dem besitzenden ListView Steuerelement zugeordnet ist, auf das mit der ImageList -Eigenschaft zugegriffen werden kann.
Hinweis
ListView Gruppen sind nur unter Windows XP und der Windows Server 2003-Familie (Windows XP Home Edition, Windows XP Professional, Windows Server 2003) verfügbar. Weitere Informationen finden Sie in der Übersicht für die ListViewGroup.
Der Text des ListViewItem sollte nicht länger als 259 Zeichen sein, andernfalls kann unerwartetes Verhalten auftreten.
Gilt für:
ListViewItem(ListViewItem+ListViewSubItem[], String)
Initialisiert eine neue Instanz der ListViewItem-Klasse mit den angegebenen Unterelementen und dem angegebenen Bild.
public:
ListViewItem(cli::array <System::Windows::Forms::ListViewItem::ListViewSubItem ^> ^ subItems, System::String ^ imageKey);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, string imageKey);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, string? imageKey);
new System.Windows.Forms.ListViewItem : System.Windows.Forms.ListViewItem.ListViewSubItem[] * string -> System.Windows.Forms.ListViewItem
Public Sub New (subItems As ListViewItem.ListViewSubItem(), imageKey As String)
Parameter
- subItems
- ListViewItem.ListViewSubItem[]
Ein Array von ListViewItem.ListViewSubItem-Objekten.
- imageKey
- String
Der Name des Bilds in der ImageList der besitzenden ListView, das im ListViewItem angezeigt werden soll.
Hinweise
Der imageKey
Parameter gibt ein Bild in dem an, das ImageList dem besitzenden ListView Steuerelement zugeordnet ist, auf das mit der ImageList -Eigenschaft zugegriffen werden kann.
Gilt für:
ListViewItem(String, Int32, ListViewGroup)
Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Elementtext und der Indexposition des Bilds für das Elementsymbol, und weist das Element der angegebenen Gruppe zu.
public:
ListViewItem(System::String ^ text, int imageIndex, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string text, int imageIndex, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string? text, int imageIndex, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string * int * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (text As String, imageIndex As Integer, group As ListViewGroup)
Parameter
- text
- String
Der für das Element anzuzeigende Text. Der Text darf nicht länger als 259 Zeichen sein.
- imageIndex
- Int32
Der nullbasierte Bildindex in der ImageList, die der ListView zugeordnet ist, die das Element enthält.
- group
- ListViewGroup
Die ListViewGroup, der das Element zugewiesen werden soll.
Hinweise
Mit dieser Version des Konstruktors können Sie die Gruppe angeben, zu der ein Element gehört.
Hinweis
ListView Gruppen sind nur unter Windows XP und der Windows Server 2003-Familie (Windows XP Home Edition, Windows XP Professional, Windows Server 2003) verfügbar. Weitere Informationen finden Sie in der Übersicht für die ListViewGroup.
Der Text des ListViewItem sollte nicht länger als 259 Zeichen sein, andernfalls kann unerwartetes Verhalten auftreten.
Weitere Informationen
Gilt für:
ListViewItem(String[], ListViewGroup)
Initialisiert eine neue Instanz der ListViewItem-Klasse mit einem Array von Zeichenfolgen, die Unterelemente darstellen, und weist das Element der angegebenen Gruppe zu.
public:
ListViewItem(cli::array <System::String ^> ^ items, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string[] items, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string[]? items, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string[] * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), group As ListViewGroup)
Parameter
- items
- String[]
Ein Array von Zeichenfolgen, die Unterelemente des neuen Elements darstellen.
- group
- ListViewGroup
Die ListViewGroup, der das Element zugewiesen werden soll.
Hinweise
Mit dieser Version des Konstruktors können Sie die Gruppe angeben, zu der ein Element gehört.
Hinweis
ListView Gruppen sind nur unter Windows XP und der Windows Server 2003-Familie (Windows XP Home Edition, Windows XP Professional, Windows Server 2003) verfügbar. Weitere Informationen finden Sie in der Übersicht für die ListViewGroup.
Weitere Informationen
Gilt für:
ListViewItem(String[], String)
Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Element, dem angegebenen Unterelementtext und dem angegebenen Bild.
public:
ListViewItem(cli::array <System::String ^> ^ items, System::String ^ imageKey);
public ListViewItem (string[] items, string imageKey);
public ListViewItem (string[]? items, string? imageKey);
new System.Windows.Forms.ListViewItem : string[] * string -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageKey As String)
Parameter
- items
- String[]
Ein Array, das den Text der Unterelemente der ListViewItem enthält.
- imageKey
- String
Der Name des Bilds in der ImageList der besitzenden ListView, das im ListViewItem angezeigt werden soll.
Hinweise
Der imageKey
Parameter gibt ein Bild in dem an, das ImageList dem besitzenden ListView Steuerelement zugeordnet ist, auf das mit der ImageList -Eigenschaft zugegriffen werden kann.
Gilt für:
ListViewItem(String[], Int32)
Initialisiert eine neue Instanz der ListViewItem-Klasse mit der Indexposition des Bilds für das Elementsymbol und einem Array von Zeichenfolgen, die Unterelemente darstellen.
public:
ListViewItem(cli::array <System::String ^> ^ items, int imageIndex);
public ListViewItem (string[] items, int imageIndex);
public ListViewItem (string[]? items, int imageIndex);
new System.Windows.Forms.ListViewItem : string[] * int -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageIndex As Integer)
Parameter
- items
- String[]
Ein Array von Zeichenfolgen, die Unterelemente des neuen Elements darstellen.
- imageIndex
- Int32
Der nullbasierte Bildindex in der ImageList, die der ListView zugeordnet ist, die das Element enthält.
Weitere Informationen
Gilt für:
ListViewItem(String, ListViewGroup)
Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Elementtext und weist diese der angegebenen Gruppe zu.
public:
ListViewItem(System::String ^ text, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string text, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string? text, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (text As String, group As ListViewGroup)
Parameter
- text
- String
Der für das Element anzuzeigende Text. Der Text darf nicht länger als 259 Zeichen sein.
- group
- ListViewGroup
Die ListViewGroup, der das Element zugewiesen werden soll.
Hinweise
Mit dieser Version des Konstruktors können Sie die Gruppe angeben, zu der ein Element gehört.
Hinweis
ListView Gruppen sind nur unter Windows XP und der Windows Server 2003-Familie (Windows XP Home Edition, Windows XP Professional, Windows Server 2003) verfügbar. Weitere Informationen finden Sie in der Übersicht für die ListViewGroup.
Der Text des ListViewItem sollte nicht länger als 259 Zeichen sein, andernfalls kann unerwartetes Verhalten auftreten.
Weitere Informationen
Gilt für:
ListViewItem(String, String)
Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Text und dem angegebenen Bild.
public:
ListViewItem(System::String ^ text, System::String ^ imageKey);
public ListViewItem (string text, string imageKey);
public ListViewItem (string? text, string? imageKey);
new System.Windows.Forms.ListViewItem : string * string -> System.Windows.Forms.ListViewItem
Public Sub New (text As String, imageKey As String)
Parameter
- text
- String
Der für das Element anzuzeigende Text. Der Text darf nicht länger als 259 Zeichen sein.
- imageKey
- String
Der Name des Bilds in der ImageList der besitzenden ListView, das im ListViewItem angezeigt werden soll.
Hinweise
Der imageKey
Parameter gibt ein Bild in dem an, das ImageList dem besitzenden ListView Steuerelement zugeordnet ist, auf das mit der ImageList -Eigenschaft zugegriffen werden kann.
Der Text des ListViewItem sollte nicht länger als 259 Zeichen sein, andernfalls kann unerwartetes Verhalten auftreten.
Gilt für:
ListViewItem(String, Int32)
Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Elementtext und der Indexposition des Bilds für das Elementsymbol.
public:
ListViewItem(System::String ^ text, int imageIndex);
public ListViewItem (string text, int imageIndex);
public ListViewItem (string? text, int imageIndex);
new System.Windows.Forms.ListViewItem : string * int -> System.Windows.Forms.ListViewItem
Public Sub New (text As String, imageIndex As Integer)
Parameter
- text
- String
Der für das Element anzuzeigende Text. Der Text darf nicht länger als 259 Zeichen sein.
- imageIndex
- Int32
Der nullbasierte Bildindex in der ImageList, die der ListView zugeordnet ist, die das Element enthält.
Hinweise
Der Text des ListViewItem sollte nicht länger als 259 Zeichen sein, andernfalls kann unerwartetes Verhalten auftreten.
Weitere Informationen
Gilt für:
ListViewItem(SerializationInfo, StreamingContext)
Initialisiert eine neue Instanz der ListViewItem-Klasse mit den angegebenen Serialisierungsinformationen und dem angegebenen Streamingkontext
protected:
ListViewItem(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);
protected ListViewItem (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
new System.Windows.Forms.ListViewItem : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Windows.Forms.ListViewItem
Protected Sub New (info As SerializationInfo, context As StreamingContext)
Parameter
- info
- SerializationInfo
Eine SerializationInfo, die Informationen über das zu initialisierende ListViewItem enthält.
- context
- StreamingContext
Ein StreamingContext, der das Quellziel und die Kontextinformationen eines serialisierten Streams angibt.
Gilt für:
ListViewItem(ListViewGroup)
Initialisiert eine neue Instanz der ListViewItem-Klasse und weist diese der angegebenen Gruppe zu.
public:
ListViewItem(System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (System.Windows.Forms.ListViewGroup group);
public ListViewItem (System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (group As ListViewGroup)
Parameter
- group
- ListViewGroup
Die ListViewGroup, der das Element zugewiesen werden soll.
Hinweise
Mit dieser Version des Konstruktors können Sie die Gruppe angeben, zu der ein Element gehört.
Hinweis
ListView Gruppen sind nur unter Windows XP und der Windows Server 2003-Familie (Windows XP Home Edition, Windows XP Professional, Windows Server 2003) verfügbar. Weitere Informationen finden Sie in der Übersicht für die ListViewGroup.
Weitere Informationen
Gilt für:
ListViewItem(String[])
Initialisiert eine neue Instanz der ListViewItem-Klasse mit einem Array von Zeichenfolgen, die Unterelemente darstellen.
public:
ListViewItem(cli::array <System::String ^> ^ items);
public ListViewItem (string[] items);
public ListViewItem (string[]? items);
new System.Windows.Forms.ListViewItem : string[] -> System.Windows.Forms.ListViewItem
Public Sub New (items As String())
Parameter
- items
- String[]
Ein Array von Zeichenfolgen, die Unterelemente des neuen Elements darstellen.
Gilt für:
ListViewItem(String)
Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Elementtext.
public:
ListViewItem(System::String ^ text);
public ListViewItem (string text);
public ListViewItem (string? text);
new System.Windows.Forms.ListViewItem : string -> System.Windows.Forms.ListViewItem
Public Sub New (text As String)
Parameter
- text
- String
Der für das Element anzuzeigende Text. Der Text darf nicht länger als 259 Zeichen sein.
Hinweise
Der Text des ListViewItem sollte nicht länger als 259 Zeichen sein, andernfalls kann unerwartetes Verhalten auftreten.
Gilt für:
ListViewItem(ListViewItem+ListViewSubItem[], Int32)
Initialisiert eine neue Instanz der ListViewItem-Klasse mit der Indexposition des Bilds für das Elementsymbol und einem Array von ListViewItem.ListViewSubItem-Objekten.
public:
ListViewItem(cli::array <System::Windows::Forms::ListViewItem::ListViewSubItem ^> ^ subItems, int imageIndex);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, int imageIndex);
new System.Windows.Forms.ListViewItem : System.Windows.Forms.ListViewItem.ListViewSubItem[] * int -> System.Windows.Forms.ListViewItem
Public Sub New (subItems As ListViewItem.ListViewSubItem(), imageIndex As Integer)
Parameter
- subItems
- ListViewItem.ListViewSubItem[]
Ein Array vom Typ ListViewItem.ListViewSubItem, das die Unterelemente des Elements darstellt.
- imageIndex
- Int32
Der nullbasierte Bildindex in der ImageList, die der ListView zugeordnet ist, die das Element enthält.
Hinweise
Diese Version des Konstruktors ist nützlich, wenn Sie Objekte erstellen ListViewItem.ListViewSubItem , bevor Sie sie einem ListViewItem hinzufügen (z. B. um eine spezielle Formatierung anzugeben oder die Unterelemente in mehreren Elementen zu verwenden).