←Select platform

RestrictHiddenScrollMode Property

Summary

Gets or sets a value that indicates whether scrolling or panning the image outside the maximum range is allowed.

Syntax

Java

Objective-C

WinRT C#

public bool RestrictHiddenScrollMode {get; set;}

Public Property RestrictHiddenScrollMode As Boolean

public bool RestrictHiddenScrollMode {get; set;}

@property (nonatomic, assign) BOOL restrictHiddenScrollMode

public boolean getRestrictHiddenScrollMode() 
public void setRestrictHiddenScrollMode(boolean restrict)

get_RestrictHiddenScrollMode(); 
set_RestrictHiddenScrollMode(value); 
Object.defineProperty('RestrictHiddenScrollMode');

Property Value

Changing the value of this property will fire the PropertyChanged and TransformChanged events.

true if scrolling and panning the image outside the maximum range is allowed; otherwise, it is false. Default value is false.

Remarks

The size of the image in the viewer might become larger or smaller than the control size depending on the value of the current transform (ImageSize, ScaleFactor, AspectRatioCorrection, RotateAngle and SizeMode). In this case, the control might be required to show or hide scrollbars and determine how to handle panning.

As in the case of any scrolling model, the value of the current scroll offset and the size of the maximum scroll area should be available to query and change. These are stored in the ScrollOffset and ScrollRange properties of this control.

The value of RestrictHiddenScrollMode determines what to do when the user tries to pan the image outside the maximum scroll area (ScrollRange). When the value of RestrictHiddenScrollMode is true (the default), the user cannot scroll/pan outside the maximum range. This works just like RestrictHiddenScrollMode.Auto but without visible scrollbars. If the value of RestrictHiddenScrollMode is set to false, then the user is allowed unlimited panning and scrolling, any value in ScrollOffset or ScrollBy can be used (negative values or very large values). This might be useful in some situation like mapping or medical applications.

Note: Changing the value of ScrollMode might affect the value of ScrollOffset. For example, if the scroll mode is ImageViewerScrollMode.Hidden with RestrictHiddenScrollMode set to false and the user has panned the image outside the maximum scrolling area (which is legal in this scenario). If ScrollMode is set to ImageViewerScrollMode.Auto, the scroll offset cannot be outside the maximum scrolling area, and the viewer will change the value of ScrollOffset to the closest legal value for the current mode. This is also applicable when the user changes the value of RestrictHiddenScrollMode from false back to true.

Example

WinRT C#

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.Controls; 
 
public void RestrictHiddenScrollModeExample() 
{ 
   // Set DefaultInteractiveMode property to ImageViewerPanZoomInteractiveMode to see the example effect 
   ImageViewerPanZoomInteractiveMode panZoomMode = new ImageViewerPanZoomInteractiveMode(); 
   _viewer.DefaultInteractiveMode = panZoomMode; 
   // Set the scroll mode to hidden 
   _viewer.ScrollMode = ImageViewerScrollMode.Hidden; 
 
   // Toggle the RestrictHiddenScrollMode property 
   _viewer.RestrictHiddenScrollMode = !_viewer.RestrictHiddenScrollMode; 
 
   if (_viewer.RestrictHiddenScrollMode) 
   { 
      _infoLabel.Text = "Restricted scrolling, try to pan the image, note that you cannot go outside the boundaries."; 
   } 
   else 
   { 
      _infoLabel.Text = "None-restricted scrolling, try to pan the image, note that you are allowed to go outside the boundaries."; 
   } 
 
   _infoLabel.Text += " Click Example again to toggle the mode"; 
}