src/Files.App/Utils/Storage/Helpers/FilePropertiesHelpers.cs - main - githubmirror/Files

src/Files.App/Utils/Storage/Helpers/FilePropertiesHelpers.cs
194 строки6 KB
seer-by-sentry[bot]
Code Quality: Ensure minimum size for UI elements based on DPI scaling (#17462)
18 авг 2025, 17:35
18 авг 2025, 17:354c20201
// Copyright (c) Files Community
// Licensed under the MIT License.

using Files.App.Views.Properties;
using Microsoft.UI;
using Microsoft.UI.Windowing;
using Microsoft.UI.Xaml;
using Microsoft.UI.Xaml.Controls;
using Microsoft.UI.Xaml.Media.Animation;
using System.Collections.Concurrent;
using Windows.Graphics;
using Windows.Win32;

namespace Files.App.Utils.Storage
{
	/// <summary>
	/// Represents a helper class that helps users open and handle item properties window
	/// </summary>
	public static class FilePropertiesHelpers
	{
		private static IAppThemeModeService AppThemeModeService { get; } = Ioc.Default.GetRequiredService<IAppThemeModeService>();

		/// <summary>
		/// Get window handle (hWnd) of the given properties window instance
		/// </summary>
		/// <param name="w">Window instance</param>
		/// <returns></returns>
		public static nint GetWindowHandle(Window w)
			=> WinRT.Interop.WindowNative.GetWindowHandle(w);

		private static TaskCompletionSource? PropertiesWindowsClosingTCS;
		private static readonly BlockingCollection<WindowEx> WindowCache = [];

		/// <summary>
		/// Open properties window
		/// </summary>
		/// <param name="associatedInstance">Associated main window instance</param>
		public static void OpenPropertiesWindow(IShellPage associatedInstance)
		{
			if (associatedInstance is null)
				return;

			object item;

			var page = associatedInstance.SlimContentPage;

			// Item(s) selected
			if (page is not null && page.IsItemSelected)
			{
				// Selected item(s)
				item = page.SelectedItems?.Count is 1
					? page.SelectedItem!
					: page.SelectedItems!;
			}
			// No items selected
			else
			{
				// Instance's current folder
				var folder = associatedInstance.ShellViewModel?.CurrentFolder;
				if (folder is null)
					return;

				item = folder;

				var drivesViewModel = Ioc.Default.GetRequiredService<DrivesViewModel>();
				var drives = drivesViewModel.Drives;
				foreach (var drive in drives)
				{
					// Current folder is drive
					if (drive.Id.Equals(folder.ItemPath))
					{
						item = drive;
						break;
					}
				}
			}

			OpenPropertiesWindow(item, associatedInstance);
		}

		/// <summary>
		/// Open properties window with an explicitly specified item
		/// </summary>
		/// <param name="item">An item to view properties</param>
		/// <param name="associatedInstance">Associated main window instance</param>
		/// <param name="defaultPage">The page to show when opening the window</param>
		public static void OpenPropertiesWindow(object item, IShellPage associatedInstance, PropertiesNavigationViewItemType defaultPage = PropertiesNavigationViewItemType.General)
		{
			if (item is null)
				return;

			var frame = new Frame
			{
				RequestedTheme = AppThemeModeService.AppThemeMode
			};

			if (!WindowCache.TryTake(out var propertiesWindow))
			{
				propertiesWindow = new(460, 550);
				propertiesWindow.Closed += PropertiesWindow_Closed;
			}

			var width = Math.Max(1, Convert.ToInt32(800 * App.AppModel.AppWindowDPI));
			var height = Math.Max(1, Convert.ToInt32(500 * App.AppModel.AppWindowDPI));

			propertiesWindow.AppWindow.Resize(new(width, height));
			propertiesWindow.IsMinimizable = false;
			propertiesWindow.IsMaximizable = false;
			propertiesWindow.Content = frame;
			propertiesWindow.SystemBackdrop = new AppSystemBackdrop(true);

			var appWindow = propertiesWindow.AppWindow;
			appWindow.Title = Strings.Properties.GetLocalizedResource();
			appWindow.TitleBar.ExtendsContentIntoTitleBar = true;
			appWindow.TitleBar.ButtonBackgroundColor = Colors.Transparent;
			appWindow.TitleBar.ButtonInactiveBackgroundColor = Colors.Transparent;

			appWindow.SetIcon(AppLifecycleHelper.AppIconPath);

			frame.Navigate(
				typeof(MainPropertiesPage),
				new PropertiesPageNavigationParameter
				{
					Parameter = item,
					AppInstance = associatedInstance,
					Window = propertiesWindow
				},
				new SuppressNavigationTransitionInfo());

			// WINUI3: Move window to cursor position
			PInvoke.GetCursorPos(out var pointerPosition);
			var displayArea = DisplayArea.GetFromPoint(new PointInt32(pointerPosition.X, pointerPosition.Y), DisplayAreaFallback.Nearest);
			var appWindowPos = new PointInt32
			{
				X = displayArea.WorkArea.X
					+ Math.Max(0, Math.Min(displayArea.WorkArea.Width - appWindow.Size.Width, pointerPosition.X - displayArea.WorkArea.X)),
				Y = displayArea.WorkArea.Y
					+ Math.Max(0, Math.Min(displayArea.WorkArea.Height - appWindow.Size.Height, pointerPosition.Y - displayArea.WorkArea.Y)),
			};

			if (App.AppModel.IncrementPropertiesWindowCount() == 1)
				PropertiesWindowsClosingTCS = new();

			appWindow.Move(appWindowPos);
			appWindow.Show();

			(frame.Content as MainPropertiesPage)?.TryNavigateToPage(defaultPage);
		}

		// Destruction of Window objects seems to cause access violation. (#12057)
		// So instead of destroying the Window object, cache it and reuse it as a workaround.
		private static void PropertiesWindow_Closed(object sender, WindowEventArgs args)
		{
			if (!App.AppModel.IsMainWindowClosed && sender is WindowEx window)
			{
				args.Handled = true;

				window.AppWindow.Hide();
				window.Content = null;
				WindowCache.Add(window);

				if (App.AppModel.DecrementPropertiesWindowCount() == 0)
				{
					PropertiesWindowsClosingTCS!.TrySetResult();
					PropertiesWindowsClosingTCS = null;
				}
			}
			else
				App.AppModel.DecrementPropertiesWindowCount();
		}

		/// <summary>
		/// Destroy all cached properties windows
		/// </summary>
		/// <returns></returns>
		public static void DestroyCachedWindows()
		{
			while (WindowCache?.TryTake(out var window) ?? false)
			{
				if (window is null)
					continue;

				window.Closed -= PropertiesWindow_Closed;
				window.Close();
			}
		}

		/// <summary>
		/// Returns task to wait for all properties windows to close
		/// </summary>
		/// <returns>Task to wait</returns>
		public static Task WaitClosingAll() => PropertiesWindowsClosingTCS?.Task ?? Task.CompletedTask;
	}
}