Export (0) Print
Expand All
Expand Minimize
1 out of 2 rated this helpful - Rate this topic

View Enumeration

Specifies how list items are displayed in a ListView control.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)
public enum View
Member nameDescription
Supported by the .NET Compact FrameworkLargeIconEach item appears as a full-sized icon with a label below it.
Supported by the .NET Compact FrameworkDetailsEach item appears on a separate line with further information about each item arranged in columns. The left-most column contains a small icon and label, and subsequent columns contain sub items as specified by the application. A column displays a header which can display a caption for the column. The user can resize each column at run time.
Supported by the .NET Compact FrameworkSmallIconEach item appears as a small icon with a label to its right.
Supported by the .NET Compact FrameworkListEach item appears as a small icon with a label to its right. Items are arranged in columns with no column headers.
TileEach item appears as a full-sized icon with the item label and subitem information to the right of it. The subitem information that appears is specified by the application. This view is available only on Windows XP and the Windows Server 2003 family. On earlier operating systems, this value is ignored and the ListView control displays in the LargeIcon view.

Use the members of this enumeration to set the value of the View property of the ListView control.

The following code example demonstrates setting the ListView.View property to one of the View enumeration values. To run the example, paste the following code in a form and call the InitializeListView method in form's constructor or Load method.

	// Declare the Listview object. 
	internal System.Windows.Forms.ListView myListView;

	// Initialize the ListView object with subitems of a different 
	// style than the default styles for the ListView. 
	private void InitializeListView()
	{

		// Set the Location, View and Width properties for the  
		// ListView object. 
		myListView = new ListView();
		myListView.Location = new System.Drawing.Point(20, 20);
		myListView.Width = 250;

		// The View property must be set to Details for the  
		// subitems to be visible.
		myListView.View = View.Details;
		
		// Each SubItem object requires a column, so add three columns. 
		this.myListView.Columns.Add("Key", 50, HorizontalAlignment.Left);
		this.myListView.Columns.Add("A", 100, HorizontalAlignment.Left);
		this.myListView.Columns.Add("B", 100, HorizontalAlignment.Left);

		// Add a ListItem object to the ListView.
		ListViewItem entryListItem = myListView.Items.Add("Items");

		// Set UseItemStyleForSubItems property to false to change  
		// look of subitems.
		entryListItem.UseItemStyleForSubItems = false;

		// Add the expense subitem.
		ListViewItem.ListViewSubItem expenseItem = 
			entryListItem.SubItems.Add("Expense");

		// Change the expenseItem object's color and font.
		expenseItem.ForeColor = System.Drawing.Color.Red;
		expenseItem.Font = new System.Drawing.Font(
			"Arial", 10, System.Drawing.FontStyle.Italic);

		// Add a subitem called revenueItem 
		ListViewItem.ListViewSubItem revenueItem = 
			entryListItem.SubItems.Add("Revenue");

		// Change the revenueItem object's color and font.
		revenueItem.ForeColor = System.Drawing.Color.Blue;
		revenueItem.Font = new System.Drawing.Font(
			"Times New Roman", 10, System.Drawing.FontStyle.Bold);

		// Add the ListView to the form. 
		this.Controls.Add(this.myListView);
	}
The following code example demonstrates setting the UseItemStyleForSubItems property to false to define custom style for ListViewSubItem objects.
To run the example, paste the following code
in a form and call the InitializeListView method in form's constructor or Load method.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.