ImageViewerSizeMode Enumeration

Determines how the control displays the image and the automatic adjustments of the display rectangles.

Syntax

JavaScript

Leadtools.Controls.ImageViewerSizeMode = function() { };
Leadtools.Controls.ImageViewerSizeMode.prototype = {

	none = 0x00000000,
	actualSize = 0x00000001,
	fit = 0x00000002,
	fitAlways = 0x00000003,
	fitWidth = 0x00000004,
	fitHeight = 0x00000005,
	stretch = 0x00000006,
	
 };

Members

Value	Member	Description
0x00000000	none	(0)No special sizing
0x00000001	actualSize	(1)Use the image actual size
0x00000002	fit	(2)Fit the image into the viewing area while maintaining the aspect ratio. If the image size is smaller than the viewing area, no resizing is done.
0x00000003	fitAlways	(3)Always fit the image into the viewing area while maintaining the aspect ratio even if the image size is smaller than the viewing area (in which case, the image will be scaled up)
0x00000004	fitWidth	(4)Fit the image width to be the size of the width of the viewing area while maintaining the aspect ratio
0x00000005	fitHeight	(5)Fit the image height to be the size of the height of the viewing area while maintaining the aspect ratio
0x00000006	stretch	(6)Fit the image to fill the viewing area. Aspect ratio might not be maintained

Remarks

By setting the ImageViewer.SizeMode property to one of the ImageViewerSizeMode enumeration values, the control will determine how to fit the image in the viewing area.

When using the None and ActualSize with the ImageViewer control, vertical or horizontal scrollbars may become visible and functional if the image size becomes greater than the viewing area (depending on the value of ImageViewer.ScrollMode). The image size is determined by the image physical pixel width and height and the values of the ImageViewer.UseDpi and ImageViewer.ScaleFactor properties. The ImageViewer.AspectRatioCorrection will also play a role in determining the image size of its value is other than 1. The viewing area size is determined from the current pixel size of the control client area.

When the using ImageViewer.SizeMode, the value of ImageViewer.ScaleFactor will not be reset back to 1 automatically. You can either set the value of ImageViewer.ScaleFactor to 1 if this is the required behavior or use the ImageViewer.Zoom method that will have the size mode and scale factor values to setup the current view to any desired values using one method.

Example

For an example, see ImageViewer.Zoom.

Reference

Leadtools.Controls Namespace