Restore SEBPatch

SafeExamBrowser.UserInterface.Contracts/FileSystemDialog/FileSystemDialogResult.cs

@@ -0,0 +1,26 @@
+/*
+ * Copyright (c) 2024 ETH Zürich, IT Services
+ * 
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ */
+
+namespace SafeExamBrowser.UserInterface.Contracts.FileSystemDialog
+{
+	/// <summary>
+	/// Defines the user interaction result of an <see cref="IFileSystemDialog"/>.
+	/// </summary>
+	public class FileSystemDialogResult
+	{
+		/// <summary>
+		/// The full path of the item selected by the user, or <c>null</c> if the interaction was unsuccessful.
+		/// </summary>
+		public string FullPath { get; set; }
+
+		/// <summary>
+		/// Indicates whether the user confirmed the dialog or not.
+		/// </summary>
+		public bool Success { get; set; }
+	}
+}

SafeExamBrowser.UserInterface.Contracts/FileSystemDialog/FileSystemElement.cs

@@ -0,0 +1,26 @@
+/*
+ * Copyright (c) 2024 ETH Zürich, IT Services
+ * 
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ */
+
+namespace SafeExamBrowser.UserInterface.Contracts.FileSystemDialog
+{
+	/// <summary>
+	/// Defines all elements supported by an <see cref="IFileSystemDialog"/>
+	/// </summary>
+	public enum FileSystemElement
+	{
+		/// <summary>
+		/// A dialog to perform an operation with a file.
+		/// </summary>
+		File,
+
+		/// <summary>
+		/// A dialog to perform an operation with a folder.
+		/// </summary>
+		Folder
+	}
+}

SafeExamBrowser.UserInterface.Contracts/FileSystemDialog/FileSystemOperation.cs

@@ -0,0 +1,26 @@
+/*
+ * Copyright (c) 2024 ETH Zürich, IT Services
+ * 
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ */
+
+namespace SafeExamBrowser.UserInterface.Contracts.FileSystemDialog
+{
+	/// <summary>
+	/// Defines all operations supported by an <see cref="IFileSystemDialog"/>
+	/// </summary>
+	public enum FileSystemOperation
+	{
+		/// <summary>
+		/// A dialog to open a file system element.
+		/// </summary>
+		Open,
+
+		/// <summary>
+		/// A dialog to save a file system element.
+		/// </summary>
+		Save
+	}
+}

SafeExamBrowser.UserInterface.Contracts/FileSystemDialog/IFileSystemDialog.cs

@@ -0,0 +1,28 @@
+/*
+ * Copyright (c) 2024 ETH Zürich, IT Services
+ * 
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ */
+
+using SafeExamBrowser.UserInterface.Contracts.Windows;
+
+namespace SafeExamBrowser.UserInterface.Contracts.FileSystemDialog
+{
+	public interface IFileSystemDialog
+	{
+		/// <summary>
+		/// Creates a dialog according to the given parameters and shows it to the user.
+		/// </summary>
+		FileSystemDialogResult Show(
+			FileSystemElement element,
+			FileSystemOperation operation,
+			string initialPath = default,
+			string message = default,
+			string title = default,
+			IWindow parent = default,
+			bool restrictNavigation = false,
+			bool showElementPath = true);
+	}
+}