Visual Basic (Declaration) | |
---|---|
<CategoryAttribute("Appearance")> <DescriptionAttribute("Size of each item image in pixels.")> 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# | |
---|---|
[CategoryAttribute("Appearance")] [DescriptionAttribute("Size of each item image in pixels.")] public Size ItemImageSize {get; set;} |
C++/CLI | |
---|---|
[CategoryAttribute("Appearance")] [DescriptionAttribute("Size of each item image in pixels.")] public: property Size ItemImageSize { Size get(); void set ( Size value); } |
Property Value
A System.Drawing.Size structure that specifies the maximum size of the image of each RasterImageListItem in this RasterImageList in pixels.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.
Target Platforms: Microsoft .NET Framework 2.0, Windows 2000, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7