LEADTOOLS WPF and Silverlight (Leadtools.Windows.Controls assembly)
LEAD Technologies, Inc

EnsureVisible Method

Example 





The zero-based index of the item to scroll into view.
Ensures that the specified item is visible within the control, scrolling the contents of the control if necessary. .NET support Silverlight support
Syntax
public void EnsureVisible( 
   int index
)
'Declaration
 
Public Sub EnsureVisible( _
   ByVal index As Integer _
) 
'Usage
 
Dim instance As ImageList
Dim index As Integer
 
instance.EnsureVisible(index)
public void EnsureVisible( 
   int index
)
 function Leadtools.Windows.Controls.ImageList.EnsureVisible( 
   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 ImageList control. When performing validation on the items in a ImageList, you can call the EnsureVisible method to ensure that an item that failed validation is displayed in the ImageList 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 ImageList 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 ImageList control, calling the EnsureVisible method will scroll the contents of the ImageList control until the item is the last item in the viewable area of the control.

Example
Copy CodeCopy Code  
Public Sub ImageList_EnsureVisible(ByVal imageList As ImageList)
      imageList.Orientation = Orientation.Horizontal
      ' Append the new item to the image list control
      Dim imageFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "cannon.jpg")
      Dim item As ImageListItem = New ImageListItem()
      item.Source = New BitmapImage(New Uri(imageFileName))
      item.Text = "New Item"

      imageList.Items.Add(item)
      Dim nIndex As Integer = imageList.Items.IndexOf(item)

      ' Make sure this new item is visible to the user
      imageList.EnsureVisible(nIndex)
   End Sub

Public NotInheritable Class LEAD_VARS
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images"
End Class
public void ImageList_EnsureVisible(ImageList imageList)
   {
      imageList.Orientation = Orientation.Horizontal;
      // Append the new item to the image list control
      string imageFileName = Path.Combine(LEAD_VARS.ImagesDir, "cannon.jpg");
      ImageListItem item = new ImageListItem();
      item.Source = new BitmapImage(new Uri(imageFileName));
      item.Text = "New Item";

      imageList.Items.Add(item);
      int nIndex = imageList.Items.IndexOf(item);

      // Make sure this new item is visible to the user
      imageList.EnsureVisible(nIndex);
   }

static class LEAD_VARS
{
   public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images";
}
public void ImageList_EnsureVisible(ImageList imageList)
{
   imageList.Orientation = Orientation.Horizontal;
   // Append the new item to the image list control
   string imageFileName = LeadtoolsExamples.Common.ImagesPath.Path + "cannon.jpg";
   ImageListItem item = new ImageListItem();
   item.Source = new BitmapImage(new Uri(imageFileName));
   item.Text = "New Item";

   imageList.Items.Add(item);
   int nIndex = imageList.Items.IndexOf(item);

   // Make sure this new item is visible to the user
   imageList.EnsureVisible(nIndex);
}
Public Sub ImageList_EnsureVisible(ByVal imageList As ImageList)
   imageList.Orientation = Orientation.Horizontal
   ' Append the new item to the image list control
   Dim imageFileName As String = LeadtoolsExamples.Common.ImagesPath.Path & "cannon.jpg"
   Dim item As ImageListItem = New ImageListItem()
   item.Source = New BitmapImage(New Uri(imageFileName))
   item.Text = "New Item"

   imageList.Items.Add(item)
   Dim nIndex As Integer = imageList.Items.IndexOf(item)

   ' Make sure this new item is visible to the user
   imageList.EnsureVisible(nIndex)
End Sub
Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also

Reference

ImageList Class
ImageList Members

 

 


Products | Support | Contact Us | Copyright Notices

© 2006-2012 All Rights Reserved. LEAD Technologies, Inc.