Leadtools.WinForms Send comments on this topic. | Back to Introduction - All Topics | Help Version 15.8.31
ItemImageSize Property
See Also 
Leadtools.WinForms Namespace > RasterImageList Class : ItemImageSize Property




Gets or sets the maximum size of the image of each RasterImageListItem in the control.

Syntax

Visual Basic (Declaration) 
<DescriptionAttribute("Size of each item image in pixels.")>
<CategoryAttribute("Appearance")>
Public Property ItemImageSize As Size
Visual Basic (Usage)Copy Code
Dim instance As RasterImageList
Dim value As Size
 
instance.ItemImageSize = value
 
value = instance.ItemImageSize
C# 
[DescriptionAttribute("Size of each item image in pixels.")]
[CategoryAttribute("Appearance")]
public Size ItemImageSize {get; set;}
Managed Extensions for C++ 
[DescriptionAttribute("Size of each item image in pixels.")]
[CategoryAttribute("Appearance")]
public: __property Size get_ItemImageSize();
public: __property void set_ItemImageSize( 
   Size value
);
C++/CLI 
[DescriptionAttribute("Size of each item image in pixels.")]
[CategoryAttribute("Appearance")]
public:
property Size ItemImageSize {
   Size get();
   void set (Size value);
}

Return Value

A Size structure that specifies the maximum size of the image of each RasterImageListItem in this RasterImageList in pixels.

Example

For an example, refer to DrawItem event.

Remarks

The ItemImageSize specifies the maximum size of the image of each item in the RasterImageList control. The RasterImageListItem.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 RasterImageListItem.Image of an item is smaller than ItemImageSize, then no re-sizing is done when the image is drawn. In other words, the RasterImageList control implements a "Fit if larger" drawing algorithm when the item images are painted.

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 ItemImageSize plus room for ItemBorderStyle and ItemImageBorderStyle. If you set the ShowItemText property to true, then you should also accommodate room for the item text in your calculations.

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

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also