BeginUpdate Method

Summary

Stops the viewer from updating the interactive modes if any change is applied. This is useful to increase the control's efficiency.

Syntax

C++/CLI

public void BeginUpdate()

public:  
   void BeginUpdate()

Remarks

When items are added or removed from this collection, the object will might have to call ImageViewerInteractiveMode.Start and ImageViewerInteractiveMode.Stop to reset the interactive modes and stop any that is working since the order or the mode(s) that is currently enabled might change. To optimize this operation, call BeginUpdate before modifying the collection and EndUpdate after you are done. This way the object will not update the modes until all the items are added/remove and in their final state.

Calls to BeginUpdate and EndUpdate are accumulative. Each call to BeginUpdate must be matched with a corresponding call to EndUpdate or else updates to the transform won't be applied.

For more information, refer to Image Viewer Interactive Modes.

Example

using Leadtools; 
using Leadtools.Controls; 
using Leadtools.Codecs; 
using Leadtools.Drawing; 
 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Color; 
 
public void ImageViewerInteractiveModesExample() 
{ 
   // ImageViewerInteractiveModes reference 
   _imageViewer.InteractiveModes.BeginUpdate(); 
   _imageViewer.InteractiveModes.Add(new ImageViewerFloaterInteractiveMode 
   { 
      ZoomKeyModifier = Keys.None, 
      IsEnabled = true, 
      FloaterOpacity = 0.5 
   }); 
   _imageViewer.InteractiveModes.Add(new ImageViewerAddRegionInteractiveMode 
   { 
      IsEnabled = true, 
      Shape = ImageViewerRubberBandShape.Rectangle 
   }); 
   _imageViewer.InteractiveModes.Add(new ImageViewerFloaterInteractiveMode 
   { 
      ZoomKeyModifier = Keys.None, 
      IsEnabled = true, 
      FloaterOpacity = 0.5 
   }); 
   _imageViewer.InteractiveModes.EnableByIndex(0); 
   _imageViewer.InteractiveModes.EndUpdate(); 
}

Requirements

Target Platforms

Reference

ImageViewerInteractiveModes Class

ImageViewerInteractiveModes 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