Feature: Added set as app background action (#15316)

Author: yaira2

src/Files.App/Actions/Content/Background/SetAsAppBackgroundAction.cs

@@ -0,0 +1,31 @@
+// Copyright (c) 2024 Files Community
+// Licensed under the MIT License. See the LICENSE.
+
+namespace Files.App.Actions
+{
+	internal sealed class SetAsAppBackgroundAction : BaseSetAsAction
+	{
+		private IAppearanceSettingsService AppearanceSettingsService { get; } = Ioc.Default.GetRequiredService<IAppearanceSettingsService>();
+
+		public override string Label
+			=> "SetAsAppBackground".GetLocalizedResource();
+
+		public override string Description
+			=> "SetAsAppBackgroundDescription".GetLocalizedResource();
+
+		public override RichGlyph Glyph
+			=> new("\uE91B");
+
+		public override bool IsExecutable =>
+			base.IsExecutable &&
+			context.SelectedItem is not null;
+
+		public override Task ExecuteAsync()
+		{
+			if (context.SelectedItem is not null)
+				AppearanceSettingsService.AppThemeBackgroundImageSource = context.SelectedItem.ItemPath;
+
+			return Task.CompletedTask;
+		}
+	}
+}

src/Files.App/Data/Commands/Manager/CommandCodes.cs

@@ -71,6 +71,7 @@ public enum CommandCodes
 		SetAsWallpaperBackground,
 		SetAsSlideshowBackground,
 		SetAsLockscreenBackground,
+		SetAsAppBackground,
 
 		// Install
 		InstallFont,

src/Files.App/Data/Commands/Manager/CommandManager.cs

@@ -76,6 +76,7 @@ public IRichCommand this[HotKey hotKey]
 		public IRichCommand SetAsWallpaperBackground => commands[CommandCodes.SetAsWallpaperBackground];
 		public IRichCommand SetAsSlideshowBackground => commands[CommandCodes.SetAsSlideshowBackground];
 		public IRichCommand SetAsLockscreenBackground => commands[CommandCodes.SetAsLockscreenBackground];
+		public IRichCommand SetAsAppBackground => commands[CommandCodes.SetAsAppBackground];
 		public IRichCommand CopyItem => commands[CommandCodes.CopyItem];
 		public IRichCommand CopyPath => commands[CommandCodes.CopyPath];
 		public IRichCommand CopyPathWithQuotes => commands[CommandCodes.CopyPathWithQuotes];
@@ -249,6 +250,7 @@ public IEnumerator<IRichCommand> GetEnumerator() =>
 			[CommandCodes.SetAsWallpaperBackground] = new SetAsWallpaperBackgroundAction(),
 			[CommandCodes.SetAsSlideshowBackground] = new SetAsSlideshowBackgroundAction(),
 			[CommandCodes.SetAsLockscreenBackground] = new SetAsLockscreenBackgroundAction(),
+			[CommandCodes.SetAsAppBackground] = new SetAsAppBackgroundAction(),
 			[CommandCodes.CopyItem] = new CopyItemAction(),
 			[CommandCodes.CopyPath] = new CopyPathAction(),
 			[CommandCodes.CopyPathWithQuotes] = new CopyPathWithQuotesAction(),

src/Files.App/Data/Commands/Manager/ICommandManager.cs

@@ -67,6 +67,7 @@ public interface ICommandManager : IEnumerable<IRichCommand>
 		IRichCommand SetAsWallpaperBackground { get; }
 		IRichCommand SetAsSlideshowBackground { get; }
 		IRichCommand SetAsLockscreenBackground { get; }
+		IRichCommand SetAsAppBackground { get; }
 
 		IRichCommand InstallFont { get; }
 		IRichCommand InstallInfDriver { get; }

src/Files.App/Data/Factories/ContentPageContextFlyoutFactory.cs

@@ -411,6 +411,7 @@ public static List<ContextMenuFlyoutItemViewModel> GetBaseItemMenuItems(
 						new ContextMenuFlyoutItemViewModelBuilder(Commands.SetAsWallpaperBackground).Build(),
 						new ContextMenuFlyoutItemViewModelBuilder(Commands.SetAsLockscreenBackground).Build(),
 						new ContextMenuFlyoutItemViewModelBuilder(Commands.SetAsSlideshowBackground).Build(),
+						new ContextMenuFlyoutItemViewModelBuilder(Commands.SetAsAppBackground).Build(),
 					]
 				},
 				new ContextMenuFlyoutItemViewModelBuilder(Commands.RotateLeft)

src/Files.App/Strings/en-US/Resources.resw

@@ -339,6 +339,9 @@
   <data name="SetAsLockscreen" xml:space="preserve">
     <value>Set as lockscreen background</value>
   </data>
+  <data name="SetAsAppBackground" xml:space="preserve">
+    <value>Set as app background</value>
+  </data>
   <data name="AccessDeniedDeleteDialog.Text" xml:space="preserve">
     <value>We weren't able to delete this item</value>
   </data>
@@ -2463,6 +2466,9 @@
   <data name="SetAsLockscreenBackgroundDescription" xml:space="preserve">
     <value>Set selected picture as lockscreen background</value>
   </data>
+  <data name="SetAsAppBackgroundDescription" xml:space="preserve">
+    <value>Set selected picture as the app background</value>
+  </data>
   <data name="InstallFontDescription" xml:space="preserve">
     <value>Install selected font(s)</value>
   </data>

src/Files.App/UserControls/InnerNavigationToolbar.xaml

@@ -384,6 +384,15 @@
 									<FontIcon Glyph="{x:Bind Commands.SetAsLockscreenBackground.Glyph.BaseGlyph}" />
 								</MenuFlyoutItem.Icon>
 							</MenuFlyoutItem>
+							<MenuFlyoutItem
+								x:Name="SetAsAppBackgroundFlyoutItem"
+								Command="{x:Bind Commands.SetAsAppBackground}"
+								KeyboardAcceleratorTextOverride="{x:Bind Commands.SetAsAppBackground.HotKeyText, Mode=OneWay}"
+								Text="{helpers:ResourceString Name=Application}">
+								<MenuFlyoutItem.Icon>
+									<FontIcon Glyph="{x:Bind Commands.SetAsAppBackground.Glyph.BaseGlyph}" />
+								</MenuFlyoutItem.Icon>
+							</MenuFlyoutItem>
 						</MenuFlyout>
 					</AppBarButton.Flyout>