LEADTOOLS WinRT(Leadtools.Controls)
Send comments on this topic. | Back to Introduction - All Topics | Help Version 17.5.11.4
public enum ImageViewerSizeMode : System.Enum
Leadtools.Controls.ImageViewerSizeMode = function() { };
Leadtools.Controls.ImageViewerSizeMode.prototype = {
LeadtoolsMemberMarker(replace me)
};
| Member | Description |
|---|---|
| ActualSize | (1)Use the image actual size |
| 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. |
| 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) |
| FitHeight | (5)Fit the image height to be the size of the height of the viewing area while maintaining the aspect ratio |
| FitWidth | (4)Fit the image width to be the size of the width of the viewing area while maintaining the aspect ratio |
| None | (0)No special sizing |
| Stretch | (6)Fit the image to fill the viewing area. Aspect ratio might not be maintained |
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.
Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2