Edit

Share via


ListView Class

Definition

Represents a Windows list view control, which displays a collection of items that can be displayed using one of four different views.

public ref class ListView : System::Windows::Forms::Control
public class ListView : System.Windows.Forms.Control
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Windows.Forms.Docking(System.Windows.Forms.DockingBehavior.Ask)]
public class ListView : System.Windows.Forms.Control
[System.Windows.Forms.Docking(System.Windows.Forms.DockingBehavior.Ask)]
public class ListView : System.Windows.Forms.Control
type ListView = class
    inherit Control
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Windows.Forms.Docking(System.Windows.Forms.DockingBehavior.Ask)>]
type ListView = class
    inherit Control
[<System.Windows.Forms.Docking(System.Windows.Forms.DockingBehavior.Ask)>]
type ListView = class
    inherit Control
Public Class ListView
Inherits Control
Inheritance
Attributes

Examples

The following code example creates a ListView control with three ListViewItem objects specified and three ListViewItem.ListViewSubItem objects specified for each item. The example also creates ColumnHeader objects to display the subitems in details view. Two ImageList objects are also created in the code example to provide images for the ListViewItem objects. These ImageList objects are added to the LargeImageList and SmallImageList properties. The example uses the following properties in creating the ListView control:

This example requires that you have added the code to a Form and call the method created in the example from the constructor or another method on the form. The example also requires that images named MySmallImage1, MySmallImage2, MyLargeImage1, and MyLargeImage2 are located in the root directory of drive 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

Remarks

A ListView control allows you to display a list of items with item text and, optionally, an icon to identify the type of item. For example, the Windows Explorer list of files is similar in appearance to a ListView control. It displays a list of the files and folders currently selected in the tree. Each file and folder displays an icon associated with it to help identify the type of file or folder. The ListViewItem class represents an item within a ListView control. The items that are displayed in the list can be shown in one of five different views. Items can be displayed as large icons, as small icons, or as small icons in a vertical list. Items can also have subitems which contain information that is related to the parent item. The details view allows you to display the item and its subitems in a grid with column headers that identify the information being displayed in a subitem. The tile view, which has limited availability as described below, allows you to display the item and its subitems as a tile that contains a large icon next to the textual information. ListView supports single or multiple selection. The multiple selection feature lets the user select from a list of items in a way similar to a ListBox control. Additionally, the user can activate selected items to perform a task. For example, you could use a ListView control to display a list of files that the application can then open and utilize. The user can select the files to open and then double-click them to activate the items and open the files in the application. The ListView can also display check boxes, using the CheckBoxes property, to allow the user to check the items that they want to perform an action on. You can use the ListView control in a variety of ways. The control can be used to display information from an application, a database, or a text file. The ListView can also be used to obtain information from the user, such as selecting a set of files to process.

ListView provides a large number of properties that provide flexibility in appearance and behavior. The View property allows you to change the way in which items are displayed. The LargeImageList, SmallImageList, and StateImageList properties allow you to specify the ImageList objects that contain the images displayed for items and, in the case of the StateImageList, the check boxes that are displayed when the CheckBoxes property is set to true. To determine which items are checked, you can use the CheckedItems property to access the ListView.CheckedListViewItemCollection collection. The Columns property allows access to the ListView.ColumnHeaderCollection, which stores the column headers that are displayed when the View property of the control is set to Details. Items are added and removed from the ListView through the Items property. The Items property allows you to access the ListView.ListViewItemCollection of the control, which provides methods for manipulating the items in the control. If you want to allow the user to edit the text of an item, you can use the LabelEdit property. When your control contains a large number of items, it is often easier for the user to see them in a sorted list. You can use the Sorting property to sort the items alphabetically. You can also completely customize the appearance of a ListView control. To do this, set the OwnerDraw property to true and handle one or more of the following events: DrawItem, DrawSubItem, DrawColumnHeader.

Many of the properties of the ListView control are used when the View property of the control is set to Details. The AllowColumnReorder property allows the user of your ListView control to reconfigure the order of columns at run time. The FullRowSelect property allows an item and its subitems to be selected instead of just the item. To display gridlines in the details view to identify the boundaries of items and subitems in the ListView, you can use the GridLines property. The HeaderStyle property allows you to specify the type of column headers to display.

A ListView control can operate in virtual mode, where ListViewItem objects are generated dynamically instead of being stored in the Items collection. This can be useful for dealing with very large lists or lists whose contents frequently change. To enable Virtual mode, set the VirtualMode property to true and handle the RetrieveVirtualItem, CacheVirtualItems, and SearchForVirtualItem events.

In addition to the many properties that are available for a ListView control, there are methods and events that your application can use to provide additional capabilities to the ListView. The BeginUpdate and EndUpdate methods allow you to improve performance when you add many items to a ListView by preventing the control from repainting every time that an item is added. If your ListView control is displaying items and subitems, you may want to provide functionality when the user right-clicks a subitem. To determine the item whose subitem is being clicked, you can use the GetItemAt method. When performing validation of the items after the user has edited them, you may want to display a specific item to the user to change. The EnsureVisible method can be called to ensure that the specific item is in the visible area of the control.

If the LabelEdit property set to true, you can perform tasks such as validating the text being edited before and after the text changed by creating an event handler for the BeforeLabelEdit and AfterLabelEdit events. To perform tasks such as opening a file or displaying a dialog box to edit an item displayed in a ListView, you can create an event handler for the ItemActivate event. If you allow the user to sort the items in a ListView when they click a column header, you can create an event handler for the ColumnClick event to perform the sorting. When the CheckBoxes property is set to true, you can determine when a change in an item's check state has occurred by handling the ItemCheck event.

You can also set a background image for the ListView with the BackgroundImage property. Your application must have the STAThreadAttribute on its Main method to correctly display the background image for the ListView control. In addition, if a ListView control with a background image is hosted in Internet Explorer, specify comctl32.dll version 6.0 as a dependent assembly in the application manifest file to ensure the background image is properly displayed.

Windows XP and Windows Server 2003 provide three features that enhance the ListView control when your application calls the Application.EnableVisualStyles method: tile view, grouping, and the insertion mark.

The tile view lets you balance graphical and textual information by displaying item and subitem text next to large icons. Set the View property to View.Tile to enable this behavior.

The grouping feature lets you visually group items into related categories. Use the Groups property to add ListViewGroup objects to the ListView control when you want to enable this feature. To temporarily disable the feature, set the ShowGroups property to false.

The insertion mark feature lets you provide drag-and-drop item repositioning with visual feedback to indicate drop locations. Use the ListViewInsertionMark object retrieved through the InsertionMark property to display the insertion mark.

These features are available only under Windows XP and Windows Server 2003. On earlier operating systems, the code that relate to these features has no effect, the tile view appears as the large icon view, and the insertion mark and groups do not display. In some cases, you might want to include code that determines whether these features are available, and provide alternate functionality when they are unavailable. These features are provided by the same library that provides the operating system themes feature. To check for the availability of this library, call the FeatureSupport.IsPresent(Object) method overload and pass in the OSFeature.Themes value.

The following table shows some of the ListView members and the views they are valid in.

ListView member View
Alignment property SmallIcon or LargeIcon
AutoArrange property SmallIcon or LargeIcon
AutoResizeColumn method Details
Columns property Details or Tile
DrawSubItem event Details
FindItemWithText method Details, List, or Tile
FindNearestItem method SmallIcon or LargeIcon
GetItemAt method Details or Tile
Groups property All views except List
HeaderStyle property Details
InsertionMark property LargeIcon, SmallIcon, or Tile

Constructors

ListView()

Initializes a new instance of the ListView class.

Properties

AccessibilityObject

Gets the AccessibleObject assigned to the control.

(Inherited from Control)
AccessibleDefaultActionDescription

Gets or sets the default action description of the control for use by accessibility client applications.

(Inherited from Control)
AccessibleDescription

Gets or sets the description of the control used by accessibility client applications.

(Inherited from Control)
AccessibleName

Gets or sets the name of the control used by accessibility client applications.

(Inherited from Control)
AccessibleRole

Gets or sets the accessible role of the control.

(Inherited from Control)
Activation

Gets or sets the type of action the user must take to activate an item.

Alignment

Gets or sets the alignment of items in the control.

AllowColumnReorder

Gets or sets a value indicating whether the user can drag column headers to reorder columns in the control.

AllowDrop

Gets or sets a value indicating whether the control can accept data that the user drags onto it.

(Inherited from Control)
Anchor

Gets or sets the edges of the container to which a control is bound and determines how a control is resized with its parent.

(Inherited from Control)
AutoArrange

Gets or sets whether icons are automatically kept arranged.

AutoScrollOffset

Gets or sets where this control is scrolled to in ScrollControlIntoView(Control).

(Inherited from Control)
AutoSize

This property is not relevant for this class.

(Inherited from Control)
BackColor

Gets or sets the background color.

BackgroundImage

Gets or sets the background image displayed in this ListView control.

BackgroundImage

Gets or sets the background image displayed in the control.

(Inherited from Control)
BackgroundImageLayout

Gets or sets an ImageLayout value.

BackgroundImageLayout

Gets or sets the background image layout as defined in the ImageLayout enumeration.

(Inherited from Control)
BackgroundImageTiled

Gets or sets a value indicating whether the background image of the ListView should be tiled.

BindingContext

Gets or sets the BindingContext for the control.

(Inherited from Control)
BorderStyle

Gets or sets the border style of the control.

Bottom

Gets the distance, in pixels, between the bottom edge of the control and the top edge of its container's client area.

(Inherited from Control)
Bounds

Gets or sets the size and location of the control including its nonclient elements, in pixels, relative to the parent control.

(Inherited from Control)
CanEnableIme

Gets a value indicating whether the ImeMode property can be set to an active value, to enable IME support.

(Inherited from Control)
CanFocus

Gets a value indicating whether the control can receive focus.

(Inherited from Control)
CanRaiseEvents

Determines if events can be raised on the control.

(Inherited from Control)
CanSelect

Gets a value indicating whether the control can be selected.

(Inherited from Control)
Capture

Gets or sets a value indicating whether the control has captured the mouse.

(Inherited from Control)
CausesValidation

Gets or sets a value indicating whether the control causes validation to be performed on any controls that require validation when it receives focus.

(Inherited from Control)
CheckBoxes

Gets or sets a value indicating whether a check box appears next to each item in the control.

CheckedIndices

Gets the indexes of the currently checked items in the control.

CheckedItems

Gets the currently checked items in the control.

ClientRectangle

Gets the rectangle that represents the client area of the control.

(Inherited from Control)
ClientSize

Gets or sets the height and width of the client area of the control.

(Inherited from Control)
Columns

Gets the collection of all column headers that appear in the control.

CompanyName

Gets the name of the company or creator of the application containing the control.

(Inherited from Control)
Container

Gets the IContainer that contains the Component.

(Inherited from Component)
ContainsFocus

Gets a value indicating whether the control, or one of its child controls, currently has the input focus.

(Inherited from Control)
ContextMenu

Gets or sets the shortcut menu associated with the control.

(Inherited from Control)
ContextMenuStrip

Gets or sets the ContextMenuStrip associated with this control.

(Inherited from Control)
Controls

Gets the collection of controls contained within the control.

(Inherited from Control)
Created

Gets a value indicating whether the control has been created.

(Inherited from Control)
CreateParams

This property is not relevant for this class.

Cursor

Gets or sets the cursor that is displayed when the mouse pointer is over the control.

(Inherited from Control)
DataBindings

Gets the data bindings for the control.

(Inherited from Control)
DataContext

Gets or sets the data context for the purpose of data binding. This is an ambient property.

(Inherited from Control)
DefaultCursor

Gets or sets the default cursor for the control.

(Inherited from Control)
DefaultImeMode

Gets the default Input Method Editor (IME) mode supported by the control.

(Inherited from Control)
DefaultMargin

Gets the space, in pixels, that is specified by default between controls.

(Inherited from Control)
DefaultMaximumSize

Gets the length and height, in pixels, that is specified as the default maximum size of a control.

(Inherited from Control)
DefaultMinimumSize

Gets the length and height, in pixels, that is specified as the default minimum size of a control.

(Inherited from Control)
DefaultPadding

Gets the default internal spacing, in pixels, of the contents of a control.

(Inherited from Control)
DefaultSize

Gets the default size of the control.

DesignMode

Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
DeviceDpi

Gets the DPI value for the display device where the control is currently being displayed.

(Inherited from Control)
DisplayRectangle

Gets the rectangle that represents the display area of the control.

(Inherited from Control)
Disposing

Gets a value indicating whether the base Control class is in the process of disposing.

(Inherited from Control)
Dock

Gets or sets which control borders are docked to its parent control and determines how a control is resized with its parent.

(Inherited from Control)
DoubleBuffered

Gets or sets a value indicating whether this control should redraw its surface using a secondary buffer to reduce or prevent flicker.

DoubleBuffered

Gets or sets a value indicating whether this control should redraw its surface using a secondary buffer to reduce or prevent flicker.

(Inherited from Control)
Enabled

Gets or sets a value indicating whether the control can respond to user interaction.

(Inherited from Control)
Events

Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Focused

Gets a value indicating whether the control has input focus.

(Inherited from Control)
FocusedItem

Gets or sets the item in the control that currently has focus.

Font

Gets or sets the font of the text displayed by the control.

(Inherited from Control)
FontHeight

Gets or sets the height of the font of the control.

(Inherited from Control)
ForeColor

Gets or sets the foreground color.

FullRowSelect

Gets or sets a value indicating whether clicking an item selects all its subitems.

GridLines

Gets or sets a value indicating whether grid lines appear between the rows and columns containing the items and subitems in the control.

GroupImageList

The currently set GroupIcon image list.

Groups

Gets the collection of ListViewGroup objects assigned to the control.

Handle

Gets the window handle that the control is bound to.

(Inherited from Control)
HasChildren

Gets a value indicating whether the control contains one or more child controls.

(Inherited from Control)
HeaderStyle

Gets or sets the column header style.

Height

Gets or sets the height of the control.

(Inherited from Control)
HideSelection

Gets or sets a value indicating whether the selected item in the control remains highlighted when the control loses focus.

HotTracking

Gets or sets a value indicating whether the text of an item or subitem has the appearance of a hyperlink when the mouse pointer passes over it.

HoverSelection

Gets or sets a value indicating whether an item is automatically selected when the mouse pointer remains over the item for a few seconds.

ImeMode

Gets or sets the Input Method Editor (IME) mode of the control.

(Inherited from Control)
ImeModeBase

Gets or sets the IME mode of a control.

(Inherited from Control)
InsertionMark

Gets an object used to indicate the expected drop location when an item is dragged within a ListView control.

InvokeRequired

Gets a value indicating whether the caller must call an invoke method when making method calls to the control because the caller is on a different thread than the one the control was created on.

(Inherited from Control)
IsAccessible

Gets or sets a value indicating whether the control is visible to accessibility applications.

(Inherited from Control)
IsAncestorSiteInDesignMode

Indicates if one of the Ancestors of this control is sited and that site in DesignMode. This property is read-only.

(Inherited from Control)
IsDisposed

Gets a value indicating whether the control has been disposed of.

(Inherited from Control)
IsHandleCreated

Gets a value indicating whether the control has a handle associated with it.

(Inherited from Control)
IsMirrored

Gets a value indicating whether the control is mirrored.

(Inherited from Control)
Items

Gets a collection containing all items in the control.

LabelEdit

Gets or sets a value indicating whether the user can edit the labels of items in the control.

LabelWrap

Gets or sets a value indicating whether item labels wrap when items are displayed in the control as icons.

LargeImageList

Gets or sets the ImageList to use when displaying items as large icons in the control.

LayoutEngine

Gets a cached instance of the control's layout engine.

(Inherited from Control)
Left

Gets or sets the distance, in pixels, between the left edge of the control and the left edge of its container's client area.

(Inherited from Control)
ListViewItemSorter

Gets or sets the sorting comparer for the control.

Location

Gets or sets the coordinates of the upper-left corner of the control relative to the upper-left corner of its container.

(Inherited from Control)
Margin

Gets or sets the space between controls.

(Inherited from Control)
MaximumSize

Gets or sets the size that is the upper limit that GetPreferredSize(Size) can specify.

(Inherited from Control)
MinimumSize

Gets or sets the size that is the lower limit that GetPreferredSize(Size) can specify.

(Inherited from Control)
MultiSelect

Gets or sets a value indicating whether multiple items can be selected.

Name

Gets or sets the name of the control.

(Inherited from Control)
OwnerDraw

Gets or sets a value indicating whether the ListView control is drawn by the operating system or by code that you provide.

Padding

Gets or sets the space between the ListView control and its contents.

Padding

Gets or sets padding within the control.

(Inherited from Control)
Parent

Gets or sets the parent container of the control.

(Inherited from Control)
PreferredSize

Gets the size of a rectangular area into which the control can fit.

(Inherited from Control)
ProductName

Gets the product name of the assembly containing the control.

(Inherited from Control)
ProductVersion

Gets the version of the assembly containing the control.

(Inherited from Control)
RecreatingHandle

Gets a value indicating whether the control is currently re-creating its handle.

(Inherited from Control)
Region

Gets or sets the window region associated with the control.

(Inherited from Control)
RenderRightToLeft
Obsolete.
Obsolete.

This property is now obsolete.

(Inherited from Control)
ResizeRedraw

Gets or sets a value indicating whether the control redraws itself when resized.

(Inherited from Control)
Right

Gets the distance, in pixels, between the right edge of the control and the left edge of its container's client area.

(Inherited from Control)
RightToLeft

Gets or sets a value indicating whether control's elements are aligned to support locales using right-to-left fonts.

(Inherited from Control)
RightToLeftLayout

Gets or sets a value indicating whether the control is laid out from right to left.

ScaleChildren

Gets a value that determines the scaling of child controls.

(Inherited from Control)
Scrollable

Gets or sets a value indicating whether a scroll bar is added to the control when there is not enough room to display all items.

SelectedIndices

Gets the indexes of the selected items in the control.

SelectedItems

Gets the items that are selected in the control.

ShowFocusCues

Gets a value indicating whether the control should display focus rectangles.

(Inherited from Control)
ShowGroups

Gets or sets a value indicating whether items are displayed in groups.

ShowItemToolTips

Gets or sets a value indicating whether ToolTips are shown for the ListViewItem objects contained in the ListView.

ShowKeyboardCues

Gets a value indicating whether the user interface is in the appropriate state to show or hide keyboard accelerators.

(Inherited from Control)
Site

Gets or sets the site of the control.

(Inherited from Control)
Size

Gets or sets the height and width of the control.

(Inherited from Control)
SmallImageList

Gets or sets the ImageList to use when displaying items as small icons in the control.

Sorting

Gets or sets the sort order for items in the control.

StateImageList

Gets or sets the ImageList associated with application-defined states in the control.

TabIndex

Gets or sets the tab order of the control within its container.

(Inherited from Control)
TabStop

Gets or sets a value indicating whether the user can give the focus to this control using the TAB key.

(Inherited from Control)
Tag

Gets or sets the object that contains data about the control.

(Inherited from Control)
Text

This property is not relevant for this class.

TileSize

Gets or sets the size of the tiles shown in tile view.

Top

Gets or sets the distance, in pixels, between the top edge of the control and the top edge of its container's client area.

(Inherited from Control)
TopItem

Gets or sets the first visible item in the control.

TopLevelControl

Gets the parent control that is not parented by another Windows Forms control. Typically, this is the outermost Form that the control is contained in.

(Inherited from Control)
UseCompatibleStateImageBehavior

Gets or sets a value indicating whether the ListView uses state image behavior that is compatible with the .NET Framework 1.1 or the .NET Framework 2.0.

UseWaitCursor

Gets or sets a value indicating whether to use the wait cursor for the current control and all child controls.

(Inherited from Control)
View

Gets or sets how items are displayed in the control.

VirtualListSize

Gets or sets the number of ListViewItem objects contained in the list when in virtual mode.

VirtualMode

Gets or sets a value indicating whether you have provided your own data-management operations for the ListView control.

Visible

Gets or sets a value indicating whether the control and all its child controls are displayed.

(Inherited from Control)
Width

Gets or sets the width of the control.

(Inherited from Control)
WindowTarget

This property is not relevant for this class.

(Inherited from Control)

Methods

AccessibilityNotifyClients(AccessibleEvents, Int32)

Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control.

(Inherited from Control)
AccessibilityNotifyClients(AccessibleEvents, Int32, Int32)

Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control .

(Inherited from Control)
ArrangeIcons()

Arranges items in the control when they are displayed as icons based on the value of the Alignment property.

ArrangeIcons(ListViewAlignment)

Arranges items in the control when they are displayed as icons with a specified alignment setting.

AutoResizeColumn(Int32, ColumnHeaderAutoResizeStyle)

Resizes the width of the given column as indicated by the resize style.

AutoResizeColumns(ColumnHeaderAutoResizeStyle)

Resizes the width of the columns as indicated by the resize style.

BeginInvoke(Action)

Executes the specified delegate asynchronously on the thread that the control's underlying handle was created on.

(Inherited from Control)
BeginInvoke(Delegate)

Executes the specified delegate asynchronously on the thread that the control's underlying handle was created on.

(Inherited from Control)
BeginInvoke(Delegate, Object[])

Executes the specified delegate asynchronously with the specified arguments, on the thread that the control's underlying handle was created on.

(Inherited from Control)
BeginUpdate()

Prevents the control from drawing until the EndUpdate() method is called.

BringToFront()

Brings the control to the front of the z-order.

(Inherited from Control)
Clear()

Removes all items and columns from the control.

Contains(Control)

Retrieves a value indicating whether the specified control is a child of the control.

(Inherited from Control)
CreateAccessibilityInstance()

Creates a new instance of the accessibility object for the ListView control.

CreateAccessibilityInstance()

Creates a new accessibility object for the control.

(Inherited from Control)
CreateControl()

Forces the creation of the visible control, including the creation of the handle and any visible child controls.

(Inherited from Control)
CreateControlsInstance()

Creates a new instance of the control collection for the control.

(Inherited from Control)
CreateGraphics()

Creates the Graphics for the control.

(Inherited from Control)
CreateHandle()

Creates a handle for the control.

CreateObjRef(Type)

Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
DefWndProc(Message)

Sends the specified message to the default window procedure.

(Inherited from Control)
DestroyHandle()

Destroys the handle associated with the control.

(Inherited from Control)
Dispose()

Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean)

Releases the unmanaged resources used by the ListView and optionally releases the managed resources.

DoDragDrop(Object, DragDropEffects)

Begins a drag-and-drop operation.

(Inherited from Control)
DoDragDrop(Object, DragDropEffects, Bitmap, Point, Boolean)

Begins a drag operation.

(Inherited from Control)
DrawToBitmap(Bitmap, Rectangle)

Supports rendering to the specified bitmap.

(Inherited from Control)
EndInvoke(IAsyncResult)

Retrieves the return value of the asynchronous operation represented by the IAsyncResult passed.

(Inherited from Control)
EndUpdate()

Resumes drawing of the list view control after drawing is suspended by the BeginUpdate() method.

EnsureVisible(Int32)

Ensures that the specified item is visible within the control, scrolling the contents of the control if necessary.

Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindForm()

Retrieves the form that the control is on.

(Inherited from Control)
FindItemWithText(String)

Finds the first ListViewItem that begins with the specified text value.

FindItemWithText(String, Boolean, Int32)

Finds the first ListViewItem or ListViewItem.ListViewSubItem, if indicated, that begins with the specified text value. The search starts at the specified index.

FindItemWithText(String, Boolean, Int32, Boolean)

Finds the first ListViewItem or ListViewItem.ListViewSubItem, if indicated, that begins with the specified text value. The search starts at the specified index.

FindNearestItem(SearchDirectionHint, Int32, Int32)

Finds the next item from the given x- and y-coordinates, searching in the specified direction.

FindNearestItem(SearchDirectionHint, Point)

Finds the next item from the given point, searching in the specified direction.

Focus()

Sets input focus to the control.

(Inherited from Control)
GetAccessibilityObjectById(Int32)

Retrieves the specified AccessibleObject.

(Inherited from Control)
GetAutoSizeMode()

Retrieves a value indicating how a control will behave when its AutoSize property is enabled.

(Inherited from Control)
GetChildAtPoint(Point)

Retrieves the child control that is located at the specified coordinates.

(Inherited from Control)
GetChildAtPoint(Point, GetChildAtPointSkip)

Retrieves the child control that is located at the specified coordinates, specifying whether to ignore child controls of a certain type.

(Inherited from Control)
GetContainerControl()

Returns the next ContainerControl up the control's chain of parent controls.

(Inherited from Control)
GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetItemAt(Int32, Int32)

Retrieves the item at the specified location.

GetItemRect(Int32)

Retrieves the bounding rectangle for a specific item within the list view control.

GetItemRect(Int32, ItemBoundsPortion)

Retrieves the specified portion of the bounding rectangle for a specific item within the list view control.

GetLifetimeService()
Obsolete.

Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetNextControl(Control, Boolean)

Retrieves the next control forward or back in the tab order of child controls.

(Inherited from Control)
GetPreferredSize(Size)

Retrieves the size of a rectangular area into which a control can be fitted.

(Inherited from Control)
GetScaledBounds(Rectangle, SizeF, BoundsSpecified)

Retrieves the bounds within which the control is scaled.

(Inherited from Control)
GetService(Type)

Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetStyle(ControlStyles)

Retrieves the value of the specified control style bit for the control.

(Inherited from Control)
GetTopLevel()

Determines if the control is a top-level control.

(Inherited from Control)
GetType()

Gets the Type of the current instance.

(Inherited from Object)
Hide()

Conceals the control from the user.

(Inherited from Control)
HitTest(Int32, Int32)

Provides item information, given x- and y-coordinates.

HitTest(Point)

Provides item information, given a point.

InitializeLifetimeService()
Obsolete.

Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
InitLayout()

Called after the control has been added to another container.

(Inherited from Control)
Invalidate()

Invalidates the entire surface of the control and causes the control to be redrawn.

(Inherited from Control)
Invalidate(Boolean)

Invalidates a specific region of the control and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control.

(Inherited from Control)
Invalidate(Rectangle)

Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control.

(Inherited from Control)
Invalidate(Rectangle, Boolean)

Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control.

(Inherited from Control)
Invalidate(Region)

Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control.

(Inherited from Control)
Invalidate(Region, Boolean)

Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control.

(Inherited from Control)
Invoke(Action)

Executes the specified delegate on the thread that owns the control's underlying window handle.

(Inherited from Control)
Invoke(Delegate)

Executes the specified delegate on the thread that owns the control's underlying window handle.

(Inherited from Control)
Invoke(Delegate, Object[])

Executes the specified delegate, on the thread that owns the control's underlying window handle, with the specified list of arguments.

(Inherited from Control)
Invoke<T>(Func<T>)

Executes the specified delegate on the thread that owns the control's underlying window handle.

(Inherited from Control)
InvokeAsync(Action, CancellationToken)

Invokes the specified synchronous callback asynchronously on the thread that owns the control's handle.

(Inherited from Control)
InvokeAsync(Func<CancellationToken,ValueTask>, CancellationToken)

Executes the specified asynchronous callback on the thread that owns the control's handle asynchronously.

(Inherited from Control)
InvokeAsync<T>(Func<CancellationToken,ValueTask<T>>, CancellationToken)

Executes the specified asynchronous callback on the thread that owns the control's handle.

(Inherited from Control)
InvokeAsync<T>(Func<T>, CancellationToken)

Invokes the specified synchronous callback asynchronously on the thread that owns the control's handle.

(Inherited from Control)
InvokeGotFocus(Control, EventArgs)

Raises the GotFocus event for the specified control.

(Inherited from Control)
InvokeLostFocus(Control, EventArgs)

Raises the LostFocus event for the specified control.

(Inherited from Control)
InvokeOnClick(Control, EventArgs)

Raises the Click event for the specified control.

(Inherited from Control)
InvokePaint(Control, PaintEventArgs)

Raises the Paint event for the specified control.

(Inherited from Control)
InvokePaintBackground(Control, PaintEventArgs)

Raises the PaintBackground event for the specified control.

(Inherited from Control)
IsInputChar(Char)

Determines if a character is an input character that the control recognizes.

(Inherited from Control)
IsInputKey(Keys)

Determines whether the specified key is a regular input key or a special key that requires preprocessing.

LogicalToDeviceUnits(Int32)

Converts a Logical DPI value to its equivalent DeviceUnit DPI value.

(Inherited from Control)
LogicalToDeviceUnits(Size)

Transforms a size from logical to device units by scaling it for the current DPI and rounding down to the nearest integer value for width and height.

(Inherited from Control)
MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean)

Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
NotifyInvalidate(Rectangle)

Raises the Invalidated event with a specified region of the control to invalidate.

(Inherited from Control)
OnAfterLabelEdit(LabelEditEventArgs)

Raises the AfterLabelEdit event.

OnAutoSizeChanged(EventArgs)

Raises the AutoSizeChanged event.

(Inherited from Control)
OnBackColorChanged(EventArgs)

Raises the BackColorChanged event.

(Inherited from Control)
OnBackgroundImageChanged(EventArgs)

Raises the BackgroundImageChanged event.

OnBackgroundImageChanged(EventArgs)

Raises the BackgroundImageChanged event.

(Inherited from Control)
OnBackgroundImageLayoutChanged(EventArgs)

Raises the BackgroundImageLayoutChanged event.

(Inherited from Control)
OnBeforeLabelEdit(LabelEditEventArgs)

Raises the BeforeLabelEdit event.

OnBindingContextChanged(EventArgs)

Raises the BindingContextChanged event.

(Inherited from Control)
OnCacheVirtualItems(CacheVirtualItemsEventArgs)

Raises the CacheVirtualItems event.

OnCausesValidationChanged(EventArgs)

Raises the CausesValidationChanged event.

(Inherited from Control)
OnChangeUICues(UICuesEventArgs)

Raises the ChangeUICues event.

(Inherited from Control)
OnClick(EventArgs)

Raises the Click event.

(Inherited from Control)
OnClientSizeChanged(EventArgs)

Raises the ClientSizeChanged event.

(Inherited from Control)
OnColumnClick(ColumnClickEventArgs)

Raises the ColumnClick event.

OnColumnReordered(ColumnReorderedEventArgs)

Raises the ColumnReordered event.

OnColumnWidthChanged(ColumnWidthChangedEventArgs)

Raises the ColumnWidthChanged event.

OnColumnWidthChanging(ColumnWidthChangingEventArgs)

Raises the ColumnWidthChanging event.

OnContextMenuChanged(EventArgs)

Raises the ContextMenuChanged event.

(Inherited from Control)
OnContextMenuStripChanged(EventArgs)

Raises the ContextMenuStripChanged event.

(Inherited from Control)
OnControlAdded(ControlEventArgs)

Raises the ControlAdded event.

(Inherited from Control)
OnControlRemoved(ControlEventArgs)

Raises the ControlRemoved event.

(Inherited from Control)
OnCreateControl()

Raises the CreateControl() method.

(Inherited from Control)
OnCursorChanged(EventArgs)

Raises the CursorChanged event.

(Inherited from Control)
OnDataContextChanged(EventArgs) (Inherited from Control)
OnDockChanged(EventArgs)

Raises the DockChanged event.

(Inherited from Control)
OnDoubleClick(EventArgs)

Raises the DoubleClick event.

(Inherited from Control)
OnDpiChangedAfterParent(EventArgs)

Raises the DpiChangedAfterParent event.

(Inherited from Control)
OnDpiChangedBeforeParent(EventArgs)

Raises the DpiChangedBeforeParent event.

(Inherited from Control)
OnDragDrop(DragEventArgs)

Raises the DragDrop event.

(Inherited from Control)
OnDragEnter(DragEventArgs)

Raises the DragEnter event.

(Inherited from Control)
OnDragLeave(EventArgs)

Raises the DragLeave event.

(Inherited from Control)
OnDragOver(DragEventArgs)

Raises the DragOver event.

(Inherited from Control)
OnDrawColumnHeader(DrawListViewColumnHeaderEventArgs)

Raises the DrawColumnHeader event.

OnDrawItem(DrawListViewItemEventArgs)

Raises the DrawItem event.

OnDrawSubItem(DrawListViewSubItemEventArgs)

Raises the DrawSubItem event.

OnEnabledChanged(EventArgs)

Raises the EnabledChanged event.

OnEnabledChanged(EventArgs)

Raises the EnabledChanged event.

(Inherited from Control)
OnEnter(EventArgs)

Raises the Enter event.

(Inherited from Control)
OnFontChanged(EventArgs)

Raises the FontChanged event.

OnForeColorChanged(EventArgs)

Raises the ForeColorChanged event.

(Inherited from Control)
OnGiveFeedback(GiveFeedbackEventArgs)

Raises the GiveFeedback event.

(Inherited from Control)
OnGotFocus(EventArgs)
OnGotFocus(EventArgs)

Raises the GotFocus event.

(Inherited from Control)
OnGroupCollapsedStateChanged(ListViewGroupEventArgs)

Fires the GroupCollapsedStateChanged event.

OnGroupTaskLinkClick(ListViewGroupEventArgs)

Fires the GroupTaskLinkClick event.

OnHandleCreated(EventArgs)

Raises the HandleCreated event.

OnHandleDestroyed(EventArgs)

Raises the HandleDestroyed event.

OnHelpRequested(HelpEventArgs)

Raises the HelpRequested event.

(Inherited from Control)
OnImeModeChanged(EventArgs)

Raises the ImeModeChanged event.

(Inherited from Control)
OnInvalidated(InvalidateEventArgs)

Raises the Invalidated event.

(Inherited from Control)
OnItemActivate(EventArgs)

Raises the ItemActivate event.

OnItemCheck(ItemCheckEventArgs)

Raises the ItemCheck event.

OnItemChecked(ItemCheckedEventArgs)

Raises the ItemChecked event.

OnItemDrag(ItemDragEventArgs)

Raises the ItemDrag event.

OnItemMouseHover(ListViewItemMouseHoverEventArgs)

Raises the ItemMouseHover event.

OnItemSelectionChanged(ListViewItemSelectionChangedEventArgs)

Raises the ItemSelectionChanged event.

OnKeyDown(KeyEventArgs)

Raises the KeyDown event.

(Inherited from Control)
OnKeyPress(KeyPressEventArgs)

Raises the KeyPress event.

(Inherited from Control)
OnKeyUp(KeyEventArgs)

Raises the KeyUp event.

(Inherited from Control)
OnLayout(LayoutEventArgs)

Raises the Layout event.

(Inherited from Control)
OnLeave(EventArgs)

Raises the Leave event.

(Inherited from Control)
OnLocationChanged(EventArgs)

Raises the LocationChanged event.

(Inherited from Control)
OnLostFocus(EventArgs)
OnLostFocus(EventArgs)

Raises the LostFocus event.

(Inherited from Control)
OnMarginChanged(EventArgs)

Raises the MarginChanged event.

(Inherited from Control)
OnMouseCaptureChanged(EventArgs)

Raises the MouseCaptureChanged event.

(Inherited from Control)
OnMouseClick(MouseEventArgs)

Raises the MouseClick event.

(Inherited from Control)
OnMouseDoubleClick(MouseEventArgs)

Raises the MouseDoubleClick event.

(Inherited from Control)
OnMouseDown(MouseEventArgs)

Raises the MouseDown event.

(Inherited from Control)
OnMouseEnter(EventArgs)

Raises the MouseEnter event.

(Inherited from Control)
OnMouseHover(EventArgs)

Raises the MouseHover event.

OnMouseHover(EventArgs)

Raises the MouseHover event.

(Inherited from Control)
OnMouseLeave(EventArgs)

Raises the MouseLeave event.

OnMouseLeave(EventArgs)

Raises the MouseLeave event.

(Inherited from Control)
OnMouseMove(MouseEventArgs)

Raises the MouseMove event.

(Inherited from Control)
OnMouseUp(MouseEventArgs)

Raises the MouseUp event.

(Inherited from Control)
OnMouseWheel(MouseEventArgs)

Raises the MouseWheel event.

(Inherited from Control)
OnMove(EventArgs)

Raises the Move event.

(Inherited from Control)
OnNotifyMessage(Message)

Notifies the control of Windows messages.

(Inherited from Control)
OnPaddingChanged(EventArgs)

Raises the PaddingChanged event.

(Inherited from Control)
OnPaint(PaintEventArgs)

Raises the Paint event.

(Inherited from Control)
OnPaintBackground(PaintEventArgs)

Paints the background of the control.

(Inherited from Control)
OnParentBackColorChanged(EventArgs)

Raises the BackColorChanged event when the BackColor property value of the control's container changes.

(Inherited from Control)
OnParentBackgroundImageChanged(EventArgs)

Raises the BackgroundImageChanged event when the BackgroundImage property value of the control's container changes.

(Inherited from Control)
OnParentBindingContextChanged(EventArgs)

Raises the BindingContextChanged event when the BindingContext property value of the control's container changes.

(Inherited from Control)
OnParentChanged(EventArgs)

Raises the ParentChanged event.

OnParentChanged(EventArgs)

Raises the ParentChanged event.

(Inherited from Control)
OnParentCursorChanged(EventArgs)

Raises the CursorChanged event.

(Inherited from Control)
OnParentDataContextChanged(EventArgs) (Inherited from Control)
OnParentEnabledChanged(EventArgs)

Raises the EnabledChanged event when the Enabled property value of the control's container changes.

(Inherited from Control)
OnParentFontChanged(EventArgs)

Raises the FontChanged event when the Font property value of the control's container changes.

(Inherited from Control)
OnParentForeColorChanged(EventArgs)

Raises the ForeColorChanged event when the ForeColor property value of the control's container changes.

(Inherited from Control)
OnParentRightToLeftChanged(EventArgs)

Raises the RightToLeftChanged event when the RightToLeft property value of the control's container changes.

(Inherited from Control)
OnParentVisibleChanged(EventArgs)

Raises the VisibleChanged event when the Visible property value of the control's container changes.

(Inherited from Control)
OnPreviewKeyDown(PreviewKeyDownEventArgs)

Raises the PreviewKeyDown event.

(Inherited from Control)
OnPrint(PaintEventArgs)

Raises the Paint event.

(Inherited from Control)
OnQueryContinueDrag(QueryContinueDragEventArgs)

Raises the QueryContinueDrag event.

(Inherited from Control)
OnRegionChanged(EventArgs)

Raises the RegionChanged event.

(Inherited from Control)
OnResize(EventArgs)

Raises the Resize event.

OnResize(EventArgs)

Raises the Resize event.

(Inherited from Control)
OnRetrieveVirtualItem(RetrieveVirtualItemEventArgs)

Raises the RetrieveVirtualItem event.

OnRightToLeftChanged(EventArgs)

Raises the RightToLeftChanged event.

(Inherited from Control)
OnRightToLeftLayoutChanged(EventArgs)

Raises the RightToLeftLayoutChanged event.

OnSearchForVirtualItem(SearchForVirtualItemEventArgs)

Raises the SearchForVirtualItem event.

OnSelectedIndexChanged(EventArgs)

Raises the SelectedIndexChanged event.

OnSizeChanged(EventArgs)

Raises the SizeChanged event.

(Inherited from Control)
OnStyleChanged(EventArgs)

Raises the StyleChanged event.

(Inherited from Control)
OnSystemColorsChanged(EventArgs)

Raises the SystemColorsChanged event.

OnTabIndexChanged(EventArgs)

Raises the TabIndexChanged event.

(Inherited from Control)
OnTabStopChanged(EventArgs)

Raises the TabStopChanged event.

(Inherited from Control)
OnTextChanged(EventArgs)

Raises the TextChanged event.

(Inherited from Control)
OnValidated(EventArgs)

Raises the Validated event.

(Inherited from Control)
OnValidating(CancelEventArgs)

Raises the Validating event.

(Inherited from Control)
OnVirtualItemsSelectionRangeChanged(ListViewVirtualItemsSelectionRangeChangedEventArgs)

Raises the VirtualItemsSelectionRangeChanged event.

OnVisibleChanged(EventArgs)

Raises the VisibleChanged event.

(Inherited from Control)
PerformLayout()

Forces the control to apply layout logic to all its child controls.

(Inherited from Control)
PerformLayout(Control, String)

Forces the control to apply layout logic to all its child controls.

(Inherited from Control)
PointToClient(Point)

Computes the location of the specified screen point into client coordinates.

(Inherited from Control)
PointToScreen(Point)

Computes the location of the specified client point into screen coordinates.

(Inherited from Control)
PreProcessControlMessage(Message)

Preprocesses keyboard or input messages within the message loop before they are dispatched.

(Inherited from Control)
PreProcessMessage(Message)

Preprocesses keyboard or input messages within the message loop before they are dispatched.

(Inherited from Control)
ProcessCmdKey(Message, Keys)

Processes a command key.

(Inherited from Control)
ProcessDialogChar(Char)

Processes a dialog character.

(Inherited from Control)
ProcessDialogKey(Keys)

Processes a dialog key.

(Inherited from Control)
ProcessKeyEventArgs(Message)

Processes a key message and generates the appropriate control events.

(Inherited from Control)
ProcessKeyMessage(Message)

Processes a keyboard message.

(Inherited from Control)
ProcessKeyPreview(Message)

Previews a keyboard message.

(Inherited from Control)
ProcessMnemonic(Char)

Processes a mnemonic character.

(Inherited from Control)
RaiseDragEvent(Object, DragEventArgs)

Raises the appropriate drag event.

(Inherited from Control)
RaiseKeyEvent(Object, KeyEventArgs)

Raises the appropriate key event.

(Inherited from Control)
RaiseMouseEvent(Object, MouseEventArgs)

Raises the appropriate mouse event.

(Inherited from Control)
RaisePaintEvent(Object, PaintEventArgs)

Raises the appropriate paint event.

(Inherited from Control)
RealizeProperties()

Initializes the properties of the ListView control that manage the appearance of the control.

RecreateHandle()

Forces the re-creation of the handle for the control.

(Inherited from Control)
RectangleToClient(Rectangle)

Computes the size and location of the specified screen rectangle in client coordinates.

(Inherited from Control)
RectangleToScreen(Rectangle)

Computes the size and location of the specified client rectangle in screen coordinates.

(Inherited from Control)
RedrawItems(Int32, Int32, Boolean)

Forces a range of ListViewItem objects to be redrawn.

Refresh()

Forces the control to invalidate its client area and immediately redraw itself and any child controls.

(Inherited from Control)
RescaleConstantsForDpi(Int32, Int32)

Provides constants for rescaling the control when a DPI change occurs.

(Inherited from Control)
ResetBackColor()

Resets the BackColor property to its default value.

(Inherited from Control)
ResetBindings()

Causes a control bound to the BindingSource to reread all the items in the list and refresh their displayed values.

(Inherited from Control)
ResetCursor()

Resets the Cursor property to its default value.

(Inherited from Control)
ResetFont()

Resets the Font property to its default value.

(Inherited from Control)
ResetForeColor()

Resets the ForeColor property to its default value.

(Inherited from Control)
ResetImeMode()

Resets the ImeMode property to its default value.

(Inherited from Control)
ResetMouseEventArgs()

Resets the control to handle the MouseLeave event.

(Inherited from Control)
ResetRightToLeft()

Resets the RightToLeft property to its default value.

(Inherited from Control)
ResetText()

Resets the Text property to its default value (Empty).

(Inherited from Control)
ResumeLayout()

Resumes usual layout logic.

(Inherited from Control)
ResumeLayout(Boolean)

Resumes usual layout logic, optionally forcing an immediate layout of pending layout requests.

(Inherited from Control)
RtlTranslateAlignment(ContentAlignment)

Converts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text.

(Inherited from Control)
RtlTranslateAlignment(HorizontalAlignment)

Converts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text.

(Inherited from Control)
RtlTranslateAlignment(LeftRightAlignment)

Converts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text.

(Inherited from Control)
RtlTranslateContent(ContentAlignment)

Converts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text.

(Inherited from Control)
RtlTranslateHorizontal(HorizontalAlignment)

Converts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text.

(Inherited from Control)
RtlTranslateLeftRight(LeftRightAlignment)

Converts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text.

(Inherited from Control)
Scale(Single)
Obsolete.
Obsolete.

Scales the control and any child controls.

(Inherited from Control)
Scale(Single, Single)
Obsolete.
Obsolete.

Scales the entire control and any child controls.

(Inherited from Control)
Scale(SizeF)

Scales the control and all child controls by the specified scaling factor.

(Inherited from Control)
ScaleBitmapLogicalToDevice(Bitmap)

Scales a logical bitmap value to it's equivalent device unit value when a DPI change occurs.

(Inherited from Control)
ScaleControl(SizeF, BoundsSpecified)

Scales a control's location, size, padding and margin.

(Inherited from Control)
ScaleCore(Single, Single)

This method is not relevant for this class.

(Inherited from Control)
Select()

Activates the control.

(Inherited from Control)
Select(Boolean, Boolean)

Activates a child control. Optionally specifies the direction in the tab order to select the control from.

(Inherited from Control)
SelectNextControl(Control, Boolean, Boolean, Boolean, Boolean)

Activates the next control.

(Inherited from Control)
SendToBack()

Sends the control to the back of the z-order.

(Inherited from Control)
SetAutoSizeMode(AutoSizeMode)

Sets a value indicating how a control will behave when its AutoSize property is enabled.

(Inherited from Control)
SetBounds(Int32, Int32, Int32, Int32)

Sets the bounds of the control to the specified location and size.

(Inherited from Control)
SetBounds(Int32, Int32, Int32, Int32, BoundsSpecified)

Sets the specified bounds of the control to the specified location and size.

(Inherited from Control)
SetBoundsCore(Int32, Int32, Int32, Int32, BoundsSpecified)

Performs the work of setting the specified bounds of this control.

(Inherited from Control)
SetClientSizeCore(Int32, Int32)

Sets the size of the client area of the control.

(Inherited from Control)
SetStyle(ControlStyles, Boolean)

Sets a specified ControlStyles flag to either true or false.

(Inherited from Control)
SetTopLevel(Boolean)

Sets the control as the top-level control.

(Inherited from Control)
SetVisibleCore(Boolean)

Sets the control to the specified visible state.

(Inherited from Control)
Show()

Displays the control to the user.

(Inherited from Control)
SizeFromClientSize(Size)

Determines the size of the entire control from the height and width of its client area.

(Inherited from Control)
Sort()

Sorts the items of the list view.

SuspendLayout()

Temporarily suspends the layout logic for the control.

(Inherited from Control)
ToString()

Returns a string representation of the ListView control.

Update()

Causes the control to redraw the invalidated regions within its client area.

(Inherited from Control)
UpdateBounds()

Updates the bounds of the control with the current size and location.

(Inherited from Control)
UpdateBounds(Int32, Int32, Int32, Int32)

Updates the bounds of the control with the specified size and location.

(Inherited from Control)
UpdateBounds(Int32, Int32, Int32, Int32, Int32, Int32)

Updates the bounds of the control with the specified size, location, and client size.

(Inherited from Control)
UpdateExtendedStyles()

Updates the extended styles applied to the list view control.

UpdateStyles()

Forces the assigned styles to be reapplied to the control.

(Inherited from Control)
UpdateZOrder()

Updates the control in its parent's z-order.

(Inherited from Control)
WndProc(Message)

Overrides WndProc(Message).

Events

AfterLabelEdit

Occurs when the label for an item is edited by the user.

AutoSizeChanged

This event is not relevant for this class.

(Inherited from Control)
BackColorChanged

Occurs when the value of the BackColor property changes.

(Inherited from Control)
BackgroundImageChanged

Occurs when the value of the BackgroundImage property changes.

BackgroundImageChanged

Occurs when the value of the BackgroundImage property changes.

(Inherited from Control)
BackgroundImageLayoutChanged

Occurs when the BackgroundImageLayout property changes.

BackgroundImageLayoutChanged

Occurs when the BackgroundImageLayout property changes.

(Inherited from Control)
BeforeLabelEdit

Occurs when the user starts editing the label of an item.

BindingContextChanged

Occurs when the value of the BindingContext property changes.

(Inherited from Control)
CacheVirtualItems

Occurs when the contents of the display area for a ListView in virtual mode has changed, and the ListView determines that a new range of items is needed.

CausesValidationChanged

Occurs when the value of the CausesValidation property changes.

(Inherited from Control)
ChangeUICues

Occurs when the focus or keyboard user interface (UI) cues change.

(Inherited from Control)
Click

Occurs when the control is clicked.

(Inherited from Control)
ClientSizeChanged

Occurs when the value of the ClientSize property changes.

(Inherited from Control)
ColumnClick

Occurs when the user clicks a column header within the list view control.

ColumnReordered

Occurs when the column header order is changed.

ColumnWidthChanged

Occurs after the width of a column is successfully changed.

ColumnWidthChanging

Occurs when the width of a column is changing.

ContextMenuChanged

Occurs when the value of the ContextMenu property changes.

(Inherited from Control)
ContextMenuStripChanged

Occurs when the value of the ContextMenuStrip property changes.

(Inherited from Control)
ControlAdded

Occurs when a new control is added to the Control.ControlCollection.

(Inherited from Control)
ControlRemoved

Occurs when a control is removed from the Control.ControlCollection.

(Inherited from Control)
CursorChanged

Occurs when the value of the Cursor property changes.

(Inherited from Control)
DataContextChanged

Occurs when the value of the DataContext property changes.

(Inherited from Control)
Disposed

Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
DockChanged

Occurs when the value of the Dock property changes.

(Inherited from Control)
DoubleClick

Occurs when the control is double-clicked.

(Inherited from Control)
DpiChangedAfterParent

Occurs when the DPI setting for a control is changed programmatically after the DPI of its parent control or form has changed.

(Inherited from Control)
DpiChangedBeforeParent

Occurs when the DPI setting for a control is changed programmatically before a DPI change event for its parent control or form has occurred.

(Inherited from Control)
DragDrop

Occurs when a drag-and-drop operation is completed.

(Inherited from Control)
DragEnter

Occurs when an object is dragged into the control's bounds.

(Inherited from Control)
DragLeave

Occurs when an object is dragged out of the control's bounds.

(Inherited from Control)
DragOver

Occurs when an object is dragged over the control's bounds.

(Inherited from Control)
DrawColumnHeader

Occurs when the details view of a ListView is drawn and the OwnerDraw property is set to true.

DrawItem

Occurs when a ListView is drawn and the OwnerDraw property is set to true.

DrawSubItem

Occurs when the details view of a ListView is drawn and the OwnerDraw property is set to true.

EnabledChanged

Occurs when the Enabled property value has changed.

(Inherited from Control)
Enter

Occurs when the control is entered.

(Inherited from Control)
FontChanged

Occurs when the Font property value changes.

(Inherited from Control)
ForeColorChanged

Occurs when the ForeColor property value changes.

(Inherited from Control)
GiveFeedback

Occurs during a drag operation.

(Inherited from Control)
GotFocus

Occurs when the control receives focus.

(Inherited from Control)
GroupCollapsedStateChanged

Occurs when the CollapsedState changes on a ListViewGroup.

GroupTaskLinkClick

Occurs when the user clicks a TaskLink on a ListViewGroup.

HandleCreated

Occurs when a handle is created for the control.

(Inherited from Control)
HandleDestroyed

Occurs when the control's handle is in the process of being destroyed.

(Inherited from Control)
HelpRequested

Occurs when the user requests help for a control.

(Inherited from Control)
ImeModeChanged

Occurs when the ImeMode property has changed.

(Inherited from Control)
Invalidated

Occurs when a control's display requires redrawing.

(Inherited from Control)
ItemActivate

Occurs when an item is activated.

ItemCheck

Occurs when the check state of an item changes.

ItemChecked

Occurs when the checked state of an item changes.

ItemDrag

Occurs when the user begins dragging an item.

ItemMouseHover

Occurs when the mouse hovers over an item.

ItemSelectionChanged

Occurs when the selection state of an item changes.

KeyDown

Occurs when a key is pressed while the control has focus.

(Inherited from Control)
KeyPress

Occurs when a character, space, or backspace key is pressed while the control has focus.

(Inherited from Control)
KeyUp

Occurs when a key is released while the control has focus.

(Inherited from Control)
Layout

Occurs when a control should reposition its child controls.

(Inherited from Control)
Leave

Occurs when the input focus leaves the control.

(Inherited from Control)
LocationChanged

Occurs when the Location property value has changed.

(Inherited from Control)
LostFocus

Occurs when the control loses focus.

(Inherited from Control)
MarginChanged

Occurs when the control's margin changes.

(Inherited from Control)
MouseCaptureChanged

Occurs when the control loses mouse capture.

(Inherited from Control)
MouseClick

Occurs when the control is clicked by the mouse.

(Inherited from Control)
MouseDoubleClick

Occurs when the control is double clicked by the mouse.

(Inherited from Control)
MouseDown

Occurs when the mouse pointer is over the control and a mouse button is pressed.

(Inherited from Control)
MouseEnter

Occurs when the mouse pointer enters the control.

(Inherited from Control)
MouseHover

Occurs when the mouse pointer rests on the control.

(Inherited from Control)
MouseLeave

Occurs when the mouse pointer leaves the control.

(Inherited from Control)
MouseMove

Occurs when the mouse pointer is moved over the control.

(Inherited from Control)
MouseUp

Occurs when the mouse pointer is over the control and a mouse button is released.

(Inherited from Control)
MouseWheel

Occurs when the mouse wheel moves while the control has focus.

(Inherited from Control)
Move

Occurs when the control is moved.

(Inherited from Control)
PaddingChanged

Occurs when the value of the Padding property changes.

PaddingChanged

Occurs when the control's padding changes.

(Inherited from Control)
Paint

Occurs when the ListView control is painted.

ParentChanged

Occurs when the Parent property value changes.

(Inherited from Control)
PreviewKeyDown

Occurs before the KeyDown event when a key is pressed while focus is on this control.

(Inherited from Control)
QueryAccessibilityHelp

Occurs when AccessibleObject is providing help to accessibility applications.

(Inherited from Control)
QueryContinueDrag

Occurs during a drag-and-drop operation and enables the drag source to determine whether the drag-and-drop operation should be canceled.

(Inherited from Control)
RegionChanged

Occurs when the value of the Region property changes.

(Inherited from Control)
Resize

Occurs when the control is resized.

(Inherited from Control)
RetrieveVirtualItem

Occurs when the ListView is in virtual mode and requires a ListViewItem.

RightToLeftChanged

Occurs when the RightToLeft property value changes.

(Inherited from Control)
RightToLeftLayoutChanged

Occurs when the value of the RightToLeftLayout property changes.

SearchForVirtualItem

Occurs when the ListView is in virtual mode and a search is taking place.

SelectedIndexChanged

Occurs when the SelectedIndices collection changes.

SizeChanged

Occurs when the Size property value changes.

(Inherited from Control)
StyleChanged

Occurs when the control style changes.

(Inherited from Control)
SystemColorsChanged

Occurs when the system colors change.

(Inherited from Control)
TabIndexChanged

Occurs when the TabIndex property value changes.

(Inherited from Control)
TabStopChanged

Occurs when the TabStop property value changes.

(Inherited from Control)
TextChanged

Occurs when the Text property changes.

Validated

Occurs when the control is finished validating.

(Inherited from Control)
Validating

Occurs when the control is validating.

(Inherited from Control)
VirtualItemsSelectionRangeChanged

Occurs when a ListView is in virtual mode and the selection state of a range of items has changed.

VisibleChanged

Occurs when the Visible property value changes.

(Inherited from Control)

Explicit Interface Implementations

IDropTarget.OnDragDrop(DragEventArgs)

Raises the DragDrop event.

(Inherited from Control)
IDropTarget.OnDragEnter(DragEventArgs)

Raises the DragEnter event.

(Inherited from Control)
IDropTarget.OnDragLeave(EventArgs)

Raises the DragLeave event.

(Inherited from Control)
IDropTarget.OnDragOver(DragEventArgs)

Raises the DragOver event.

(Inherited from Control)

Applies to

See also