←Select platform

AutoResetOptions Property


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

public virtual ImageViewerAutoResetOptions AutoResetOptions { get; set; } 
Public Overridable Property AutoResetOptions() As ImageViewerAutoResetOptions 
   virtual property ImageViewerAutoResetOptions^ AutoResetOptions 
      ImageViewerAutoResetOptions^ get() 
      void set(ImageViewerAutoResetOptions^ value) 

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 SvgDocument 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:

using Leadtools; 
using Leadtools.Controls; 
using Leadtools.Codecs; 
using Leadtools.Drawing; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Color; 
public void ImageViewerAutoResetOptions_Example(RasterImage image) 
   ImageViewerAutoResetOptions options = _imageViewer.AutoResetOptions; // save 
   _imageViewer.AutoResetOptions = ImageViewerAutoResetOptions.None; 
   _imageViewer.Image = image; 
   _imageViewer.AutoResetOptions = options; 
Imports Leadtools 
Imports Leadtools.Controls 
Imports Leadtools.Codecs 
Imports Leadtools.Drawing 
Imports Leadtools.ImageProcessing 
Imports Leadtools.ImageProcessing.Color 
Imports LeadtoolsControlsExamples.LeadtoolsExamples.Common 
Public Sub ImageViewerAutoResetOptions_Example(ByVal image As RasterImage) 
   Dim options As ImageViewerAutoResetOptions = _imageViewer.AutoResetOptions ' save 
   _imageViewer.AutoResetOptions = ImageViewerAutoResetOptions.None 
   _imageViewer.Image = image 
   _imageViewer.AutoResetOptions = options 
End Sub 
Target Platforms
Help Version 21.0.2021.3.2
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Controls Assembly