Public Property ImageSize As Size

Visual Basic (Usage)	Copy Code
Dim instance As ImageListItem Dim value As Size   instance.ImageSize = value   value = instance.ImageSize

public Size ImageSize {get; set;}

public:
property Size ImageSize {
   Size get();
   void set (Size value);
}

Return Value

For XAML example, refer to ImageSize.

Visual Basic

Copy Code

Private Class MyWindow1 : Inherits Window    Public imageList As ListBox    Public Sub New(ByVal title As String)       title = title       ' Set the size of the window       Width = 400       Height = 200       ' Create a new ImageList control.       imageList = New ListBox()       imageList.Width = Double.NaN       imageList.Height = Double.NaN       imageList.Items.SortDescriptions.Clear()       imageList.Background = New RadialGradientBrush(Colors.DarkGray, Colors.LightGray)       imageList.Items.SortDescriptions.Add(New SortDescription("Text", ListSortDirection.Ascending))       imageList.BorderThickness = New Thickness(5, 5, 5, 5)       ' Create three items           Dim imagesPath As String = LeadtoolsExamples.Common.ImagesPath.Path + ""       For i As Integer = 0 To 2          Dim index As Integer = i + 1          Dim imageFileName As String = imagesPath & "Image" & index.ToString() & ".jpg"          Dim item As ImageListItem = New ImageListItem()          item.ViewStyle = ImageListViewStyle.Normal          item.FileName = imageFileName          item.Text = imageFileName          item.ShowText = True          item.Image = New BitmapImage(New Uri(imageFileName))          item.ImageSize = New Size(120, 120)          item.Width = 150          item.Height = 150          item.SelectedBackground = Brushes.White          item.SelectedForeground = Brushes.Blue          ' Select the first item          If i = 0 Then             item.IsSelected = True          End If          ' Add the item to the image list          imageList.Items.Add(item)       Next i       ' Add the ImageList to the Window.       Content = imageList    End Sub End Class Public Sub ImageListItem_ImageSize(ByVal title As String)    Dim window As MyWindow1 = New MyWindow1(title)    window.ShowDialog() End Sub

C#

Copy Code

class MyWindow1 : Window  {     public ListBox imageList;     public MyWindow1(string title)     {        Title = title;        // Set the size of the window        Width = 400;        Height = 200;          // Create a new ImageList control.        imageList = new ListBox();        imageList.Width = Double.NaN;        imageList.Height = Double.NaN;          imageList.Items.SortDescriptions.Clear();        imageList.Background = new RadialGradientBrush(Colors.DarkGray, Colors.LightGray);        imageList.Items.SortDescriptions.Add(new SortDescription("Text", ListSortDirection.Ascending));          imageList.BorderThickness = new Thickness(5, 5, 5, 5);            // Create three items        string imagesPath = LeadtoolsExamples.Common.ImagesPath.Path;          for (int i = 0; i < 3; i++)        {           int index = i + 1;           string imageFileName = imagesPath + "Image" + index.ToString() + ".jpg";             ImageListItem item = new ImageListItem();           item.ViewStyle = ImageListViewStyle.Normal;           item.FileName = imageFileName;           item.Text = imageFileName;           item.ShowText = true;           item.Image = new BitmapImage(new Uri(imageFileName));           item.ImageSize = new Size(120, 120);           item.Width = 150;           item.Height = 150;           item.SelectedBackground = Brushes.White;           item.SelectedForeground = Brushes.Blue;             // Select the first item           if (i == 0)              item.IsSelected = true;             // Add the item to the image list           imageList.Items.Add(item);        }          // Add the ImageList to the Window.        Content = imageList;     }  }    public void ImageListItem_ImageSize(string title)  {     MyWindow1 window = new MyWindow1(title);     window.ShowDialog();  }

The ImageSize specifies the maximum size of the image of each item in the ImageList control. The ImageListItem.Image of each image is drawn into the item surface using the maximum size possible of ItemImageSize while maintaining the aspect ratio of the image. If the ImageListItem.Image of an item is smaller than ImageSize, then no re-sizing is done when the image is drawn. In other words, the ImageList control implements a "Fit if larger" drawing algorithm when the item images are rendered.

When changing any of the item sizes or styles, you should pay special attention to the values you specify, in general, you should setup ItemSize to be large enough to accommodate ImageSize plus room for ShowText If you set theShowText property to true in your calculations.

For more information about item appearance, refer to ImageList Appearance.

Target Platforms: Microsoft .NET Framework 3.0, Windows XP, Windows Vista, and Windows Server 2003 family

Reference