[GUI] Off-screen locations (#273)

Author: flyingpie

CHANGELOG.md

@@ -8,6 +8,7 @@
 - Bugfix: Updated example for "Process Explorer" to correct start- and attach to new instance.
 - Bugfix: Updated CLI to load settings and fetch listening endpoint.
 - Bugfix: When a window gets minimized, WTQ could not longer toggle it.
+- Bugfix: When adding an app without any matching criteria, any window would be attached to (now only attaches when at least 1 criterion is present).
 - Feature: "Resize" option (defaults to "Always"), can be used to disable resizing the app's window (disables alignment settings). Useful for apps that don't respond well to being resized, like some Electron apps.
 ```jsonc
   "Apps": [
@@ -17,6 +18,7 @@
   ]
 }
 ```
+- Feature: GUI - "Off-Screen Locations" can now be configured from the GUI.
 
 ## [v2.0.17] / 2025-08-27
 - Breaking change: On Windows, when using a hotkey with the "Shift" modifier and the "KeyChar" in the settings, you need to use the non-shifted character now:

src/10-Core/Wtq/Configuration/WtqSharedOptions.cs

@@ -129,6 +129,10 @@ public abstract class WtqSharedOptions : IValidatableObject
 	/// <para>
 	/// By default, WTQ looks for empty space in this order: Above, Below, Left, Right.
 	/// </para>
+	/// <para>
+	/// If no free space can be found in any of the specified locations, the app will just blink on- and off the screen,
+	/// without any animation.
+	/// </para>
 	/// </summary>
 	/// <example>
 	/// <code>

src/10-Core/Wtq/Utils/DefaultCollectionValue.cs

@@ -0,0 +1,10 @@
+namespace Wtq.Utils;
+
+/// <summary>
+/// Version of <see cref="DefaultValueAttribute"/>, but for collections.
+/// </summary>
+[AttributeUsage(AttributeTargets.Property)]
+public sealed class DefaultCollectionValueAttribute(object[] values) : Attribute
+{
+	public ICollection<object> Values { get; } = Guard.Against.Null(values);
+}

src/10-Core/Wtq/Utils/DefaultCollectionValueAttribute.cs

@@ -2,36 +2,115 @@
 
 @code {
 
-	// private void Remove(HotkeyOptions hk)
-	// {
-	// 	Value.Remove(hk);
-	//
-	// 	StateHasChanged();
-	// }
+	private List<OffScrLoc> Locs { get; set; }
+
+	protected override void OnInitialized()
+	{
+		Notifier.OnNotify(() => InvokeAsync(UpdateLocs));
+
+		UpdateLocs();
+	}
+
+	private void UpdateLocs()
+	{
+		// Get current setting value:
+		// - App-specific
+		// - Global
+		// - Default (currently from constant, instead of attribute)
+		var locs = Value ?? WtqConstants.DefaultOffScreenLocations; // TODO: Default collection values aren't coming through Value yet.
+
+		// Convert value to view model.
+		Locs = locs.Select(l => new OffScrLoc() { IsActive = true, Loc = l}).ToList();
+
+		// Add inactive values.
+		foreach (var val in WtqConstants.DefaultOffScreenLocations)
+		{
+			if (Locs.Any(l => l.Loc == val))
+			{
+				continue;
+			}
+
+			Locs.Add(new() { IsActive = false, Loc = val});
+		}
+
+		StateHasChanged();
+	}
+
+	private void SetActive(OffScrLoc loc, bool isActive)
+	{
+		loc.IsActive = isActive;
+
+		UpdateValue();
+	}
+
+	private void Up(OffScrLoc loc) => MoveLoc(loc, -1);
+
+	private void Down(OffScrLoc loc) => MoveLoc(loc, 1);
+
+	private void MoveLoc(OffScrLoc loc, int pos)
+	{
+		var l = Locs.FirstOrDefault(ll => ll.Loc == loc.Loc);
+		var idx = Locs.IndexOf(l);
+
+		Locs.Remove(l);
+
+		var ins = idx + pos;
+
+		if (ins < 0)
+		{
+			Locs.Add(l);
+		}
+		else
+		{
+			Locs.Insert(idx + pos, l);
+		}
+
+		UpdateValue();
+	}
+
+	private void UpdateValue() => Value = Locs.Where(l => l.IsActive).Select(l => l.Loc).ToList();
+
+	private class OffScrLoc
+	{
+		public bool IsActive { get; set; }
+
+		public OffScreenLocation Loc { get; set; }
+	}
 
 }
 
-<WtqSetting TProperty="ICollection<OffScreenLocation>" Get="Get" Set="Set">
+<WtqSetting TProperty="ICollection<OffScreenLocation>" Get="Get" Set="Set" Default="Default">
 	<Content>
 
-		TODO
-
-		@* <RadzenStack> *@
-		@* *@
-		@* 	@foreach (var hk in Value) *@
-		@* 	{ *@
-		@* 		<Hotkey Options="hk" OnRemove="@(() => Remove(hk))"/> *@
-		@* 	} *@
-		@* *@
-		@* 	<RadzenStack> *@
-		@* 		<RadzenButton *@
-		@* 			Icon="add" *@
-		@* 			Size="ButtonSize.Medium" *@
-		@* 			Click="@(() => Value.Add(new()))" *@
-		@* 		/> *@
-		@* 	</RadzenStack> *@
-		@* *@
-		@* </RadzenStack> *@
+		<RadzenStack>
+
+			@foreach (var loc in Locs)
+			{
+				<RadzenStack Orientation="Orientation.Vertical" Gap="0">
+					<RadzenStack Orientation="Orientation.Horizontal" AlignItems="AlignItems.Center" Gap="8" JustifyContent="JustifyContent.SpaceBetween">
+
+						<!-- Active -->
+						<RadzenCheckBox TValue="bool" @bind-Value="loc.IsActive" Change="v => SetActive(loc, v)"/>
+
+						<!-- Label -->
+						@if (loc.IsActive)
+						{
+							<RadzenLabel Text="@loc.Loc.ToString()" Style="flex: 1;" />
+						}
+						else
+						{
+							<RadzenLabel Text="@loc.Loc.ToString()" Style="flex: 1; text-decoration: line-through;" />
+						}
+
+						<!-- Up/Down -->
+						<RadzenButton Click="() => Up(loc)" Icon="keyboard_arrow_up" Size="ButtonSize.Medium"/>
+						<RadzenButton Click="() => Down(loc)" Icon="keyboard_arrow_down" Size="ButtonSize.Medium"/>
+
+					</RadzenStack>
+				</RadzenStack>
+			}
+
+		</RadzenStack>
 
 	</Content>
 </WtqSetting>

src/20-Services/Wtq.Services.UI/Components/Settings/Position/OffScreenLocationsSetting.razor

@@ -13,6 +13,9 @@
 
 	public string? Subtitle => AttrUtils.GetPrompt(Get);
 
+	[CascadingParameter]
+	public Notifier Notifier { get; set; } = null!;
+
 	[EditorRequired]
 	[Parameter]
 	public RenderFragment Content { get; set; } = null!;
@@ -44,7 +47,12 @@
 	private IEnumerable<ValidationResult> ValidationResultsForProperty
 		=> ValidationResults.Where(v => v.MemberNames.Any(m => m.Equals(PropertyName)));
 
-	private void Reset() => Set(default);
+	private void Reset()
+	{
+		Set(default);
+
+		Notifier.Notify();
+	}
 
 	private void ShowTooltip(ElementReference elementReference, TooltipOptions options)
 		=> TooltipService.Open(

src/20-Services/Wtq.Services.UI/Components/WtqSetting.razor

@@ -175,7 +175,7 @@
 				<WtqSettingNumberSlider				TProperty="float?"					Get="() => AppOpts.VerticalOffset"				Set="v => AppOpts.VerticalOffset = v"				Default="() => GlobalOpts.VerticalOffset" />
 
 				<!-- Off-screen locations -->
-				<OffScreenLocationsSetting												Get="() => GlobalOpts.OffScreenLocations"		Set="v => GlobalOpts.OffScreenLocations = v"		Default="() => GlobalOpts.OffScreenLocations" />
+				<OffScreenLocationsSetting												Get="() => AppOpts.OffScreenLocations"			Set="v => AppOpts.OffScreenLocations = v"			Default="() => GlobalOpts.OffScreenLocations" />
 
 			</RadzenStack>
 		</RadzenFieldset>

src/20-Services/Wtq.Services.UI/Pages/App/_Index.razor

@@ -104,6 +104,9 @@
 		<RadzenFieldset Text="Position">
 			<RadzenStack Gap="1rem">
 
+				<!-- Resize -->
+				<WtqSettingRadio					TProperty="Resizing"				Get="() => GlobalOpts.Resize"						Set="v => GlobalOpts.Resize = v"						Default="() => GlobalOpts.Resize" />
+
 				<!-- Horizontal screen coverage -->
 				<WtqSettingNumberSlider				TProperty="float?"					Get="() => GlobalOpts.HorizontalScreenCoverage"		Set="v => GlobalOpts.HorizontalScreenCoverage = v"		Default="() => GlobalOpts.HorizontalScreenCoverage" />
 
@@ -117,7 +120,7 @@
 				<WtqSettingNumberSlider				TProperty="float?"					Get="() => GlobalOpts.VerticalOffset"				Set="v => GlobalOpts.VerticalOffset = v"				Default="() => GlobalOpts.VerticalOffset" />
 
 				<!-- Off-screen locations -->
-				<OffScreenLocationsSetting												Get="() => GlobalOpts.OffScreenLocations"			Set="v => GlobalOpts.OffScreenLocations = v" />
+				<OffScreenLocationsSetting												Get="() => GlobalOpts.OffScreenLocations"			Set="v => GlobalOpts.OffScreenLocations = v"			Default="() => GlobalOpts.OffScreenLocations" />
 
 			</RadzenStack>
 		</RadzenFieldset>