ListView.View 屬性
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得或設定控制項中項目的顯示方式。
public:
property System::Windows::Forms::View View { System::Windows::Forms::View get(); void set(System::Windows::Forms::View value); };public System.Windows.Forms.View View { get; set; }member this.View : System.Windows.Forms.View with get, setPublic Property View As View屬性值
例外狀況
指定的值不是其中一個 View 值。
範例
下列程式碼範例會建立控制項，其中指定三 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
備註
屬性 View 可讓您指定控制項用來顯示專案的顯示 ListView 類型。 您可以設定 View 屬性，以顯示每個專案，其中包含大型或小型圖示，或在垂直清單中顯示專案。 最豐富的選項是詳細資料檢視，可讓您檢視每個專案所指定的專案，以及任何子專案。 每個專案都會顯示在方格中，每個專案會垂直列出，以及資料行標頭顯示之每個專案的子專案。 詳細資料檢視是向使用者顯示資料庫資訊的絕佳方式。 使用 Windows XP 和 Windows Server 2003，您也可以顯示專案做為磚，藉由顯示大型圖示以及您選擇的子專案資訊，來平衡圖形和文字資訊。 若要啟用磚檢視，您的應用程式必須呼叫 Application.EnableVisualStyles 方法。 小型影像檢視會顯示每個專案，其中圖示和圖示右側的文字資訊。 大型影像檢視會以圖示下方的圖示和文字資訊顯示每個專案。 影像清單的圖示大小是由 ImageSize 或 LargeImageList 屬性的 ImageListSmallImageList 屬性所指定。
注意
如果您使用多個影像清單，用於小型和大型圖示檢視，則 ListView 應該將小型和大型版本的影像放在其個別影像清單中的相同索引位置。 在檢視之間切換時，不論指定的索引鍵值為何，都會使用某個清單中的影像索引位置來尋找另一個清單中的影像。
控制項中的 ListView 大部分屬性會影響不同檢視的行為或顯示方式。 某些影響專案檢視的屬性只有在屬性設定為特定值時才 View 有用，而其他屬性在所有檢視中都很有用。 例如，當 屬性設定為 View.Details 時，例如 GridLines 和 FullRowSelect 等屬性才有用，而 MultiSelect 和 CheckBoxes 屬性在所有檢視中都 View 很有用。
下表顯示其中一些 ListView 成員及其有效的檢視。
| ListView 成員 | 檢視 |
|---|---|
| Alignment 屬性 | SmallIcon 或 LargeIcon |
| AutoArrange 屬性 | SmallIcon 或 LargeIcon |
| AutoResizeColumn 方法 | Details |
| CheckBoxes | 除了 以外的所有檢視 Tile |
| Columns 屬性 | Details 或 Tile |
| DrawSubItem 事件 | Details |
| FindItemWithText 方法 | Details、 List或 Tile |
| FindNearestItem 方法 | SmallIcon 或 LargeIcon |
| GetItemAt 方法 | Details 或 Tile |
| Groups 屬性 | 除了 以外的所有檢視 List |
| HeaderStyle 屬性 | Details |
| InsertionMark 屬性 | LargeIcon、 SmallIcon或 Tile |
您可以使用 View 屬性在應用程式中提供不同的資料檢視，或鎖定特定檢視以利用該檢視的優點。 例如， View 屬性通常會設定為 View.Details ，因為詳細資料檢視提供其他檢視中無法使用的一些檢視選項。
注意
ListView如果您的控制項未指定任何資料行標頭，而且您已將 View 屬性設定為 View.Details ，控制項 ListView 將不會顯示任何專案。 ListView如果您的控制項未指定任何資料行標頭，而且您已將 View 屬性設定為 View.Tile ，控制項 ListView 將不會顯示任何子專案。
圖格檢視會顯示每個專案，左邊有大型圖示，右邊有文字資訊。 文字資訊包含專案標籤，後面接著子專案。 根據預設，只會顯示第一個子專案，對應至專案標籤。 若要顯示其他子專案，您必須將 物件新增 ColumnHeader 至 Columns 集合。 圖格中的每個子專案都會對應至資料行標頭。 若要控制要顯示哪些子專案，以及顯示子專案的順序，您必須為每個專案設定 ListViewItem.ListViewSubItem.Name 屬性，以及 ColumnHeader.Name 每個標頭的屬性。 然後，您可以在集合中 Columns 新增、移除和重新排列標頭，以達到所需的結果。
若要控制磚檢視中的磚大小，請設定 TileSize 屬性。 當子專案文字太長於單行時，這很適合防止換行。
如需磚檢視的範例，請參閱 TileSize 屬性。
注意
雖然資料行只會顯示在詳細資料檢視中，但沒有資料行標頭的子專案將不會顯示在詳細資料檢視或磚檢視中。
當您的應用程式呼叫 Application.EnableVisualStyles 方法時，磚檢視僅適用于 Windows XP 和 Windows Server 2003。 在舊版作業系統中，任何與並排顯示檢視相關的程式碼都無效，而且 ListView 控制項會顯示在大圖示檢視中。 因此，相依于磚檢視的任何程式碼可能無法正常運作。
您可能想要包含可判斷磚檢視是否可用的程式碼，並在無法使用時提供替代功能。 例如，當您使用擁有者繪圖來自訂磚檢視中專案的外觀時，您可能會想要在不支援磚檢視的 ListView 作業系統上執行時，使用適合大型圖示檢視的繪圖程式碼。
磚檢視功能是由提供作業系統主題功能的相同程式庫所提供。 若要檢查此程式庫的可用性，請呼叫 FeatureSupport.IsPresent(Object) 方法多載並傳入 OSFeature.Themes 值。
適用於
另請參閱
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應