AutoResetOptions Property

Summary

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

Syntax

C++/CLI

public virtual ImageViewerAutoResetOptions AutoResetOptions { 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:

using Leadtools; 
using Leadtools.Controls; 
using Leadtools.Codecs; 
using Leadtools.Drawing; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Color; 
 
 
public ImageViewerForm _form = new ImageViewerForm(); 
private ImageViewer _imageViewer; 
 
public void ImageViewerAutoResetOptionsExample() 
{ 
   // Get the Form's ImageViewer control 
   _imageViewer = _form.ImageViewer; 
 
   // Change AutoResetOptions 
   _imageViewer.AutoResetOptions = ImageViewerAutoResetOptions.None; 
 
   // Load an image 
   using (var codecs = new RasterCodecs()) 
      _imageViewer.Image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Ocr1.tif")); 
 
   // Change Zoom 
   _imageViewer.Zoom(ControlSizeMode.None, 1.4, _imageViewer.DefaultZoomOrigin); 
 
   // Load new image on click 
   _imageViewer.Click += _imageViewer_Click; 
} 
 
private void _imageViewer_Click(object sender, EventArgs e) 
{ 
   // Load another image, zoom scale factor is maintained 
   using (var codecs = new RasterCodecs()) 
      _imageViewer.Image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Ocr2.tif")); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS23\Resources\Images"; 
}

Requirements

Target Platforms

Reference

ImageViewer Class

ImageViewer Members

Leadtools.Controls Namespace

Download our FREE evaluation

Help Version 23.0.2024.2.29

Leadtools.Controls Assembly

Introduction

Getting Started

Namespaces

Leadtools.Controls Namespace

Assemblies