ZoomSnapPoints Property

ZoomSnapPoints

Gets a group of zoom factor, when zoom ending, the result zoom factor will try to snap to a zoom factor in this group.

Declaration

public List<float> ZoomSnapPoints { get; }

Public ReadOnly Property ZoomSnapPoints As List(Of Single)

Property Value

Type	Description
List<float>	A float value list that represents a group of zoom factor, when zoom ending, the result zoom factor will try to snap to a zoom factor in this group.

Remarks

This property only take effect when ZoomPreviewMode property value is ZoomPreviewMode.Bitmap and ZoomPreviewMode.AlternativeContent.

Examples

The following code example shows how to use this property.

public class GcZoomSnapPointDemo : Form
{
	private TextBox _zoomSnapTextBox;
	private GcZoom _gcZoom1 = new GcZoom();

	public GcZoomSnapPointDemo()
	{
		InitializeComponent();

		_gcZoom1.Target = this;

		// ZoomSnapPoints and ZoomSnapDistance property only take effect when  ZoomPreviewMode 
		// property value is ZoomPreviewMode.Bitmap or ZoomPreviewMode.AlternativeContent
		this._gcZoom1.ZoomPreviewMode = ZoomPreviewMode.Bitmap;

		_gcZoom1.ZoomSnapPoints.Add(1f);
		_gcZoom1.ZoomSnapPoints.Add(1.25f);
		_gcZoom1.ZoomSnapPoints.Add(1.5f);
		_gcZoom1.ZoomSnapPoints.Add(1.75f);
		_gcZoom1.ZoomSnapPoints.Add(2f);

		_gcZoom1.ZoomSnapDistance = 0.25f;

		_gcZoom1.ZoomFactorChanged += _gcZoom1_ZoomFactorChanged;
	}

	void _gcZoom1_ZoomFactorChanged(object sender, EventArgs e)
	{
		_zoomSnapTextBox.Text = _gcZoom1.ZoomFactor.ToString();
	}

	private void InitializeComponent()
	{
		_zoomSnapTextBox = new TextBox();
		_zoomSnapTextBox.Location = new Point(100, 100);
		this.Controls.Add(_zoomSnapTextBox);
	}
}

Public Class GcZoomSnapPointDemo
	Inherits Form
	Private _zoomSnapTextBox As TextBox
	Private _gcZoom1 As New GcZoom()

	Public Sub New()
		InitializeComponent()

		_gcZoom1.Target = Me

		' ZoomSnapPoints and ZoomSnapDistance property only take effect when  ZoomPreviewMode 
		' property value is ZoomPreviewMode.Bitmap or ZoomPreviewMode.AlternativeContent
		Me._gcZoom1.ZoomPreviewMode = ZoomPreviewMode.Bitmap

		_gcZoom1.ZoomSnapPoints.Add(1.0F)
		_gcZoom1.ZoomSnapPoints.Add(1.25F)
		_gcZoom1.ZoomSnapPoints.Add(1.5F)
		_gcZoom1.ZoomSnapPoints.Add(1.75F)
		_gcZoom1.ZoomSnapPoints.Add(2.0F)

		_gcZoom1.ZoomSnapDistance = 0.25F

		AddHandler _gcZoom1.ZoomFactorChanged, AddressOf _gcZoom1_ZoomFactorChanged
	End Sub

	Private Sub _gcZoom1_ZoomFactorChanged(sender As Object, e As EventArgs)
		_zoomSnapTextBox.Text = _gcZoom1.ZoomFactor.ToString()
	End Sub

	Private Sub InitializeComponent()
		_zoomSnapTextBox = New TextBox()
		_zoomSnapTextBox.Location = New Point(100, 100)
		Me.Controls.Add(_zoomSnapTextBox)
	End Sub
End Class