Export (0) Print
Expand All
Expand Minimize

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)

'Declaration
Public Enumeration View

Member nameDescription
DetailsEach 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.
LargeIconEach item appears as a full-sized icon with a label below it.
ListEach item appears as a small icon with a label to its right. Items are arranged in columns with no column headers.
SmallIconEach item appears as a small icon with a label to its right.
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. 
Friend WithEvents myListView As System.Windows.Forms.ListView

' Initialize the ListView object with subitems of a different 
' style than the default styles for the ListView. 
Private Sub InitializeListView()

    ' Set the Location, View and Width properties for the  
    ' ListView object. 
    myListView = New ListView
    With (myListView)
        .Location = New System.Drawing.Point(20, 20)

        ' The View property must be set to Details for the  
        ' subitems to be visible.
        .View = View.Details
        .Width = 250
    End With 

    ' Each SubItem object requires a column, so add three columns. 
    Me.myListView.Columns.Add("Key", 50, HorizontalAlignment.Left)
    Me.myListView.Columns.Add("A", 100, HorizontalAlignment.Left)
    Me.myListView.Columns.Add("B", 100, HorizontalAlignment.Left)

    ' Add a ListItem object to the ListView. 
    Dim entryListItem As ListViewItem = myListView.Items.Add("Items")

    ' Set UseItemStyleForSubItems property to false to change  
    ' look of subitems.
    entryListItem.UseItemStyleForSubItems = False 

    ' Add the expense subitem. 
    Dim expenseItem As ListViewItem.ListViewSubItem = _
        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  
    Dim revenueItem As ListViewItem.ListViewSubItem = _
        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. 
    Me.Controls.Add(Me.myListView)
End Sub
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.

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Show:
© 2014 Microsoft