Adding changes to DocumentViewerDemo sample

Author: Nandhakumar-SF4686

DocumentViewerDemo/FileService.cs

@@ -0,0 +1,48 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using System.Xml.Linq;
+
+namespace DocumentViewerDemo
+{
+    /// <summary>
+    /// Provides the functionality to open and save PDF files. 
+    /// </summary>
+    public partial class FileService
+    {
+        
+        /// <summary>
+        /// Saves the PDF stream with given file name using platform specific file saving APIs. 
+        /// </summary>
+        /// <param name="fileName">The file name with which the PDF needs to be saved.</param>
+        /// <param name="fileStream">The stream of the PDF to be saved.</param>
+        /// <returns></returns>
+        public async static Task<string?> SaveAsAsync(string fileName, Stream fileStream)
+        {
+            return await PlatformSaveAsAsync(fileName, fileStream);
+        }
+
+        /// <summary>
+        /// Writes the given stream to the specified file path.
+        /// </summary>
+        /// <param name="stream">The stream of the PDF file to be written.</param>
+        /// <param name="filePath">The file path to which the PDF file needs to be written.</param>
+        /// <returns></returns>
+        static async Task WriteStream(Stream stream, string? filePath)
+        {
+            if (!string.IsNullOrEmpty(filePath))
+            {
+                await using var fileStream = new FileStream(filePath, FileMode.OpenOrCreate);
+                fileStream.SetLength(0);
+                if (stream.CanSeek)
+                {
+                    stream.Seek(0, SeekOrigin.Begin);
+                }
+
+                await stream.CopyToAsync(fileStream).ConfigureAwait(false);
+            }
+        }
+    }
+}

DocumentViewerDemo/MainPage.xaml

@@ -15,6 +15,7 @@
         <tabView:SfTabView IndicatorBackground="{DynamicResource PrimaryLight}"
                IndicatorPlacement="Bottom"
                TabBarPlacement="Top"
+               TabWidthMode="SizeToContent"
                Loaded="SfTabView_Loaded"
               >
             <tabView:SfTabItem Header="PDF_Succinctly.pdf" x:Name="tab1">
@@ -23,11 +24,11 @@
             </tabView:SfTabItem>
             <tabView:SfTabItem Header="Autumn Leaves.jpg" x:Name="tab3">
             </tabView:SfTabItem>
-            <tabView:SfTabItem Header="InputTemplate.xlsx" x:Name="tab4">
+            <tabView:SfTabItem Header="Template.pptx" x:Name="tab4">
             </tabView:SfTabItem>
-            <tabView:SfTabItem Header="Input.xps" x:Name="tab5">
+            <tabView:SfTabItem Header="InputTemplate.xlsx" x:Name="tab5">
             </tabView:SfTabItem>
-            <tabView:SfTabItem Header="Template.pptx" x:Name="tab6">
+            <tabView:SfTabItem Header="Input.xps" x:Name="tab6">
             </tabView:SfTabItem>
         </tabView:SfTabView>
     </Grid>

DocumentViewerDemo/MainPage.xaml.cs

@@ -1,4 +1,5 @@
-using Syncfusion.Maui.PdfViewer;
+using Syncfusion.Maui.Core;
+using Syncfusion.Maui.PdfViewer;
 
 namespace DocumentViewerDemo
 {
@@ -15,6 +16,12 @@ public MainPage()
         {
             InitializeComponent();
 
+            AddSaveOptionToolbarItems(pdfViewer);
+            AddSaveOptionToolbarItems(pdfViewer1);
+            AddSaveOptionToolbarItems(pdfViewer2);
+            AddSaveOptionToolbarItems(pdfViewer3);
+            AddSaveOptionToolbarItems(pdfViewer4);
+            AddSaveOptionToolbarItems(pdfViewer5);
             // Set the zoom mode of three PDF viewers to fit the width of the container
             pdfViewer.ZoomMode = ZoomMode.FitToWidth;
             pdfViewer1.ZoomMode = ZoomMode.FitToWidth;
@@ -24,8 +31,72 @@ public MainPage()
             pdfViewer5.ZoomMode = ZoomMode.FitToWidth;
         }
 
+        void AddSaveOptionToolbarItems(SfPdfViewer pdfViewer)
+        {
+
+            // Create new save button
+            Button fileSaveButton = new Button
+            {
+                Text = "\ue75f", // Set button text
+                FontSize = 24, // Set button text font size
+                FontFamily = "MauiMaterialAssets", // Set button text font family
+                BackgroundColor = Colors.Transparent, // Set background for the button
+                BorderColor = Colors.Transparent, // Set border color for the button
+                TextColor = Color.FromArgb("#49454F"), // Set button text color
+                CornerRadius = 5 // Set corner radius of the button
+            };
+
+            // Subscription of click event for the save button
+            fileSaveButton.Clicked += FileSaveButton_Clicked;
+
+            // Set the tooltip text on hover
+            ToolTipProperties.SetText(fileSaveButton, "Save");
+
+#if !WINDOWS && !MACCATALYST
+            // Inserting save file option button as toolbar item in the top toolbar for the mobile platform.
+            pdfViewer?.Toolbars?.GetByName("TopToolbar")?.Items?.Insert(1, new Syncfusion.Maui.PdfViewer.ToolbarItem(fileSaveButton, "FileSaveButton"));
+#else
+            // Inserting save file option button as toolbar item in the top toolbar for the desktop platform.
+            pdfViewer?.Toolbars?.GetByName("PrimaryToolbar")?.Items?.Insert(1, new Syncfusion.Maui.PdfViewer.ToolbarItem(fileSaveButton, "FileSaveButton"));
+#endif
+        }
+
+        private async void FileSaveButton_Clicked(object? sender, EventArgs e)
+        {
+            // Create a new memory stream to hold the saved PDF document
+            Stream savedStream = new MemoryStream();
+
+            // Asynchronously save the current document content into the memory stream
+            await pdfViewer.SaveDocumentAsync(savedStream); 
+            
+            try
+            {
+                savedStream.Position = 0;
+
+                // Open the file explorer using the file picker, select a location to save the PDF, save the file to the chosen path, and retrieve the saved file location for display.
+                string? filePath = await FileService.SaveAsAsync("Saved.pdf", savedStream);
+
+                // Safely storing the main page of the application.
+                var mainPage = Application.Current?.Windows[0].Page;
+
+                if (mainPage != null)
+                    // Display the saved file path.
+                    await mainPage.DisplayAlert("File saved", $"The file is saved to {filePath}", "OK");
+            }
+            catch (Exception exception)
+            {
+                // Safely storing the main page of the application.
+                var mainPage = Application.Current?.Windows[0].Page;
+
+                if (mainPage != null)
+                    // Display the error message when the file is not saved.
+                    await mainPage.DisplayAlert("Error", $"The file is not saved. {exception.Message}", "OK");
+            }
+        }
+
         private void SfTabView_Loaded(System.Object sender, System.EventArgs e)
         {
+
             // Ensure the viewModel is not null before proceeding
             if (viewModel?.PDFDocuments != null)
             {
@@ -51,25 +122,25 @@ private void SfTabView_Loaded(System.Object sender, System.EventArgs e)
                 }
 
 
-                // Check if the fourth tab's header matches "InputTemplate.xlsx"
-                if (tab4.Header.Equals("InputTemplate.xlsx"))
+                // Check if the fourth tab's header matches "Template.pptx"
+                if (tab4.Header.Equals("Template.pptx"))
                 {
-                    pdfViewer3.DocumentSource = viewModel.ConvertXlsxToPdf(viewModel.PDFDocuments[3]); // Assign the stream to the "DocumentSource" property of the PdfViewer control
+                    pdfViewer3.DocumentSource = viewModel.ConvertPptToPdf(viewModel.PDFDocuments[3]); // Assign the stream to the "DocumentSource" property of the PdfViewer control
                     tab4.Content = pdfViewer3; // Set the content of tab1 to the pdfViewer1.
                 }
 
 
-                // Check if the fifth tab's header matches "Input.xps"
-                if (tab5.Header.Equals("Input.xps"))
+                // Check if the fifth tab's header matches "InputTemplate.xlsx"
+                if (tab5.Header.Equals("InputTemplate.xlsx"))
                 {
-                    pdfViewer4.DocumentSource = viewModel.ConvertXpsToPdf(viewModel.PDFDocuments[4]); // Assign the stream to the "DocumentSource" property of the PdfViewer control
+                    pdfViewer4.DocumentSource = viewModel.ConvertXlsxToPdf(viewModel.PDFDocuments[4]); // Assign the stream to the "DocumentSource" property of the PdfViewer control
                     tab5.Content = pdfViewer4; // Set the content of tab1 to the pdfViewer1.
                 }
 
-                // Check if the sixth tab's header matches "Template.pptx"
-                if (tab6.Header.Equals("Template.pptx"))
+                // Check if the sixth tab's header matches "Input.xps"
+                if (tab6.Header.Equals("Input.xps"))
                 {
-                    pdfViewer5.DocumentSource = viewModel.ConvertPptToPdf(viewModel.PDFDocuments[5]); // Assign the stream to the "DocumentSource" property of the PdfViewer control
+                    pdfViewer5.DocumentSource = viewModel.ConvertXpsToPdf(viewModel.PDFDocuments[5]); // Assign the stream to the "DocumentSource" property of the PdfViewer control
                     tab6.Content = pdfViewer5; // Set the content of tab1 to the pdfViewer1.
                 }
             }

DocumentViewerDemo/Platforms/Android/AndroidDirectoryConstants.cs

@@ -0,0 +1,9 @@
+namespace DocumentViewerDemo
+{
+    static class AndroidDirectoryConstants
+    {
+        public const string PrimaryStorage = "primary";
+        public const string Storage = "storage";
+        public const string ExternalStorageBaseUrl = "content://com.android.externalstorage.documents/document/primary%3A";
+    }
+}

DocumentViewerDemo/Platforms/Android/FileService.android.cs

@@ -0,0 +1,102 @@
+using Uri = Android.Net.Uri;
+using Application = Android.App.Application;
+using Environment = Android.OS.Environment;
+using Android.Content;
+using Android.Webkit;
+using Android.Provider;
+using System.Web;
+using Java.IO;
+
+namespace DocumentViewerDemo
+{
+    public partial class FileService
+    {
+        internal static async Task<string?> PlatformSaveAsAsync(string fileName, Stream stream)
+        {
+            Uri? filePath = null;
+            CancellationToken cancellationToken = CancellationToken.None;
+
+            if (!OperatingSystem.IsAndroidVersionAtLeast(33))
+            {
+                var status = await Permissions.RequestAsync<Permissions.StorageWrite>().WaitAsync(cancellationToken).ConfigureAwait(false);
+                if (status is not PermissionStatus.Granted)
+                {
+                    throw new PermissionException("Storage permission is not granted.");
+                }
+            }
+
+            var intent = new Intent(Intent.ActionCreateDocument);
+
+            intent.AddCategory(Intent.CategoryOpenable);
+            intent.SetType(MimeTypeMap.Singleton?.GetMimeTypeFromExtension(MimeTypeMap.GetFileExtensionFromUrl(fileName)) ?? "application/pdf");
+            intent.PutExtra(Intent.ExtraTitle, fileName);
+            await IntermediateActivity.StartAsync(intent, 2001, onResult: OnResult).WaitAsync(cancellationToken).ConfigureAwait(false);
+
+            if (filePath is null)
+            {
+                throw new Exception("User canceled or error in saving.");
+            }
+
+            return await SaveDocument(filePath, stream, cancellationToken).ConfigureAwait(false);
+
+            void OnResult(Intent resultIntent)
+            {
+                filePath = resultIntent.Data;
+            }
+        }
+
+        static async Task<string?> SaveDocument(Uri uri, Stream stream, CancellationToken cancellationToken)
+        {
+            using var parcelFileDescriptor = Application.Context.ContentResolver?.OpenFileDescriptor(uri, "wt");
+            using var fileOutputStream = new FileOutputStream(parcelFileDescriptor?.FileDescriptor);
+            await using var memoryStream = new MemoryStream();
+            await stream.CopyToAsync(memoryStream, cancellationToken).ConfigureAwait(false);
+            await fileOutputStream.WriteAsync(memoryStream.ToArray()).WaitAsync(cancellationToken).ConfigureAwait(false);
+
+            return ConvertToPhysicalPath(uri);
+        }
+
+        static string? ConvertToPhysicalPath(Uri uri)
+        {
+            const string uriSchemeFolder = "content";
+            if (uri.Scheme is null || !uri.Scheme.Equals(uriSchemeFolder, StringComparison.OrdinalIgnoreCase))
+            {
+                return null;
+            }
+
+            if (uri.PathSegments?.Count < 2)
+            {
+                return null;
+            }
+
+            // Example path would be /tree/primary:DCIM, or /tree/SDCare:DCIM
+            var path = uri.PathSegments?[1];
+
+            if (path is null)
+            {
+                return null;
+            }
+
+            var pathSplit = path.Split(':');
+            if (pathSplit.Length < 2)
+            {
+                if (pathSplit.Length == 1)
+                {
+                    //If there is no `:` in the path, assume it's a top-level directory like Downloads
+                    return $"{Environment.ExternalStorageDirectory?.Path}/Downloads";
+                }
+                return null;
+            }
+
+            // Primary is the device's internal storage, and anything else is an SD card or other external storage
+            if (pathSplit[0].Equals(AndroidDirectoryConstants.PrimaryStorage, StringComparison.OrdinalIgnoreCase))
+            {
+                // Example for internal path /storage/emulated/0/DCIM
+                return $"{Environment.ExternalStorageDirectory?.Path}/{pathSplit[1]}";
+            }
+
+            // Example for external path /storage/1B0B-0B1C/DCIM
+            return $"/{AndroidDirectoryConstants.Storage}/{pathSplit[0]}/{pathSplit[1]}";
+        }
+    }
+}