RestrictHiddenScrollMode Property

WinRT C#
WinRT JavaScript

public bool RestrictHiddenScrollMode {get; set;}

 get_RestrictHiddenScrollMode();
 set_RestrictHiddenScrollMode(value);

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.

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.

Visual Basic
C#
WinRT C#
WinRT JavaScript
Silverlight C#
Silverlight VB

Copy Code

[TestMethod]
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";
}

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

ImageViewer Class
ImageViewer Members