EnsureVisible Method (RasterThumbnailBrowser)

Summary

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

Syntax

C++

public void EnsureVisible(  
   int index 
)

public: 
void EnsureVisible(  
   int index 
)

Parameters

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

Remarks

You can use this method to ensure that a specific item is visible within the RasterImageList control. When performing validation on the items in a RasterImageList, you can call the RasterImageList.EnsureVisible method to ensure that an item that failed validation is displayed in the RasterImageList 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 RasterImageList control, calling the RasterImageList.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 RasterImageList control, calling the RasterImageList.EnsureVisible method will scroll the contents of the RasterImageList 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 RasterImageList control, use the TopIndex property.

Example

This example will add a new item to the end of a RasterImageList control and make sure the item is visible to the user.

Requirements

Target Platforms