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

View Enumeration

Specifies how list items are displayed in a ListView control.

[Visual Basic]
<Serializable>
Public Enum View
[C#]
[Serializable]
public enum View
[C++]
[Serializable]
__value public enum View
[JScript]
public
   Serializable
enum View

Remarks

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

Members

Member name Description
Details

Supported by the .NET Compact Framework.

Each 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 runtime.
LargeIcon

Supported by the .NET Compact Framework.

Each item appears as a full-sized icon with a label below it.
List

Supported by the .NET Compact Framework.

Each item appears as a small icon with a label to its right. Items are arranged in columns with no column headers.
SmallIcon

Supported by the .NET Compact Framework.

Each item appears as a small icon with a label to its right.

Example

[Visual Basic, C#] The following code example demonstrates the use of the View enumeration to set a ListView object's View property. To run the example, paste the following code in a form and call the InitializeListView method in form's constructor or Load method.

[Visual Basic] 

    ' 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

[C#] 

    // 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);
    }

[C++, JScript] No example is available for C++ or JScript. To view a Visual Basic or C# example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Namespace: System.Windows.Forms

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework

Assembly: System.Windows.Forms (in System.Windows.Forms.dll)

See Also

System.Windows.Forms Namespace | View

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.