ZoomPanelNavigator Class

ZoomPanelNavigator control can be used to control the ZoomPanel with buttons to move around and with slider to control the ZoomFactor.

Inheritance Hierarchy

SystemObject
  System.Windows.ThreadingDispatcherObject
    System.WindowsDependencyObject
      System.Windows.MediaVisual
        System.WindowsUIElement
          System.WindowsFrameworkElement
            System.Windows.ControlsControl
              Ab2d.ControlsZoomPanelNavigator

Namespace: Ab2d.Controls
Assembly: Ab2d.Controls.ZoomPanel (in Ab2d.Controls.ZoomPanel.dll) Version: 5.2.6631.1040

Syntax

Copy

public class ZoomPanelNavigator : Control

The ZoomPanelNavigator type exposes the following members.

Constructors

	Name	Description
	ZoomPanelNavigator	Constructor

Top

Properties

	Name	Description
	IsAutoZoomPanelFindingEnabled	Gets or sets a Boolean which specifies that if TargetZoomPanel or TargetZoomPanelName properties are not manually set the first ZoomPanel is automatically found from the current UserControl, Page or Window. Default value is true.
	IsSnapToTickEnabled	Gets or sets a boolean that specifies if snapping to specific ZoomFactor values is enabled.
	IsZoomPanelLimitedToMinMaxZoomFactors	Gets or sets a boolean that specifies if the ZoomPanel is limited to the MinZoomFactor and MaxZoomFactor values.
	MaxZoomFactor	Gets or sets a double that specifies the maximum ZoomFactor value.
	MinZoomFactor	Gets or sets a double that specifies the minimum ZoomFactor value.
	NavigationCircleVisibility	Gets or sets a Visibility of the used NavigationCircle.
	NavigationSliderVisibility	Gets or sets a Visibility of the used NavigationSlider.
	Orientation	Gets or sets the orientation of a ZoomPanelNavigator. Default value is Vertical.
	TargetZoomPanel	Gets or sets the ZoomPanel control that is controlled by this ZoomPanelNavigator.
	TargetZoomPanelName	Gets or sets the name of the ZoomPanel that is controls with this ZoomPanelNavigator.
	UsedNavigationCircle	Used NavigationCircle control.
	UsedNavigationSlider	Used NavigationSlider control.
	ZoomFactor	Gets or sets the ZoomFactor that is applied to ZoomPanel.

Top

Methods

	Name	Description
	OnApplyTemplate	OnApplyTemplate (Overrides FrameworkElementOnApplyTemplate.)

Top

Events

	Name	Description
	NavigatorSliderValueChanged	NavigatorSliderValueChanged occurs when navigation slider value is changed by the user. The event handler can also change the proposed ZoomFactor value.

Top

Fields

	Name	Description
	CalculateSliderValueFromZoomFactor	Callback method that can be used to provide custom calculation of slider value from ZoomFactor.
	CalculateZoomFactorFromSliderValue	Callback method that can be used to provide custom calculation of ZoomFactor from slider value.
	IsAutoZoomPanelFindingEnabledProperty	IsAutoZoomPanelFindingEnabledProperty
	IsSnapToTickEnabledProperty	IsSnapToTickEnabledProperty
	IsZoomPanelLimitedToMinMaxZoomFactorsProperty	IsZoomPanelLimitedToMinMaxZoomFactorsProperty
	MaxZoomFactorProperty	MaxZoomFactorProperty
	MinZoomFactorProperty	MinZoomFactorProperty
	NavigationCircleVisibilityProperty	NavigationCircleVisibilityProperty
	NavigationSliderVisibilityProperty	NavigationSliderVisibilityProperty
	NavigatorSliderValueChangedEvent	NavigatorSliderValueChanged RoutedEvent
	OrientationProperty	OrientationProperty
	TargetZoomPanelNameProperty	TargetZoomPanelNameProperty
	TargetZoomPanelProperty	ViewboxExProperty
	ZoomFactorProperty	ZoomFactorProperty

Top

Remarks

ZoomPanelNavigator control can be used to control the ZoomPanel with buttons to move around and with slider to control the ZoomFactor.

The ZoomPanelNavigator is using the NavigationCircle and NavigationSlider controls. The used controls can be accessed by UsedNavigationCircle and UsedNavigationSlider properties.

ZoomPanelNavigator must be connected to a ZoomPanel to control it. The ZoomPanel can be automatically discovered in the current Window or Page. But if there are more ZoomPanels defined or you would like to explicitly set the ZoomPanel, TargetZoomPanelName or TargetZoomPanel can be used to connect ZoomPanelNavigator with the specific ZoomPanel. To disable the automatic discovery of ZoomPanel the IsAutoZoomPanelFindingEnabled property can be set to false.

The level of zoom that is applied to ZoomPanel is controlled by the ZoomFactor property. The minimum and maximum values of the ZoomFactor are set by MinZoomFactor and MaxZoomFactor.

With NavigationCircleVisibility and NavigationSliderVisibility it is possible to control the visibility of used NavigationCircle and NavigationSlider. With Orientation it is possible to set the orientation of the controls.

Color customization:

By default the control is created from gradients of gray. When the mouse is over button the button is colored with gradients of orange.

It is possible to customize the colors of the control with SetSelectedColor or SetMainColors methods. The first method define the colors that are used to select the buttons when the mouse is over the button. The second method also sets all other colors and can be used to completely change the colors used for the control.

It is also possible to provide your own ResourceDictionary with custom colors and brushes. See samples that come with the control for more.

Reference

Ab2d.Controls Namespace