Export (0) Print
Expand All
Expand Minimize

ListView.EnsureVisible Method

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

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

public void EnsureVisible(
	int index
)

Parameters

index
Type: System.Int32

The zero-based index of the item to scroll into view.

You can use this method to ensure that a specific item is visible within the ListView control. When performing validation on the items in a ListView, you can call the EnsureVisible method to ensure that an item that failed validation is displayed in the ListView control to allow the user to perform changes on the item. If the item that you want to ensure is visible is located above the viewable region of the ListView control, calling the EnsureVisible method will scroll the contents of the control until it is the first item in the viewable area of the control. If the item is below the viewable region of the ListView control, calling the EnsureVisible method will scroll the contents of the ListView control until the item is the last item in the viewable area of the control.

To determine if an item is located at the top of the display area of a ListView control, use the TopItem property.

.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