image_size() [2/2]

const image_list & xtd::forms::image_list::image_size

(

const drawing::size &

value

)

Sets the size of the images in the image list.

Parameters

value

The xtd::drawing::size that defines the height and width, in pixels, of the images in the list. The default size is 16 by 16. The maximum size is 256 by 256.

Remarks

Setting the image_size property prior to adding images to the image collection causes the images to be resized to the image size specified.

When you set the image_size property to a new value, the handle for the image list is recreated.

Because setting the image_size property causes the handle to be recreated, you should set image_size prior to setting the Images property. When the handle for the image_list has been created, setting the color_depth or image_size properties in code, after setting the images property, will cause the collection of images set for the images property to be deleted.