autoResetOptions Property


Determines which display properties to reset when a new image is set into the viewer (single item mode).


JavaScript Syntax
Object.defineProperty(ImageViewer.prototype, 'autoResetOptions', 
	get: function(), 
	set: function(value) 
TypeScript Syntax
autoResetOptions: ImageViewerAutoResetOptions; 

Property Value

Value that determines which display properties to reset when a new image is set into the viewer (single item mode). Default value is ImageViewerAutoResetOptions.All.


Use this property to control which of the display properties of the controls resets back to its default value when a new image is set into the ImageUrl, Image or Canvas properties or when the user changes ImageSize directly.

The viewer will call Reset to perform the resetting of the values.


Run the demo and click the Example button. The image will be zoomed (its scale factor and scroll offset will be changed) to a certain value. Then the viewer will use AutoResetOptions to not change these values when a new image is set.

Start with the ImageViewer example, remove all the code inside the example function (search for the "// TODO: add example code here" comment) and insert the following code:

JavaScript Example
function ImageViewer_AutoResetOptions(image) { 
   var options = this._imageViewer.autoResetOptions; // save 
   this._imageViewer.autoResetOptions = lt.Controls.ImageViewerAutoResetOptions.none; 
   this._imageViewer.image = image; 
   this._imageViewer.autoResetOptions = options; 


Target Platforms

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Controls Assembly