PdfViewer updates (#1258)

* Refactor PdfViewer zoom percentage enum and method

Replaced PdfViewerManualZoomPercentage with PdfViewerZoomPercentage enum. Renamed SetManualZoomPercentage to SetZoomPercentage and updated usage. Improved variable handling and added null-checks in PdfViewer.razor.cs.

* Add PdfViewer zoom enum and improve API documentation

Updated PdfViewer docs to include Methods and Zoom enum tables.
Renamed SetZoomPercentage to SetZoomPercentageAsync with full XML docs and attributes.
Introduced PdfViewerZoomPercentage enum with annotated zoom levels for clearer API usage.

Author: gvreddy04

BlazorBootstrap.Demo.RCL/Components/Pages/Docs/PdfViewer/PdfViewer_Doc_01_Documentation.razor

@@ -18,10 +18,18 @@
     <DocxTable TItem="PdfViewer" DocType="DocType.Parameters" />
 </Section>
 
+<Section Class="p-0" Size="HeadingSize.H3" Name="Methods" PageUrl="@pageUrl" Link="methods">
+    <DocxTable TItem="PdfViewer" DocType="DocType.Methods" />
+</Section>
+
 <Section Class="p-0" Size="HeadingSize.H3" Name="Events" PageUrl="@pageUrl" Link="events">
     <DocxTable TItem="PdfViewer" DocType="DocType.Events" />
 </Section>
 
+<Section Class="p-0" Size="HeadingSize.H3" Name="PdfViewerZoomPercentage Enum" PageUrl="@pageUrl" Link="pdf-viewer-zoom-percentage-enum">
+    <DocxTable TItem="PdfViewerZoomPercentage" DocType="DocType.Enum" />
+</Section>
+
 @code {
     private const string componentName = nameof(PdfViewer);
     private const string pageUrl = DemoRouteConstants.Docs_URL_PDFViewer;

blazorbootstrap/Components/PdfViewer/PdfViewer.razor.cs

@@ -59,14 +59,25 @@ protected override async Task OnParametersSetAsync()
         await base.OnParametersSetAsync();
     }
 
-    public async Task SetManualZoomPercentage(PdfViewerManualZoomPercentage manualZoomPercentage)
+    /// <summary>
+    /// Asynchronously sets the zoom level of the PDF viewer to the specified percentage.
+    /// </summary>
+    /// <remarks>The zoom percentage is converted to a scale factor for rendering the PDF document. Ensure
+    /// that the provided zoom percentage is within valid bounds to avoid unexpected display behavior.</remarks>
+    /// <param name="zoomPercentage">The desired zoom percentage to apply to the PDF viewer. Must be a valid value defined by the
+    /// PdfViewerZoomPercentage enumeration.</param>
+    /// <returns>A task that represents the asynchronous operation of updating the zoom level.</returns>
+    [AddedVersion("4.0.0")]
+    [Description("Asynchronously sets the zoom level of the PDF viewer to the specified percentage.")]
+    public async Task SetZoomPercentageAsync(PdfViewerZoomPercentage zoomPercentage)
     {
-        zoomLevel = (int)manualZoomPercentage;
+        zoomLevel = (int)zoomPercentage;
         var zp = GetZoomPercentage(zoomLevel);
-        zoomPercentage = $"{zp}%";
+        this.zoomPercentage = $"{zp}%";
         scale = 0.01 * zp;
-        await PdfViewerJsInterop.ZoomInOutAsync(objRef!, Id!, scale);
+        await PdfViewerJsInterop!.ZoomInOutAsync(objRef!, Id!, scale);
     }
+
     [JSInvokable]
     public void DocumentLoaded(PdfViewerModel pdfViewerModel)
     {

blazorbootstrap/Enums/PdfViewerManualZoomPercentage.cs

@@ -0,0 +1,128 @@
+namespace BlazorBootstrap;
+
+/// <summary>
+/// Defines the available zoom percentages for the PDF viewer.
+/// </summary>
+[AddedVersion("4.0.0")]
+[Description("Defines the available zoom percentages for the PDF viewer.")]
+public enum PdfViewerZoomPercentage
+{
+    /// <summary>
+    /// Zoom to 25%.
+    /// </summary>
+    [AddedVersion("4.0.0")]
+    [Description("Zoom to 25%.")]
+    x25Percent = 1,
+
+    /// <summary>
+    /// Zoom to 33%.
+    /// </summary>
+    [AddedVersion("4.0.0")]
+    [Description("Zoom to 33%.")]
+    x33Percent,
+
+    /// <summary>
+    /// Zoom to 50%.
+    /// </summary>
+    [AddedVersion("4.0.0")]
+    [Description("Zoom to 50%.")]
+    x50Percent,
+
+    /// <summary>
+    /// Zoom to 67%.
+    /// </summary>
+    [AddedVersion("4.0.0")]
+    [Description("Zoom to 67%.")]
+    x67Percent,
+
+    /// <summary>
+    /// Zoom to 75%.
+    /// </summary>
+    [AddedVersion("4.0.0")]
+    [Description("Zoom to 75%.")]
+    x75Percent,
+
+    /// <summary>
+    /// Zoom to 80%.
+    /// </summary>
+    [AddedVersion("4.0.0")]
+    [Description("Zoom to 80%.")]
+    x80Percent,
+
+    /// <summary>
+    /// Zoom to 90%.
+    /// </summary>
+    [AddedVersion("4.0.0")]
+    [Description("Zoom to 90%.")]
+    x90Percent,
+
+    /// <summary>
+    /// Zoom to 100%.
+    /// </summary>
+    [AddedVersion("4.0.0")]
+    [Description("Zoom to 100%.")]
+    x100Percent,
+
+    /// <summary>
+    /// Zoom to 110%.
+    /// </summary>
+    [AddedVersion("4.0.0")]
+    [Description("Zoom to 110%.")]
+    x110Percent,
+
+    /// <summary>
+    /// Zoom to 125%.
+    /// </summary>
+    [AddedVersion("4.0.0")]
+    [Description("Zoom to 125%.")]
+    x125Percent,
+
+    /// <summary>
+    /// Zoom to 150%.
+    /// </summary>
+    [AddedVersion("4.0.0")]
+    [Description("Zoom to 150%.")]
+    x150Percent,
+
+    /// <summary>
+    /// Zoom to 175%.
+    /// </summary>
+    [AddedVersion("4.0.0")]
+    [Description("Zoom to 175%.")]
+    x175Percent,
+
+    /// <summary>
+    /// Zoom to 200%.
+    /// </summary>
+    [AddedVersion("4.0.0")]
+    [Description("Zoom to 200%.")]
+    x200Percent,
+
+    /// <summary>
+    /// Zoom to 250%.
+    /// </summary>
+    [AddedVersion("4.0.0")]
+    [Description("Zoom to 250%.")]
+    x250Percent,
+
+    /// <summary>
+    /// Zoom to 300%.
+    /// </summary>
+    [AddedVersion("4.0.0")]
+    [Description("Zoom to 300%.")]
+    x300Percent,
+
+    /// <summary>
+    /// Zoom to 400%.
+    /// </summary>
+    [AddedVersion("4.0.0")]
+    [Description("Zoom to 400%.")]
+    x400Percent,
+
+    /// <summary>
+    /// Zoom to 500%.
+    /// </summary>
+    [AddedVersion("4.0.0")]
+    [Description("Zoom to 500%.")]
+    x500Percent
+}