src/Files.App/Data/Contracts/IAppearanceSettingsService.cs - main - githubmirror/Files

src/Files.App/Data/Contracts/IAppearanceSettingsService.cs
138 строк4 KB
yair100
Feature: Added support for customizing the toolbar (#18276)
15 апр 2026, 06:11
15 апр 2026, 06:11fcb5c0f
// Copyright (c) Files Community
// Licensed under the MIT License.

using Microsoft.UI.Xaml;
using Microsoft.UI.Xaml.Media;

namespace Files.App.Data.Contracts
{
	public interface IAppearanceSettingsService : IBaseSettingsService, INotifyPropertyChanged
	{
		#region Internal Settings

		/// <summary>
		/// Gets or sets a value indicating the width of the sidebar pane when open.
		/// </summary>
		double SidebarWidth { get; set; }

		/// <summary>
		/// Gets or sets a value indicating if the sidebar pane should be open or closed.
		/// </summary>
		bool IsSidebarOpen { get; set; }

		#endregion

		/// <summary>
		/// Gets or sets a value for the app theme mode.
		/// </summary>
		string AppThemeMode { get; set; }

		/// <summary>
		/// Gets or sets a value for the app theme background color.
		/// </summary>
		String AppThemeBackgroundColor { get; set; }

		/// <summary>
		/// Gets or sets a value for the app theme address bar background color.
		/// </summary>
		String AppThemeAddressBarBackgroundColor { get; set; }

		/// <summary>
		/// Gets or sets a value for the app theme toolbar background color.
		/// </summary>
		String AppThemeToolbarBackgroundColor { get; set; }

		/// <summary>
		/// Gets or sets a value for the app theme sidebar background color.
		/// </summary>
		String AppThemeSidebarBackgroundColor { get; set; }

		/// <summary>
		/// Gets or sets a value for the app theme file area background color.
		/// </summary>
		String AppThemeFileAreaBackgroundColor { get; set; }

		/// <summary>
		/// Gets or sets a value for the app theme file area background color for the inactive pane.
		/// </summary>
		String AppThemeFileAreaSecondaryBackgroundColor { get; set; }

		/// <summary>
		/// Gets or sets a value for the app theme info pane background color.
		/// </summary>
		String AppThemeInfoPaneBackgroundColor { get; set; }

		/// <summary>
		/// Gets or sets a value for the app theme font family.
		/// </summary>
		String AppThemeFontFamily { get; set; }

		/// <summary>
		/// Gets or sets a value for the theme system backdrop.
		/// </summary>
		BackdropMaterialType AppThemeBackdropMaterial { get; set; }

		/// <summary>
		/// Gets or sets a value for the app background image source
		/// </summary>
		string AppThemeBackgroundImageSource { get; set; }

		/// <summary>
		/// Gets or sets a value for the app background image fit.
		/// </summary>
		Stretch AppThemeBackgroundImageFit { get; set; }

		/// <summary>
		/// Gets or sets a value for the app background image opacity.
		/// </summary>
		float AppThemeBackgroundImageOpacity { get; set; }

		/// <summary>
		/// Gets or sets a value for the app background image Vertical Alignment.
		/// </summary>
		VerticalAlignment AppThemeBackgroundImageVerticalAlignment { get; set; }

		/// <summary>
		/// Gets or sets a value for the app background image Horizontal Alignment.
		/// </summary>
		HorizontalAlignment AppThemeBackgroundImageHorizontalAlignment { get; set; }

		/// <summary>
		/// Gets or sets a value whether the toolbar should be displayed.
		/// </summary>
		bool ShowToolbar { get; set; }

		/// <summary>
		/// Gets or sets a value whether the status bar should be displayed.
		/// </summary>
		bool ShowStatusBar { get; set; }

		/// <summary>
		/// Gets or sets a value whether the tab actions button should be displayed.
		/// </summary>
		bool ShowTabActions { get; set; }

		/// <summary>
		/// Gets or sets a value whether the shelf pane toggle button should be displayed.
		/// </summary>
		bool ShowShelfPaneToggleButton { get; set; }


		/// <summary>
		/// Gets or sets a value indicating when to display the Status Center button.
		/// </summary>
		StatusCenterVisibility StatusCenterVisibility { get; set; }

		/// <summary>
		/// Gets or sets the toolbar items grouped by customization context.
		/// A null value means the default toolbar layout is used.
		/// </summary>
		Dictionary<string, List<ToolbarItemSettingsEntry>>? CustomToolbarItems { get; set; }

		/// <summary>
		/// Gets or sets the known default toolbar identifiers grouped by context.
		/// This is used to inject only newly introduced default actions for existing user configs.
		/// </summary>
		Dictionary<string, List<string>>? LastKnownToolbarDefaults { get; set; }
	}
}