ListView 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
代表 Windows 清單檢視控制項,顯示出使用四種不同檢視的其中一個就可以顯示出來的項目集合。
public ref class ListView : System::Windows::Forms::Control
public class ListView : System.Windows.Forms.Control
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Windows.Forms.Docking(System.Windows.Forms.DockingBehavior.Ask)]
public class ListView : System.Windows.Forms.Control
[System.Windows.Forms.Docking(System.Windows.Forms.DockingBehavior.Ask)]
public class ListView : System.Windows.Forms.Control
type ListView = class
inherit Control
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Windows.Forms.Docking(System.Windows.Forms.DockingBehavior.Ask)>]
type ListView = class
inherit Control
[<System.Windows.Forms.Docking(System.Windows.Forms.DockingBehavior.Ask)>]
type ListView = class
inherit Control
Public Class ListView
Inherits Control
- 繼承
- 屬性
範例
下列程式碼範例會建立控制項,其中指定三 ListViewItem 個物件,以及針對每個專案指定的三 ListViewItem.ListViewSubItem 個 ListView 物件。 此範例也會建立 ColumnHeader 物件,以顯示詳細資料檢視中的子專案。 程式碼範例中也會建立兩 ImageList 個 物件,以提供 物件的影像 ListViewItem 。 這些 ImageList 物件會新增至 LargeImageList 和 SmallImageList 屬性。 此範例會在建立 ListView 控制項時使用下列屬性:
此範例會要求您將程式碼新增至 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
備註
控制項 ListView 可讓您顯示具有專案文字的專案清單,並選擇性地顯示圖示來識別專案類型。 例如,檔案的 Windows 檔案總管清單外觀 ListView 類似于 控制項。 它會顯示樹狀結構中目前選取的檔案和資料夾清單。 每個檔案和資料夾都會顯示與其相關聯的圖示,以協助識別檔案或資料夾的類型。 類別 ListViewItem 代表 控制項內的 ListView 專案。 清單中顯示的專案可以顯示在五個不同檢視的其中之一。 專案可以顯示為大型圖示、小型圖示或垂直清單中的小圖示。 專案也可以有子專案,其中包含與父專案相關的資訊。 詳細資料檢視可讓您在方格中顯示專案及其子專案,其中包含可識別子專案中所顯示資訊的資料行標頭。 圖格檢視具有有限的可用性,如下所述,可讓您將專案及其子專案顯示為圖格,其中包含文字資訊旁的大型圖示。 ListView 支援單一或多個選取。 多重選取功能可讓使用者以類似 ListBox 控制項的方式,從專案清單中選取。 此外,使用者可以啟動選取的專案來執行工作。 例如,您可以使用 ListView 控制項來顯示應用程式接著可以開啟及利用的檔案清單。 使用者可以選取要開啟的檔案,然後按兩下它們來啟動專案,並在應用程式中開啟檔案。 ListView也可以使用 屬性來顯示覆選框 CheckBoxes ,讓使用者檢查他們想要執行動作的專案。 您可以使用各種方式使用 ListView 控制項。 控制項可用來顯示應用程式、資料庫或文字檔中的資訊。 ListView也可以用來從使用者取得資訊,例如選取一組要處理的檔案。
ListView 提供大量的屬性,可提供外觀和行為的彈性。 屬性 View 可讓您變更顯示專案的方式。 LargeImageList、 SmallImageList 和 StateImageList 屬性可讓您指定 ImageList 物件,這些物件包含針對專案顯示的影像,如果是 StateImageList ,則會在 屬性設定 true
為 時 CheckBoxes 顯示覆選框。 若要判斷要檢查哪些專案,您可以使用 CheckedItems 屬性來存取 ListView.CheckedListViewItemCollection 集合。 屬性 Columns 允許存取 ListView.ColumnHeaderCollection ,這會儲存控制項的 屬性設定 Details 為 時 View 所顯示的資料行標頭。 專案會透過 Items 屬性從 新增和移除 ListView 。 屬性 Items 可讓您存取 ListView.ListViewItemCollection 控制項的 ,其提供用來操作 控制項中專案的方法。 如果您想要允許使用者編輯專案的文字,您可以使用 LabelEdit 屬性。 當您的控制項包含大量專案時,使用者通常更容易在已排序的清單中看到這些專案。 您可以使用 Sorting 屬性依字母順序排序專案。 您也可以完全自訂控制項的外觀 ListView 。 若要這樣做,請將 OwnerDraw 屬性設定為 true
,並處理下列一或多個事件: DrawItem 、、 DrawSubItemDrawColumnHeader 。
當 控制項的 ListView 屬性設定為 Details 時 View ,會使用控制項的許多屬性。 屬性 AllowColumnReorder 可讓使用者在 ListView 執行時間重新設定資料行的順序。 屬性 FullRowSelect 允許選取專案及其子專案,而不只是選取專案。 若要在詳細資料檢視中顯示格線,以識別 中的 ListView 專案和子專案界限,您可以使用 GridLines 屬性。 屬性 HeaderStyle 可讓您指定要顯示的資料行標頭類型。
控制項 ListView 可以在虛擬模式中運作,其中 ListViewItem 會動態產生物件,而不是儲存在集合中 Items 。 這適用于處理經常變更其內容的大型清單或清單。 若要啟用虛擬模式,請將 VirtualMode 屬性設定為 true
,並處理 RetrieveVirtualItem 、 CacheVirtualItems 和 SearchForVirtualItem 事件。
除了控制項可用的 ListView 許多屬性之外,還有一些方法和事件可供您的應用程式用來提供其他功能給 ListView 。 BeginUpdate和 EndUpdate 方法可讓您藉由防止控制項在每次加入專案時重繪,以改善將許多專案新增至 ListView 的效能。 ListView如果您的控制項正在顯示專案和子專案,您可以在使用者以滑鼠右鍵按一下子專案時提供功能。 若要判斷要按一下其子專案的專案,您可以使用 GetItemAt 方法。 在使用者編輯專案之後執行專案的驗證時,您可能會想要向使用者顯示特定專案以變更。 EnsureVisible您可以呼叫 方法,以確保特定專案位於控制項的可見區域中。
如果 屬性 LabelEdit 設定為 true
,您可以藉由為 和 AfterLabelEdit 事件建立事件處理常式 BeforeLabelEdit ,執行驗證文字之前和之後所編輯的文字等工作。 若要執行開啟檔案或顯示對話方塊等工作,以編輯 中顯示的 ListView 專案,您可以建立 ItemActivate 事件的事件處理常式。 如果您允許使用者在按一下資料行標頭時排序 中的 ListView 專案,您可以為 ColumnClick 事件建立事件處理常式來執行排序。 CheckBoxes當 屬性設定為 true
時,您可以藉由處理 ItemCheck 事件來判斷專案檢查狀態的變更何時發生。
您也可以使用 BackgroundImage 屬性來設定 的背景影像 ListView 。 您的應用程式必須具有 STAThreadAttribute 其 Main
方法的 ,才能正確顯示控制項的背景影像 ListView 。 此外,如果 ListView 具有背景影像的控制項裝載于 Internet Explorer 中,請在應用程式資訊清單檔案中指定 comctl32.dll 6.0 版做為相依元件,以確保背景影像為屬性顯示。
Windows XP 和 Windows Server 2003 提供三個功能,可在應用程式呼叫 Application.EnableVisualStyles 方法時增強 ListView 控制項:磚檢視、群組和插入標記。
磚檢視可讓您藉由顯示大型圖示旁的專案和子專案文字,來平衡圖形和文字資訊。 將 View 屬性設定為 View.Tile 以啟用此行為。
群組功能可讓您以視覺化方式將專案分組成相關的類別。 Groups當您想要啟用此功能時,請使用 屬性將物件新增 ListViewGroup 至 ListView 控制項。 若要暫時停用此功能,請將 ShowGroups 屬性設定為 false
。
插入標記功能可讓您使用視覺化回饋來提供拖放專案重新置放,以指出置放位置。 ListViewInsertionMark使用透過 屬性擷取的物件 InsertionMark 來顯示插入標記。
這些功能僅適用于 Windows XP 和 Windows Server 2003。 在舊版作業系統上,與這些功能相關的程式碼沒有任何作用,磚檢視會顯示為大型圖示檢視,且插入標記和群組不會顯示。 在某些情況下,您可能想要包含可判斷這些功能是否可用的程式碼,並在無法使用時提供替代功能。 這些功能是由提供作業系統主題功能的相同程式庫所提供。 若要檢查此程式庫的可用性,請呼叫 FeatureSupport.IsPresent(Object) 方法多載並傳入 OSFeature.Themes 值。
下表顯示其中一些 ListView 成員及其有效的檢視。
ListView 成員 | 檢視 |
---|---|
Alignment 屬性 | SmallIcon 或 LargeIcon |
AutoArrange 屬性 | SmallIcon 或 LargeIcon |
AutoResizeColumn 方法 | Details |
Columns 屬性 | Details 或 Tile |
DrawSubItem 事件 | Details |
FindItemWithText 方法 | Details、 List或 Tile |
FindNearestItem 方法 | SmallIcon 或 LargeIcon |
GetItemAt 方法 | Details 或 Tile |
Groups 屬性 | 除了 以外的所有檢視 List |
HeaderStyle 屬性 | Details |
InsertionMark 屬性 | LargeIcon、 SmallIcon或 Tile |
建構函式
ListView() |
初始化 ListView 類別的新執行個體。 |
屬性
AccessibilityObject |
取得指定給控制項的 AccessibleObject。 (繼承來源 Control) |
AccessibleDefaultActionDescription |
取得或設定協助用戶端應用程式所使用的控制項的預設動作描述。 (繼承來源 Control) |
AccessibleDescription |
取得或設定協助工具用戶端應用程式使用之控制項的描述。 (繼承來源 Control) |
AccessibleName |
取得或設定協助工具用戶端應用程式使用的控制項名稱。 (繼承來源 Control) |
AccessibleRole |
取得或設定控制項的可存取角色。 (繼承來源 Control) |
Activation |
取得或設定使用者必須採取才能夠啟動項目的動作類型。 |
Alignment |
取得或設定控制項中項目的對齊。 |
AllowColumnReorder |
取得或設定值,指出使用者是否可以拖曳資料行標頭,將控制項中的資料行重新排列。 |
AllowDrop |
取得或設定值,指出控制項是否能接受使用者拖放上來的資料。 (繼承來源 Control) |
Anchor |
取得或設定控制項繫結至的容器邊緣,並決定控制項隨其父代重新調整大小的方式。 (繼承來源 Control) |
AutoArrange |
取得或設定是否自動將圖示保持為已管理。 |
AutoScrollOffset |
取得或設定此控制項在 ScrollControlIntoView(Control) 中要捲動到哪一個位置。 (繼承來源 Control) |
AutoSize |
這個屬性與這個類別無關。 (繼承來源 Control) |
BackColor |
取得或設定背景色彩。 |
BackgroundImage |
取得或設定在此 ListView 控制項中顯示的背景影像。 |
BackgroundImage |
取得或設定在控制項中顯示的背景影像。 (繼承來源 Control) |
BackgroundImageLayout |
取得或設定 ImageLayout 值。 |
BackgroundImageLayout |
取得或設定在 ImageLayout 列舉類型中所定義的背景影像配置。 (繼承來源 Control) |
BackgroundImageTiled |
取得或設定值,指出 ListView 的背景影像是否應該並排顯示。 |
BindingContext |
取得或設定控制項的 BindingContext。 (繼承來源 Control) |
BorderStyle |
取得或設定控制項的框線樣式。 |
Bottom |
取得控制項下邊緣和其容器工作區 (Client Area) 上邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
Bounds |
取得或設定控制項 (包括其非工作區項目) 相對於父控制項之大小和位置 (單位為像素)。 (繼承來源 Control) |
CanEnableIme |
取得值,這個值表示 ImeMode 屬性是否可以設定為使用中的值,以啟用 IME 支援。 (繼承來源 Control) |
CanFocus |
取得指示控制項是否能取得焦點的值。 (繼承來源 Control) |
CanRaiseEvents |
判斷是否可以在控制項上引發事件。 (繼承來源 Control) |
CanSelect |
取得指示能否選取控制項的值。 (繼承來源 Control) |
Capture |
取得或設定值,指出控制項是否捕捉住滑鼠。 (繼承來源 Control) |
CausesValidation |
取得或設定值,指出控制項取得焦點時,是否會在任何需要驗證的控制項上執行驗證。 (繼承來源 Control) |
CheckBoxes |
取得或設定值,指出控制項中每個項目的旁邊是否要出現核取方塊。 |
CheckedIndices |
取得控制項中目前選取項目的索引。 |
CheckedItems |
取得控制項中目前選取的項目。 |
ClientRectangle |
取得表示控制項工作區的矩形。 (繼承來源 Control) |
ClientSize |
取得或設定控制項工作區的高度和寬度。 (繼承來源 Control) |
Columns |
取得控制項中顯示的所有資料行標頭的集合。 |
CompanyName |
取得包含控制項之應用程式的公司名稱或建立者。 (繼承來源 Control) |
Container |
取得包含 IContainer 的 Component。 (繼承來源 Component) |
ContainsFocus |
取得指示控制項 (或其子控制項之一) 目前是否擁有輸入焦點的值。 (繼承來源 Control) |
ContextMenu |
取得或設定與控制項關聯的捷徑功能表。 (繼承來源 Control) |
ContextMenuStrip |
取得或設定與這個控制項相關的 ContextMenuStrip。 (繼承來源 Control) |
Controls |
取得控制項中包含的控制項集合。 (繼承來源 Control) |
Created |
取得值,指出是否已經建立控制項。 (繼承來源 Control) |
CreateParams |
這個屬性與這個類別無關。 |
Cursor |
取得或設定滑鼠指標移至控制項上時顯示的游標。 (繼承來源 Control) |
DataBindings |
取得控制項的資料繫結 (Data Binding)。 (繼承來源 Control) |
DataContext |
取得或設定資料系結用途的資料內容。 這是環境屬性。 (繼承來源 Control) |
DefaultCursor |
取得或設定控制項的預設游標。 (繼承來源 Control) |
DefaultImeMode |
取得控制項支援的預設輸入法 (IME) 模式。 (繼承來源 Control) |
DefaultMargin |
取得控制項之間的預設指定間距 (單位為像素)。 (繼承來源 Control) |
DefaultMaximumSize |
取得指定為控制項的預設大小之最大值的長度和高度 (單位為像素)。 (繼承來源 Control) |
DefaultMinimumSize |
取得指定為控制項的預設大小之最小值的長度和高度 (單位為像素)。 (繼承來源 Control) |
DefaultPadding |
取得控制項內容的內部間距 (單位為像素)。 (繼承來源 Control) |
DefaultSize |
取得控制項的預設大小。 |
DesignMode |
取得值,指出 Component 目前是否處於設計模式。 (繼承來源 Component) |
DeviceDpi |
取得目前顯示控制項的顯示裝置的 DPI 值。 (繼承來源 Control) |
DisplayRectangle |
取得表示控制項顯示區域的矩形。 (繼承來源 Control) |
Disposing |
取得值,指出基底 Control 類別是否正在處置的過程中。 (繼承來源 Control) |
Dock |
取得或設定停駐在其父控制項的控制項框線,並決定控制項隨其父代重新調整大小的方式。 (繼承來源 Control) |
DoubleBuffered |
取得或設定值,指出這個控制項是否應使用次要緩衝區重繪其介面,以減少或防止重繪閃動 (Flicker)。 |
DoubleBuffered |
取得或設定值,指出這個控制項是否應使用次要緩衝區重繪其介面,以減少或防止重繪閃動 (Flicker)。 (繼承來源 Control) |
Enabled |
取得或設定值,指出控制項是否可回應使用者互動。 (繼承來源 Control) |
Events |
取得附加在這個 Component 上的事件處理常式清單。 (繼承來源 Component) |
Focused |
取得指示控制項是否擁有輸入焦點的值。 (繼承來源 Control) |
FocusedItem |
取得或設定目前焦點所在控制項中的項目。 |
Font |
取得或設定控制項顯示之文字字型。 (繼承來源 Control) |
FontHeight |
取得或設定控制項字型的高度。 (繼承來源 Control) |
ForeColor |
取得或設定前景色彩。 |
FullRowSelect |
取得或設定值,指出按一下項目是否會選取它的所有子項目。 |
GridLines |
取得或設定值,指出包含控制項中項目和子項目的資料列和資料行之間是否會顯示格線。 |
GroupImageList |
目前設定的 GroupIcon 映射清單。 |
Groups |
取得指派給控制項的 ListViewGroup 物件集合。 |
Handle |
取得控制項要繫結的目標視窗控制代碼。 (繼承來源 Control) |
HasChildren |
取得指示控制項是否包含一或多個子控制項的值。 (繼承來源 Control) |
HeaderStyle |
取得或設定資料行標頭的樣式。 |
Height |
取得或設定控制項的高度。 (繼承來源 Control) |
HideSelection |
取得或設定值,指出當控制項遺失焦點時,控制項中已選取的項目是否還以反白顯示。 |
HotTracking |
取得或設定值,指示當滑鼠指標移過項目或子項目上方時,其文字是否具有超連結外觀。 |
HoverSelection |
取得或設定值,指出當滑鼠指標在項目上方停留數秒時,是否要自動選取項目。 |
ImeMode |
取得或設定控制項的輸入法 (IME) 模式。 (繼承來源 Control) |
ImeModeBase |
取得或設定控制項的 IME 模式。 (繼承來源 Control) |
InsertionMark |
取得在 ListView 控制項之內拖曳項目時,用來指出應該置放位置的物件。 |
InvokeRequired |
取得一個值。這個值會指示是否由於呼叫端是在建立控制項之執行緒以外的執行緒,因此在進行控制項的方法呼叫時,應呼叫叫用 (Invoke) 方法。 (繼承來源 Control) |
IsAccessible |
取得或設定值,指出可及性應用程式是否見得到控制項。 (繼承來源 Control) |
IsAncestorSiteInDesignMode |
指出這個控制項的其中一個上階是否已月臺,以及該月臺在 DesignMode 中。 這個屬性是唯讀的。 (繼承來源 Control) |
IsDisposed |
取得指示控制項是否已經處置的值。 (繼承來源 Control) |
IsHandleCreated |
取得指示控制項是否有相關控制代碼的值。 (繼承來源 Control) |
IsMirrored |
取得值,指出是否左右反轉控制項。 (繼承來源 Control) |
Items |
取得包含控制項中所有項目的集合。 |
LabelEdit |
取得或設定值,指出使用者是否能編輯控制項中項目的標籤。 |
LabelWrap |
取得或設定值,指出項目在控制項中顯示為圖示時,項目標籤是否要換行。 |
LargeImageList |
取得或設定 ImageList,當項目在控制項中顯示為大圖示時使用。 |
LayoutEngine |
取得控制項之配置引擎的快取執行個體。 (繼承來源 Control) |
Left |
取得或設定控制項左邊緣和其容器工作區 (Client Area) 左邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
ListViewItemSorter |
取得或設定控制項的排序比較子。 |
Location |
取得或設定對應至控制項容器左上角之控制項左上角的座標。 (繼承來源 Control) |
Margin |
取得或設定控制項之間的空格。 (繼承來源 Control) |
MaximumSize |
取得或設定 GetPreferredSize(Size) 可以指定的上限大小。 (繼承來源 Control) |
MinimumSize |
取得或設定 GetPreferredSize(Size) 可以指定的下限大小。 (繼承來源 Control) |
MultiSelect |
取得或設定值,指出是否可選取多個項目。 |
Name |
取得或設定控制項的名稱。 (繼承來源 Control) |
OwnerDraw |
取得或設定值,指出 ListView 控制項是由作業系統或您提供的程式碼所描繪。 |
Padding |
取得或設定 ListView 控制項及其內容之間的間距。 |
Padding |
取得或設定控制項內的邊框間距。 (繼承來源 Control) |
Parent |
取得或設定控制項的父容器。 (繼承來源 Control) |
PreferredSize |
取得能夠容納控制項的矩形區域的大小。 (繼承來源 Control) |
ProductName |
取得包含控制項的組件的產品名稱。 (繼承來源 Control) |
ProductVersion |
取得包含控制項的組件的版本。 (繼承來源 Control) |
RecreatingHandle |
取得指示控制項目前是否正重新建立其控制代碼的值。 (繼承來源 Control) |
Region |
取得或設定與控制項關聯的視窗區域。 (繼承來源 Control) |
RenderRightToLeft |
已淘汰.
已淘汰.
此屬性現在已過時。 (繼承來源 Control) |
ResizeRedraw |
取得或設定值,指出控制項重設大小時,是否會重繪本身。 (繼承來源 Control) |
Right |
取得控制項右邊緣和其容器工作區 (Client Area) 左邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
RightToLeft |
取得或設定值,指出控制項的項目是否對齊,以支援使用由右至左字型的地區設定。 (繼承來源 Control) |
RightToLeftLayout |
取得或設定值,指出控制項是否由右至左配置。 |
ScaleChildren |
取得值,以判斷子控制項的縮放。 (繼承來源 Control) |
Scrollable |
取得或設定值,指出沒有足夠空間可顯示所有項目時,是否要將捲軸加入控制項。 |
SelectedIndices |
取得控制項中所選取項目的索引。 |
SelectedItems |
取得控制項中已選取的項目。 |
ShowFocusCues |
取得指示控制項是否應顯示焦點矩形 (Focus Rectangle) 的值。 (繼承來源 Control) |
ShowGroups |
取得或設定值,指出項目是否顯示在群組中。 |
ShowItemToolTips |
取得或設定值,指示是否為包含於 ListViewItem 中的 ListView 物件顯示工具提示。 |
ShowKeyboardCues |
取得值,指出使用者介面是否處於可顯示或隱藏鍵盤快速鍵的適當狀態下。 (繼承來源 Control) |
Site |
取得或設定控制項的站台。 (繼承來源 Control) |
Size |
取得或設定控制項的高度和寬度。 (繼承來源 Control) |
SmallImageList |
取得或設定 ImageList,當控制項中的項目顯示為小圖示時使用。 |
Sorting |
取得或設定控制項中項目的排序次序。 |
StateImageList |
取得或設定與控制項中應用程式定義狀態相關的 ImageList。 |
TabIndex |
取得或設定控制項容器中的控制項定位順序。 (繼承來源 Control) |
TabStop |
取得或設定值,指出使用者是否能使用 TAB 鍵,將焦點 (Focus) 給予這個控制項。 (繼承來源 Control) |
Tag |
取得或設定物件,其包含控制項相關資料。 (繼承來源 Control) |
Text |
這個屬性與這個類別無關。 |
TileSize |
取得或設定在並排顯示中所顯示的方磚大小。 |
Top |
取得或設定控制項上邊緣和其容器工作區 (Client Area) 上邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
TopItem |
取得或設定控制項中第一個可見的項目。 |
TopLevelControl |
取得沒有其他 Windows Form 父控制項的父控制項。 通常,這會是內含控制項最外層的 Form。 (繼承來源 Control) |
UseCompatibleStateImageBehavior |
取得或設定值,指出 使用 ListView 與 .NET Framework 1.1 或 .NET Framework 2.0 相容的狀態影像行為。 |
UseWaitCursor |
取得或設定值,指出是否將等待游標用於目前控制項和所有子控制項。 (繼承來源 Control) |
View |
取得或設定控制項中項目的顯示方式。 |
VirtualListSize |
取得或設定在虛擬模式下,包含於清單中的 ListViewItem 物件數目。 |
VirtualMode |
取得或設定值,指出您是否已經為 ListView 控制項提供您自己的資料管理作業。 |
Visible |
取得或設定值,這個值指出是否顯示控制項及其所有子控制項。 (繼承來源 Control) |
Width |
取得或設定控制項的寬度。 (繼承來源 Control) |
WindowTarget |
這個屬性與這個類別無關。 (繼承來源 Control) |
方法
事件
明確介面實作
IDropTarget.OnDragDrop(DragEventArgs) |
引發 DragDrop 事件。 (繼承來源 Control) |
IDropTarget.OnDragEnter(DragEventArgs) |
引發 DragEnter 事件。 (繼承來源 Control) |
IDropTarget.OnDragLeave(EventArgs) |
引發 DragLeave 事件。 (繼承來源 Control) |
IDropTarget.OnDragOver(DragEventArgs) |
引發 DragOver 事件。 (繼承來源 Control) |
適用於
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應