View Enum
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Specifies how list items are displayed in a ListView control.
public enum class View
public enum View
type View =
Public Enum View
- Inheritance
Fields
Name | Value | Description |
---|---|---|
LargeIcon | 0 | Each item appears as a full-sized icon with a label below it. |
Details | 1 | 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 run time. |
SmallIcon | 2 | Each item appears as a small icon with a label to its right. |
List | 3 | Each item appears as a small icon with a label to its right. Items are arranged in columns with no column headers. |
Tile | 4 | Each 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. |
Examples
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.
internal:
// Declare the Listview object.
System::Windows::Forms::ListView^ myListView;
private:
// Initialize the ListView object with subitems of a different
// style than the default styles for the ListView.
void InitializeListView()
{
// Set the Location, View and Width properties for the
// ListView object.
myListView = gcnew ListView;
myListView->Location = 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 = gcnew 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 = gcnew System::Drawing::Font( "Times New Roman",10,System::Drawing::FontStyle::Bold );
// Add the ListView to the form.
this->Controls->Add( this->myListView );
}
// 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);
}
' 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
Remarks
Use the members of this enumeration to set the value of the View property of the ListView control.
Applies to
See also
.NET