Visual Basic (Declaration) | |
---|---|
Public Property Image As RasterImage |
Visual Basic (Usage) | Copy Code |
---|---|
|
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).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.
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