Restore SEBPatch

SafeExamBrowser.Browser.Contracts/IBrowserApplication.cs

@@ -0,0 +1,45 @@
+/*
+ * 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.Applications.Contracts;
+using SafeExamBrowser.Browser.Contracts.Events;
+
+namespace SafeExamBrowser.Browser.Contracts
+{
+	/// <summary>
+	/// Controls the lifetime and functionality of the browser application.
+	/// </summary>
+	public interface IBrowserApplication : IApplication<IBrowserWindow>
+	{
+		/// <summary>
+		/// Event fired when the browser application detects a download request for an application configuration file.
+		/// </summary>
+		event DownloadRequestedEventHandler ConfigurationDownloadRequested;
+
+		/// <summary>
+		/// Event fired when the user tries to focus the taskbar.
+		/// </summary>
+		event LoseFocusRequestedEventHandler LoseFocusRequested;
+
+		/// <summary>
+		/// Event fired when the browser application detects a request to terminate SEB.
+		/// </summary>
+		event TerminationRequestedEventHandler TerminationRequested;
+
+		/// <summary>
+		/// Event fired when the browser application detects a user identifier of an LMS.
+		/// </summary>
+		event UserIdentifierDetectedEventHandler UserIdentifierDetected;
+
+		/// <summary>
+		/// Transfers the focus to the browser application. If the parameter is <c>true</c>, the first focusable element in the browser window
+		/// receives focus (passing forward of focus). Otherwise, the last element receives focus.
+		/// </summary>
+		void Focus(bool forward);
+	}
+}