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



The image associated with this RasterImageListItem object.

Syntax

Visual Basic (Declaration) 
Public Property Image As RasterImage
Visual Basic (Usage)Copy Code
Dim instance As RasterImageListItem
Dim value As RasterImage
 
instance.Image = value
 
value = instance.Image
C# 
public RasterImage Image {get; set;}
C++/CLI 
public:
property RasterImage Image {
   RasterImage get();
   void set (RasterImage value);
}

Return Value

An RasterImage object associated with this RasterImageListItem object. The default value is null (Nothing in Visual Basic).

Example

For an example, refer to Image.

Remarks

The Page property specifies the 1-based page number to view from this image.

The value of RasterImage.Page is not used to control the page number of the item to be viewed in this item. Instead, use the Page property. This allows the same RasterImage object to be used multiple items while setting the Page property to different values.

The RasterImageList control will paint this image onto the item surface. If the item does not have an image, the value of this property is null (Nothing in Visual Basic) and, nothing is painted.

The RasterImageList control paints the image in the following manner:

  • If the image size is less than or equal to the ItemImageSize value, the image is painted with its original size only centered onto the item surface.
  • If the image size is grater than the ItemImageSize value, the image is stretched to this smaller size and the aspect ratio is kept the same.
  • It is recommended that you populate the items with "thumbnail" images. This will increase the performance of the item painting operation. In such cases, use the Tag or FileName properties to store the information needed to load the image in its original size when requested.

The value of RasterImage.Page is not used to control the page number of the item to be viewed in this item. Instead, use the Page property. This allows the same RasterImage object to be used in multiple items while setting the Page property to different values.

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