mirror of
https://github.com/microsoft/PowerToys.git
synced 2026-02-24 04:00:02 +01:00
<!-- Enter a brief description/summary of your PR here. What does it fix/what does it change/how was it tested (even manually, if necessary)? --> ## Summary of the Pull Request Transparency support (best-effort) > Not every window can be made transparent. Transparency is applied on a best-effort basis and depends on how the target app/window is built and rendered. ## When it may not work * Windows with special rendering pipelines (e.g., certain hardware-accelerated / compositor-managed surfaces). * Some tool/popup/owned windows where the foreground window isn’t the actual surface being drawn. ## How it works (high-level) * Resolve the best target window (preferring the top-level/root window over transient children). * Apply Windows’ standard layered-window alpha mechanism (per-window opacity) to adjust transparency. * When unpinned, Restore the original opacity/state when possible. If transparency doesn’t change, it means the window doesn’t support this mechanism in its current configuration. <!-- Please review the items on the PR checklist before submitting--> ## PR Checklist - [X] Closes: #43278 #42929 #28773 <!-- - [ ] Closes: #yyy (add separate lines for additional resolved issues) --> - [ ] **Communication:** I've discussed this with core contributors already. If the work hasn't been agreed, this work might be rejected - [ ] **Tests:** Added/updated and all pass - [ ] **Localization:** All end-user-facing strings can be localized - [ ] **Dev docs:** Added/updated - [ ] **New binaries:** Added on the required places - [ ] [JSON for signing](https://github.com/microsoft/PowerToys/blob/main/.pipelines/ESRPSigning_core.json) for new binaries - [ ] [WXS for installer](https://github.com/microsoft/PowerToys/blob/main/installer/PowerToysSetup/Product.wxs) for new binaries and localization folder - [ ] [YML for CI pipeline](https://github.com/microsoft/PowerToys/blob/main/.pipelines/ci/templates/build-powertoys-steps.yml) for new test projects - [ ] [YML for signed pipeline](https://github.com/microsoft/PowerToys/blob/main/.pipelines/release.yml) - [ ] **Documentation updated:** If checked, please file a pull request on [our docs repo](https://github.com/MicrosoftDocs/windows-uwp/tree/docs/hub/powertoys) and link it here: #xxx <!-- Provide a more detailed description of the PR, other things fixed, or any additional comments/features here --> ## Detailed Description of the Pull Request / Additional comments <!-- Describe how you validated the behavior. Add automated tests wherever possible, but list manual validation steps taken as well --> ## Validation Steps Performed https://github.com/user-attachments/assets/c97a87f2-3126-4e19-990f-8c684dbeb631 <img width="1119" height="426" alt="image" src="https://github.com/user-attachments/assets/547671ee-81d3-4c94-8199-bf0c4b1b7760" /> --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
381 lines
12 KiB
C#
381 lines
12 KiB
C#
// Copyright (c) Microsoft Corporation
|
|
// The Microsoft Corporation licenses this file to you under the MIT license.
|
|
// See the LICENSE file in the project root for more information.
|
|
|
|
using System;
|
|
using System.Collections.Generic;
|
|
using System.Globalization;
|
|
using System.Linq;
|
|
using System.Runtime.CompilerServices;
|
|
using System.Text.Json;
|
|
using global::PowerToys.GPOWrapper;
|
|
using ManagedCommon;
|
|
using Microsoft.PowerToys.Settings.UI.Helpers;
|
|
using Microsoft.PowerToys.Settings.UI.Library;
|
|
using Microsoft.PowerToys.Settings.UI.Library.Helpers;
|
|
using Microsoft.PowerToys.Settings.UI.Library.Interfaces;
|
|
using Microsoft.PowerToys.Settings.UI.Library.Utilities;
|
|
using Microsoft.PowerToys.Settings.UI.SerializationContext;
|
|
|
|
namespace Microsoft.PowerToys.Settings.UI.ViewModels
|
|
{
|
|
public partial class AlwaysOnTopViewModel : PageViewModelBase
|
|
{
|
|
protected override string ModuleName => AlwaysOnTopSettings.ModuleName;
|
|
|
|
private SettingsUtils SettingsUtils { get; set; }
|
|
|
|
private GeneralSettings GeneralSettingsConfig { get; set; }
|
|
|
|
private AlwaysOnTopSettings Settings { get; set; }
|
|
|
|
private Func<string, int> SendConfigMSG { get; }
|
|
|
|
public AlwaysOnTopViewModel(SettingsUtils settingsUtils, ISettingsRepository<GeneralSettings> settingsRepository, ISettingsRepository<AlwaysOnTopSettings> moduleSettingsRepository, Func<string, int> ipcMSGCallBackFunc)
|
|
{
|
|
ArgumentNullException.ThrowIfNull(settingsUtils);
|
|
|
|
SettingsUtils = settingsUtils;
|
|
|
|
// To obtain the general settings configurations of PowerToys Settings.
|
|
ArgumentNullException.ThrowIfNull(settingsRepository);
|
|
|
|
GeneralSettingsConfig = settingsRepository.SettingsConfig;
|
|
|
|
InitializeEnabledValue();
|
|
|
|
// To obtain the settings configurations of AlwaysOnTop.
|
|
ArgumentNullException.ThrowIfNull(moduleSettingsRepository);
|
|
|
|
Settings = moduleSettingsRepository.SettingsConfig;
|
|
|
|
_hotkey = Settings.Properties.Hotkey.Value;
|
|
_frameEnabled = Settings.Properties.FrameEnabled.Value;
|
|
_frameThickness = Settings.Properties.FrameThickness.Value;
|
|
_frameColor = Settings.Properties.FrameColor.Value;
|
|
_frameOpacity = Settings.Properties.FrameOpacity.Value;
|
|
_frameAccentColor = Settings.Properties.FrameAccentColor.Value;
|
|
_soundEnabled = Settings.Properties.SoundEnabled.Value;
|
|
_doNotActivateOnGameMode = Settings.Properties.DoNotActivateOnGameMode.Value;
|
|
_roundCornersEnabled = Settings.Properties.RoundCornersEnabled.Value;
|
|
_excludedApps = Settings.Properties.ExcludedApps.Value;
|
|
_windows11 = OSVersionHelper.IsWindows11();
|
|
|
|
// set the callback functions value to handle outgoing IPC message.
|
|
SendConfigMSG = ipcMSGCallBackFunc;
|
|
}
|
|
|
|
private void InitializeEnabledValue()
|
|
{
|
|
_enabledGpoRuleConfiguration = GPOWrapper.GetConfiguredAlwaysOnTopEnabledValue();
|
|
if (_enabledGpoRuleConfiguration == GpoRuleConfigured.Disabled || _enabledGpoRuleConfiguration == GpoRuleConfigured.Enabled)
|
|
{
|
|
// Get the enabled state from GPO.
|
|
_enabledStateIsGPOConfigured = true;
|
|
_isEnabled = _enabledGpoRuleConfiguration == GpoRuleConfigured.Enabled;
|
|
}
|
|
else
|
|
{
|
|
_isEnabled = GeneralSettingsConfig.Enabled.AlwaysOnTop;
|
|
}
|
|
}
|
|
|
|
public override Dictionary<string, HotkeySettings[]> GetAllHotkeySettings()
|
|
{
|
|
var hotkeysDict = new Dictionary<string, HotkeySettings[]>
|
|
{
|
|
[ModuleName] = [Hotkey],
|
|
};
|
|
|
|
return hotkeysDict;
|
|
}
|
|
|
|
public bool IsEnabled
|
|
{
|
|
get => _isEnabled;
|
|
|
|
set
|
|
{
|
|
if (_enabledStateIsGPOConfigured)
|
|
{
|
|
// If it's GPO configured, shouldn't be able to change this state.
|
|
return;
|
|
}
|
|
|
|
if (value != _isEnabled)
|
|
{
|
|
_isEnabled = value;
|
|
|
|
// Set the status in the general settings configuration
|
|
GeneralSettingsConfig.Enabled.AlwaysOnTop = value;
|
|
OutGoingGeneralSettings snd = new OutGoingGeneralSettings(GeneralSettingsConfig);
|
|
|
|
SendConfigMSG(snd.ToString());
|
|
OnPropertyChanged(nameof(IsEnabled));
|
|
}
|
|
}
|
|
}
|
|
|
|
public bool IsEnabledGpoConfigured
|
|
{
|
|
get => _enabledStateIsGPOConfigured;
|
|
}
|
|
|
|
public HotkeySettings Hotkey
|
|
{
|
|
get => _hotkey;
|
|
|
|
set
|
|
{
|
|
if (value != _hotkey)
|
|
{
|
|
_hotkey = value ?? AlwaysOnTopProperties.DefaultHotkeyValue;
|
|
|
|
Settings.Properties.Hotkey.Value = _hotkey;
|
|
NotifyPropertyChanged();
|
|
|
|
// Also notify that transparency keys have changed
|
|
OnPropertyChanged(nameof(IncreaseOpacityKeysList));
|
|
OnPropertyChanged(nameof(DecreaseOpacityKeysList));
|
|
|
|
// Using InvariantCulture as this is an IPC message
|
|
SendConfigMSG(
|
|
string.Format(
|
|
CultureInfo.InvariantCulture,
|
|
"{{ \"powertoys\": {{ \"{0}\": {1} }} }}",
|
|
AlwaysOnTopSettings.ModuleName,
|
|
JsonSerializer.Serialize(Settings, SourceGenerationContextContext.Default.AlwaysOnTopSettings)));
|
|
}
|
|
}
|
|
}
|
|
|
|
public bool FrameEnabled
|
|
{
|
|
get => _frameEnabled;
|
|
|
|
set
|
|
{
|
|
if (value != _frameEnabled)
|
|
{
|
|
_frameEnabled = value;
|
|
Settings.Properties.FrameEnabled.Value = value;
|
|
NotifyPropertyChanged();
|
|
}
|
|
}
|
|
}
|
|
|
|
public int FrameThickness
|
|
{
|
|
get => _frameThickness;
|
|
|
|
set
|
|
{
|
|
if (value != _frameThickness)
|
|
{
|
|
_frameThickness = value;
|
|
Settings.Properties.FrameThickness.Value = value;
|
|
NotifyPropertyChanged();
|
|
}
|
|
}
|
|
}
|
|
|
|
public string FrameColor
|
|
{
|
|
get => _frameColor;
|
|
|
|
set
|
|
{
|
|
if (value != _frameColor)
|
|
{
|
|
_frameColor = value;
|
|
Settings.Properties.FrameColor.Value = value;
|
|
NotifyPropertyChanged();
|
|
}
|
|
}
|
|
}
|
|
|
|
public int FrameOpacity
|
|
{
|
|
get => _frameOpacity;
|
|
|
|
set
|
|
{
|
|
if (value != _frameOpacity)
|
|
{
|
|
_frameOpacity = value;
|
|
Settings.Properties.FrameOpacity.Value = value;
|
|
NotifyPropertyChanged();
|
|
}
|
|
}
|
|
}
|
|
|
|
public bool SoundEnabled
|
|
{
|
|
get => _soundEnabled;
|
|
|
|
set
|
|
{
|
|
if (value != _soundEnabled)
|
|
{
|
|
_soundEnabled = value;
|
|
Settings.Properties.SoundEnabled.Value = value;
|
|
NotifyPropertyChanged();
|
|
}
|
|
}
|
|
}
|
|
|
|
public bool DoNotActivateOnGameMode
|
|
{
|
|
get => _doNotActivateOnGameMode;
|
|
|
|
set
|
|
{
|
|
if (value != _doNotActivateOnGameMode)
|
|
{
|
|
_doNotActivateOnGameMode = value;
|
|
Settings.Properties.DoNotActivateOnGameMode.Value = value;
|
|
NotifyPropertyChanged();
|
|
}
|
|
}
|
|
}
|
|
|
|
public bool RoundCornersEnabled
|
|
{
|
|
get => _roundCornersEnabled;
|
|
|
|
set
|
|
{
|
|
if (value != _roundCornersEnabled)
|
|
{
|
|
_roundCornersEnabled = value;
|
|
Settings.Properties.RoundCornersEnabled.Value = value;
|
|
NotifyPropertyChanged();
|
|
}
|
|
}
|
|
}
|
|
|
|
public string ExcludedApps
|
|
{
|
|
get => _excludedApps;
|
|
|
|
set
|
|
{
|
|
if (value != _excludedApps)
|
|
{
|
|
_excludedApps = value;
|
|
Settings.Properties.ExcludedApps.Value = value;
|
|
NotifyPropertyChanged();
|
|
}
|
|
}
|
|
}
|
|
|
|
public bool FrameAccentColor
|
|
{
|
|
get => _frameAccentColor;
|
|
|
|
set
|
|
{
|
|
if (value != _frameAccentColor)
|
|
{
|
|
_frameAccentColor = value;
|
|
Settings.Properties.FrameAccentColor.Value = value;
|
|
NotifyPropertyChanged();
|
|
}
|
|
}
|
|
}
|
|
|
|
public bool Windows11
|
|
{
|
|
get => _windows11;
|
|
|
|
set
|
|
{
|
|
_windows11 = value;
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets the keys list for increasing window opacity (modifier keys + "+").
|
|
/// </summary>
|
|
public List<object> IncreaseOpacityKeysList
|
|
{
|
|
get
|
|
{
|
|
var keys = GetModifierKeysList();
|
|
keys.Add("+");
|
|
return keys;
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets the keys list for decreasing window opacity (modifier keys + "-").
|
|
/// </summary>
|
|
public List<object> DecreaseOpacityKeysList
|
|
{
|
|
get
|
|
{
|
|
var keys = GetModifierKeysList();
|
|
keys.Add("-");
|
|
return keys;
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets only the modifier keys from the current hotkey setting.
|
|
/// </summary>
|
|
private List<object> GetModifierKeysList()
|
|
{
|
|
var modifierKeys = new List<object>();
|
|
|
|
if (_hotkey.Win)
|
|
{
|
|
modifierKeys.Add(92); // The Windows key
|
|
}
|
|
|
|
if (_hotkey.Ctrl)
|
|
{
|
|
modifierKeys.Add("Ctrl");
|
|
}
|
|
|
|
if (_hotkey.Alt)
|
|
{
|
|
modifierKeys.Add("Alt");
|
|
}
|
|
|
|
if (_hotkey.Shift)
|
|
{
|
|
modifierKeys.Add(16); // The Shift key
|
|
}
|
|
|
|
return modifierKeys;
|
|
}
|
|
|
|
public void NotifyPropertyChanged([CallerMemberName] string propertyName = null)
|
|
{
|
|
OnPropertyChanged(propertyName);
|
|
SettingsUtils.SaveSettings(Settings.ToJsonString(), AlwaysOnTopSettings.ModuleName);
|
|
}
|
|
|
|
public void RefreshEnabledState()
|
|
{
|
|
InitializeEnabledValue();
|
|
OnPropertyChanged(nameof(IsEnabled));
|
|
}
|
|
|
|
private GpoRuleConfigured _enabledGpoRuleConfiguration;
|
|
private bool _enabledStateIsGPOConfigured;
|
|
private bool _isEnabled;
|
|
private HotkeySettings _hotkey;
|
|
private bool _frameEnabled;
|
|
private int _frameThickness;
|
|
private string _frameColor;
|
|
private bool _frameAccentColor;
|
|
private int _frameOpacity;
|
|
private bool _soundEnabled;
|
|
private bool _doNotActivateOnGameMode;
|
|
private bool _roundCornersEnabled;
|
|
private string _excludedApps;
|
|
private bool _windows11;
|
|
}
|
|
}
|