←Select platform

AutoResetOptions Property

Summary

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

Syntax

C#
VB
C++
public virtual ImageViewerAutoResetOptions AutoResetOptions { get; set; } 
Public Overridable Property AutoResetOptions() As ImageViewerAutoResetOptions 
   Get 
   Set 
public:  
   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.

Remarks

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.

Example

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:

C#
VB
using Leadtools; 
using Leadtools.Controls; 
using Leadtools.Codecs; 
using Leadtools.Drawing; 
using LeadtoolsExamples.Common; 
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 

Requirements

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.WinForms Assembly