ListViewItem 建構函式
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
初始化 ListViewItem 類別的新執行個體。
多載
ListViewItem()
使用預設值,初始化 ListViewItem 類別的新實例。
public:
ListViewItem();
public ListViewItem();
Public Sub New ()
範例
以下程式碼範例建立一個 ListView 控制項,每個項目指定三個 ListViewItem 物件與三個 ListViewItem.ListViewSubItem 物件。 範例中也會建立 ColumnHeader 物件,在詳細檢視中顯示子項目。 程式碼範例中也建立了兩個 ImageList 物件,以提供物件 ListViewItem 的影像。 這些 ImageList 物件會被 LargeImageList 加入到 和 SmallImageList 屬性中。 範例中在建立控制項 ListView 時使用了以下屬性:
你需要把程式碼加入 a Form ,然後從建構子或表單中的另一個方法呼叫範例中建立的方法。 範例要求名為 MySmallImage1、 MySmallImage2、 MyLargeImage1和 MyLargeImage2 的影像必須位於磁碟 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
適用於
ListViewItem(String[], String, Color, Color, Font, ListViewGroup)
初始化一個新的類別實例 ListViewItem ,子項目包含指定的文字、圖片、顏色、字型與群組。
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)
參數
- items
- String[]
一個字串陣列,代表子項目 ListViewItem的文字。
- group
- ListViewGroup
ListViewGroup然後把物品分配給他們。
備註
這個版本的建構器允許你指定項目所屬的群組。
參數 imageKey 指定與 ImageList 擁有 ListView 控制項相關的影像,可透過屬性 ImageList 存取。
備註
ListView 群組僅在 Windows XP 及 Windows Server 2003 家族(Windows XP 家庭版、Windows XP 專業版、Windows Server 2003)上提供。 欲了解更多資訊,請參閱 ListViewGroup 概述主題。
適用於
ListViewItem(String[], Int32, Color, Color, Font, ListViewGroup)
初始化一個新的類別實例 ListViewItem ,包含該項目圖示的圖片索引位置;項目的前景色、背景色與字型;以及代表子項目的字串陣列。 將該項目分配給指定的群組。
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)
參數
- items
- String[]
一組字串,代表新項目的子項目。
- group
- ListViewGroup
ListViewGroup然後把物品分配給他們。
備註
這個版本的建構器允許你指定項目所屬的群組。
備註
ListView 群組僅在 Windows XP 及 Windows Server 2003 家族(Windows XP 家庭版、Windows XP 專業版、Windows Server 2003)上提供。 欲了解更多資訊,請參閱 ListViewGroup 概述主題。
另請參閱
適用於
ListViewItem(String[], String, Color, Color, Font)
初始化一個新的類別實例 ListViewItem ,子項目包含指定的文字、圖片、顏色與字型。
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)
參數
- items
- String[]
一組字串陣列,代表子項目 ListViewItem的文字。
備註
參數 imageKey 指定與 ImageList 擁有 ListView 控制項相關的影像,可透過屬性 ImageList 存取。
適用於
ListViewItem(String[], Int32, Color, Color, Font)
初始化一個新的類別實例 ListViewItem ,包含該項目圖示的圖片索引位置;項目的前景色、背景色與字型;以及代表子項目的字串陣列。
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)
參數
- items
- String[]
一組字串,代表新項目的子項目。
範例
以下程式碼範例建立一個表單,包含 ListView 一個控制項,當點擊控制項欄位 ListView 時,手動排序項目。 範例定義了一個稱為ListViewItemComparer實作執行比較介面ListViewItem的System.Collections.IComparer類別。 範例建立一個 實 ListViewItemComparer 例,並用它來設定 ListViewItemSorter 控制項的 ListView 屬性。
Sort事件處理程序ColumnClick中的方法呼叫會使用中ListViewItemComparer定義的方法,根據點擊的欄位執行項目類型。
#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
另請參閱
適用於
ListViewItem(ListViewItem+ListViewSubItem[], String, ListViewGroup)
初始化一個新的類別實例 ListViewItem ,包含指定的子項目、影像與群組。
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)
參數
- subItems
- ListViewItem.ListViewSubItem[]
一個代表子項目ListViewItem的物件陣列ListViewItem.ListViewSubItem。
- group
- ListViewGroup
ListViewGroup然後把物品分配給他們。
備註
這個版本的建構器在你先建立 ListViewItem.ListViewSubItem 物件後再加入 ListViewItem 物件時非常有用(例如,用來表示特殊格式或在多個項目中使用子項目)。 它也允許你指定物品所屬的群組。
參數 imageKey 指定與 ImageList 擁有 ListView 控制項相關的影像,可透過屬性 ImageList 存取。
備註
ListView 群組僅在 Windows XP 及 Windows Server 2003 家族(Windows XP 家庭版、Windows XP 專業版、Windows Server 2003)上提供。 欲了解更多資訊,請參閱 ListViewGroup 概述主題。
適用於
ListViewItem(ListViewItem+ListViewSubItem[], Int32, ListViewGroup)
初始化一個新的類別實例 ListViewItem ,使用該項目圖示的圖像索引位置及物件陣列 ListViewItem.ListViewSubItem ,並將該項目指派到指定的群組。
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)
參數
- subItems
- ListViewItem.ListViewSubItem[]
一個型別 ListViewItem.ListViewSubItem 的陣列,代表該項目的子項目。
- group
- ListViewGroup
ListViewGroup然後把物品分配給他們。
備註
這個版本的建構子在你先建立 ListViewItem.ListViewSubItem 物件後再加入 ListViewItem 物件時很有用(例如,用來表示特殊格式或在多個項目中使用子項目)。 它也允許你指定物品所屬的群組。
備註
ListView 群組僅在 Windows XP 及 Windows Server 2003 家族(Windows XP 家庭版、Windows XP 專業版、Windows Server 2003)上提供。 欲了解更多資訊,請參閱 ListViewGroup 概述主題。
另請參閱
適用於
ListViewItem(String[], String, ListViewGroup)
初始化該類別的新實例 ListViewItem ,包含包含指定文字、圖片與群組的子項目。
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)
參數
- items
- String[]
一個字串陣列,代表子項目 ListViewItem的文字。
- group
- ListViewGroup
ListViewGroup然後把物品分配給他們。
備註
這個版本的建構器允許你指定項目所屬的群組。
參數 imageKey 指定與 ImageList 擁有 ListView 控制項相關的影像,可透過屬性 ImageList 存取。
備註
ListView 群組僅在 Windows XP 及 Windows Server 2003 家族(Windows XP 家庭版、Windows XP 專業版、Windows Server 2003)上提供。 欲了解更多資訊,請參閱 ListViewGroup 概述主題。
適用於
ListViewItem(String[], Int32, ListViewGroup)
初始化一個新的類別實例 ListViewItem ,使用該項目圖示的圖像索引位置及代表子項目的字串陣列,並將該項目指派到指定的群組。
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)
參數
- items
- String[]
一組字串,代表新項目的子項目。
- group
- ListViewGroup
ListViewGroup然後把物品分配給他們。
備註
這個版本的建構器允許你指定項目所屬的群組。
備註
ListView 群組僅在 Windows XP 及 Windows Server 2003 家族(Windows XP 家庭版、Windows XP 專業版、Windows Server 2003)上提供。 欲了解更多資訊,請參閱 ListViewGroup 概述主題。
另請參閱
適用於
ListViewItem(String, String, ListViewGroup)
初始化一個新的類別實例 ListViewItem ,包含指定的文字、圖片和群組。
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)
參數
- text
- String
要顯示該物品的文字。 字元數不應超過259字元。
- group
- ListViewGroup
ListViewGroup然後把物品分配給他們。
備註
這個版本的建構器允許你指定項目所屬的群組。
參數 imageKey 指定與 ImageList 擁有 ListView 控制項相關的影像,可透過屬性 ImageList 存取。
備註
ListView 群組僅在 Windows XP 及 Windows Server 2003 家族(Windows XP 家庭版、Windows XP 專業版、Windows Server 2003)上提供。 欲了解更多資訊,請參閱 ListViewGroup 概述主題。
ListViewItem文字長度不應超過259字元,否則可能會發生意外行為。
適用於
ListViewItem(ListViewItem+ListViewSubItem[], String)
初始化一個新的類別實例 ListViewItem ,並使用指定的子項目與映像。
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)
參數
- subItems
- ListViewItem.ListViewSubItem[]
ListViewItem.ListViewSubItem 物件的陣列。
- imageKey
- String
擁有者中要顯示ListViewItem的圖片ImageListListView名稱。
備註
參數 imageKey 指定與 ImageList 擁有 ListView 控制項相關的影像,可透過屬性 ImageList 存取。
適用於
ListViewItem(String, Int32, ListViewGroup)
初始化一個新的類別實例 ListViewItem ,使用指定的項目文字和項目圖示的圖片索引位置,並將項目指派到指定的群組。
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)
參數
- text
- String
要顯示該物品的文字。 字元數不應超過259字元。
- group
- ListViewGroup
ListViewGroup然後把物品分配給他們。
備註
這個版本的建構器允許你指定項目所屬的群組。
備註
ListView 群組僅在 Windows XP 及 Windows Server 2003 家族(Windows XP 家庭版、Windows XP 專業版、Windows Server 2003)上提供。 欲了解更多資訊,請參閱 ListViewGroup 概述主題。
ListViewItem文字長度不應超過259字元,否則可能會發生意外行為。
另請參閱
適用於
ListViewItem(String[], ListViewGroup)
初始化一個新的類別實例 ListViewItem ,並用代表子項的字串陣列,並將該項目指派到指定的群組。
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)
參數
- items
- String[]
一組字串,代表新項目的子項目。
- group
- ListViewGroup
ListViewGroup然後把物品分配給他們。
備註
這個版本的建構器允許你指定項目所屬的群組。
備註
ListView 群組僅在 Windows XP 及 Windows Server 2003 家族(Windows XP 家庭版、Windows XP 專業版、Windows Server 2003)上提供。 欲了解更多資訊,請參閱 ListViewGroup 概述主題。
另請參閱
適用於
ListViewItem(String[], String)
初始化一個新的類別實例 ListViewItem ,包含指定的項目及子項目文字與圖片。
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)
參數
- items
- String[]
一個包含子項目 ListViewItem文字的陣列。
- imageKey
- String
擁有者中要顯示ListViewItem的圖片ImageListListView名稱。
備註
參數 imageKey 指定與 ImageList 擁有 ListView 控制項相關的影像,可透過屬性 ImageList 存取。
適用於
ListViewItem(String[], Int32)
初始化一個新的類別實例 ListViewItem ,並以該項目圖示的圖片索引位置及代表子項目的字串陣列初始化。
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)
參數
- items
- String[]
一組字串,代表新項目的子項目。
另請參閱
適用於
ListViewItem(String, ListViewGroup)
初始化一個包含指定項目文本的類別實例 ListViewItem ,並將其指派到指定的群組。
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)
參數
- text
- String
要顯示該物品的文字。 字元數不應超過259字元。
- group
- ListViewGroup
ListViewGroup然後把物品分配給他們。
備註
這個版本的建構器允許你指定項目所屬的群組。
備註
ListView 群組僅在 Windows XP 及 Windows Server 2003 家族(Windows XP 家庭版、Windows XP 專業版、Windows Server 2003)上提供。 欲了解更多資訊,請參閱 ListViewGroup 概述主題。
ListViewItem文字長度不應超過259字元,否則可能會發生意外行為。
另請參閱
適用於
ListViewItem(String, String)
初始化一個新的類別實例 ListViewItem ,並使用指定的文字與圖片。
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)
參數
- text
- String
要顯示該物品的文字。 字元數不應超過259字元。
- imageKey
- String
擁有者中要顯示ListViewItem的圖片ImageListListView名稱。
備註
參數 imageKey 指定與 ImageList 擁有 ListView 控制項相關的影像,可透過屬性 ImageList 存取。
ListViewItem文字長度不應超過259字元,否則可能會發生意外行為。
適用於
ListViewItem(String, Int32)
初始化一個新的類別實例 ListViewItem ,包含指定的項目文字及項目圖示的圖片索引位置。
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)
參數
- text
- String
要顯示該物品的文字。 字元數不應超過259字元。
備註
ListViewItem文字長度不應超過259字元,否則可能會發生意外行為。
另請參閱
適用於
ListViewItem(SerializationInfo, StreamingContext)
初始化一個新的類別實例 ListViewItem ,並使用指定的序列化資訊與串流上下文。
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)
參數
- info
- SerializationInfo
SerializationInfo A 包含關於待初始化的ListViewItem資訊。
- context
- StreamingContext
A StreamingContext 表示序列化串流的來源目的地及上下文資訊。
適用於
ListViewItem(ListViewGroup)
初始化該類別的新實例 ListViewItem 並將其指派到指定的群組。
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)
參數
- group
- ListViewGroup
ListViewGroup然後把物品分配給他們。
備註
這個版本的建構器允許你指定項目所屬的群組。
備註
ListView 群組僅在 Windows XP 及 Windows Server 2003 家族(Windows XP 家庭版、Windows XP 專業版、Windows Server 2003)上提供。 欲了解更多資訊,請參閱 ListViewGroup 概述主題。
另請參閱
適用於
ListViewItem(String[])
初始化類別的新實例 ListViewItem ,並以代表子項目的字串陣列初始化。
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())
參數
- items
- String[]
一組字串,代表新項目的子項目。
適用於
ListViewItem(String)
初始化一個新的類別實例 ListViewItem ,並使用指定的項目文本。
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)
參數
- text
- String
要顯示該物品的文字。 字元數不應超過259字元。
備註
ListViewItem文字長度不應超過259字元,否則可能會發生意外行為。
適用於
ListViewItem(ListViewItem+ListViewSubItem[], Int32)
初始化一個新的類別實例 ListViewItem ,包含該項目圖示的圖片索引位置及物件陣列 ListViewItem.ListViewSubItem 。
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)
參數
- subItems
- ListViewItem.ListViewSubItem[]
一個型別 ListViewItem.ListViewSubItem 的陣列,代表該項目的子項目。
備註
這個版本的建構器在你先建立 ListViewItem.ListViewSubItem 物件後再加入 ListViewItem 物件時非常有用(例如,用來表示特殊格式或在多個項目中使用子項目)。