From 5d2f7027c2aa6000ff0b2bd84c828bcfe7b3c258 Mon Sep 17 00:00:00 2001 From: ushasundarajan Date: Fri, 24 Apr 2026 18:31:36 +0530 Subject: [PATCH 1/9] 1019701 - Created and Updated UG for Magnifier Control --- wpf/Magnifier/Advance_features.md | 323 ++++++++++++++++++ wpf/Magnifier/Appearance-and-Styling.md | 239 +++++++++++++ wpf/Magnifier/Exporting-Feature.md | 199 +++++++++++ wpf/Magnifier/Getting-Started.md | 148 ++++++++ wpf/Magnifier/Overview.md | 33 ++ wpf/Magnifier/images/exported_images.png | Bin 0 -> 19962 bytes ...agnifier_active_vs_inactive_comparison.png | Bin 0 -> 70926 bytes .../videos/CommonStylingScenarios.gif | Bin 0 -> 1519721 bytes .../videos/FrameBackground_Styles.gif | Bin 0 -> 1327528 bytes wpf/Magnifier/videos/FrameTypes_Demo.gif | Bin 0 -> 476804 bytes .../videos/Magnifier_Demonstration.gif | Bin 0 -> 1092693 bytes wpf/Magnifier/videos/zooming_features.gif | Bin 0 -> 2496740 bytes 12 files changed, 942 insertions(+) create mode 100644 wpf/Magnifier/Advance_features.md create mode 100644 wpf/Magnifier/Appearance-and-Styling.md create mode 100644 wpf/Magnifier/Exporting-Feature.md create mode 100644 wpf/Magnifier/Getting-Started.md create mode 100644 wpf/Magnifier/Overview.md create mode 100644 wpf/Magnifier/images/exported_images.png create mode 100644 wpf/Magnifier/images/magnifier_active_vs_inactive_comparison.png create mode 100644 wpf/Magnifier/videos/CommonStylingScenarios.gif create mode 100644 wpf/Magnifier/videos/FrameBackground_Styles.gif create mode 100644 wpf/Magnifier/videos/FrameTypes_Demo.gif create mode 100644 wpf/Magnifier/videos/Magnifier_Demonstration.gif create mode 100644 wpf/Magnifier/videos/zooming_features.gif diff --git a/wpf/Magnifier/Advance_features.md b/wpf/Magnifier/Advance_features.md new file mode 100644 index 0000000000..08cfe3af88 --- /dev/null +++ b/wpf/Magnifier/Advance_features.md @@ -0,0 +1,323 @@ +--- +layout: post +title: Zoom Control in WPF Magnifier | Syncfusion® +description: Learn how to control zoom levels programmatically using ZoomIn, ZoomOut methods and ZoomFactor property in the WPF Magnifier control. +platform: wpf +control: Magnifier +documentation: ug +--- +## Zooming + +The Magnifier control provides flexible zooming through the [`ZoomFactor`](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Shared.Magnifier.html#Syncfusion_Windows_Shared_Magnifier_ZoomFactor) property and programmatic methods. You can configure zoom levels declaratively or adjust them dynamically at runtime. + +## ZoomFactor Property + +The `ZoomFactor` property determines the relative size of the area displayed inside the magnifier frame. It controls the magnification level and accepts values between `0.0` and `1.0`. + +### Understanding ZoomFactor Values + +* **Lower values** (e.g., `0.2`) = **Higher magnification** (smaller area shown, more zoomed in) +* **Higher values** (e.g., `0.8`) = **Lower magnification** (larger area shown, less zoomed in) +* **Value of `1.0`** = **No magnification** (content shown at original size) + +The ZoomFactor property is automatically coerced to the valid range: +* Values greater than `1.0` are set to `1.0` +* Values less than `0.0` are set to `0.0` + +### Setting ZoomFactor Declaratively + +**XAML:** + +```xml + + + +``` + +**C#:** + +```csharp +var magnifier = new Magnifier +{ + ZoomFactor = 0.3, + FrameType = FrameType.Circle, + FrameRadius = 120 +}; +``` + +## Programmatic Zoom Control + +The Magnifier control provides [`ZoomIn()`](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Shared.Magnifier.html#Syncfusion_Windows_Shared_Magnifier_ZoomIn_System_Double_) and [`ZoomOut()`](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Shared.Magnifier.html#Syncfusion_Windows_Shared_Magnifier_ZoomOut_System_Double_) methods to adjust zoom levels dynamically at runtime. + +### ZoomIn Method + +The `ZoomIn(double zoomFactor)` method increases magnification by dividing the current `ZoomFactor` by the specified factor. + +**Signature:** +```csharp +public void ZoomIn(double zoomFactor) +``` + +**Example:** +```csharp +// Current ZoomFactor = 0.4 +magnifier.ZoomIn(2.0); +// New ZoomFactor = 0.4 / 2.0 = 0.2 (higher magnification) +``` + +### ZoomOut Method + +The `ZoomOut(double zoomFactor)` method decreases magnification by multiplying the current `ZoomFactor` by the specified factor. + +**Signature:** +```csharp +public void ZoomOut(double zoomFactor) +``` + +**Example:** +```csharp +// Current ZoomFactor = 0.2 +magnifier.ZoomOut(2.0); +// New ZoomFactor = 0.2 * 2.0 = 0.4 (lower magnification) +``` + +## Implementing Zoom Controls + +### Zoom Buttons Example + +Add zoom in/out buttons to your application for user-controlled magnification. + +**XAML:** + +```xml + + + + + + + + + + +