ListViewItemSelectionChangedEventArgs Class

Reference

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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.

Provides data for the ItemSelectionChanged event.

public ref class ListViewItemSelectionChangedEventArgs : EventArgs

public class ListViewItemSelectionChangedEventArgs : EventArgs

type ListViewItemSelectionChangedEventArgs = class
    inherit EventArgs

Public Class ListViewItemSelectionChangedEventArgs
Inherits EventArgs

Inheritance: Object

EventArgs
ListViewItemSelectionChangedEventArgs

Examples

The following code example demonstrates the use of this type. In the example, an event handler reports on the occurrence of the ItemSelectionChanged event. This report helps you to learn when the event occurs and can assist you in debugging. To report on multiple events or on events that occur frequently, consider replacing Show with Console.WriteLine or appending the message to a multiline TextBox.

To run the example code, paste it into a project that contains an instance of type ListView named ListView1. Then ensure that the event handler is associated with the ItemSelectionChanged event.

private void ListView1_ItemSelectionChanged(Object sender, ListViewItemSelectionChangedEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "IsSelected", e.IsSelected );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Item", e.Item );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "ItemIndex", e.ItemIndex );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "ItemSelectionChanged Event" );
}

Private Sub ListView1_ItemSelectionChanged(sender as Object, e as ListViewItemSelectionChangedEventArgs) _ 
     Handles ListView1.ItemSelectionChanged

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "IsSelected", e.IsSelected)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Item", e.Item)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "ItemIndex", e.ItemIndex)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"ItemSelectionChanged Event")

End Sub

Remarks

The ItemSelectionChanged event occurs when the selection state of a ListViewItem changes from selected to deselected or deselected to selected. The ItemSelectionChanged will not occur if the ListView is in virtual mode.

Constructors

ListViewItemSelectionChangedEventArgs(ListViewItem, Int32, Boolean)

Initializes a new instance of the ListViewItemSelectionChangedEventArgs class.

Properties

IsSelected	Gets a value indicating whether the item's state has changed to selected.
Item	Gets the item whose selection state has changed.
ItemIndex	Gets the index of the item whose selection state has changed.

Methods

Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetType()	Gets the Type of the current instance. (Inherited from Object)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
ToString()	Returns a string that represents the current object. (Inherited from Object)

Applies to

Share via