#include "pch.h" #include #include #include #include #include #include #include #include #include namespace NonLocalizable { const wchar_t ModulePath[] = L"PowerToys.AlwaysOnTop.exe"; } namespace { const wchar_t JSON_KEY_PROPERTIES[] = L"properties"; const wchar_t JSON_KEY_WIN[] = L"win"; const wchar_t JSON_KEY_ALT[] = L"alt"; const wchar_t JSON_KEY_CTRL[] = L"ctrl"; const wchar_t JSON_KEY_SHIFT[] = L"shift"; const wchar_t JSON_KEY_CODE[] = L"code"; const wchar_t JSON_KEY_HOTKEY[] = L"hotkey"; const wchar_t JSON_KEY_VALUE[] = L"value"; } BOOL APIENTRY DllMain(HMODULE /*hModule*/, DWORD ul_reason_for_call, LPVOID /*lpReserved*/) { switch (ul_reason_for_call) { case DLL_PROCESS_ATTACH: Trace::AlwaysOnTop::RegisterProvider(); break; case DLL_THREAD_ATTACH: case DLL_THREAD_DETACH: break; case DLL_PROCESS_DETACH: Trace::AlwaysOnTop::UnregisterProvider(); break; } return TRUE; } class AlwaysOnTopModuleInterface : public PowertoyModuleIface { public: // Return the localized display name of the powertoy virtual PCWSTR get_name() override { return app_name.c_str(); } // Return the non localized key of the powertoy, this will be cached by the runner virtual const wchar_t* get_key() override { return app_key.c_str(); } // Return the configured status for the gpo policy for the module virtual powertoys_gpo::gpo_rule_configured_t gpo_policy_enabled_configuration() override { return powertoys_gpo::getConfiguredAlwaysOnTopEnabledValue(); } // Return JSON with the configuration options. // These are the settings shown on the settings page along with their current values. virtual bool get_config(wchar_t* buffer, int* buffer_size) override { HINSTANCE hinstance = reinterpret_cast(&__ImageBase); // Create a Settings object. PowerToysSettings::Settings settings(hinstance, get_name()); return settings.serialize_to_buffer(buffer, buffer_size); } // Passes JSON with the configuration settings for the powertoy. // This is called when the user hits Save on the settings page. virtual void set_config(const wchar_t* config) override { try { // Parse the input JSON string. PowerToysSettings::PowerToyValues values = PowerToysSettings::PowerToyValues::from_json_string(config, get_key()); parse_hotkey(values); // If you don't need to do any custom processing of the settings, proceed // to persists the values calling: values.save_to_settings_file(); // Otherwise call a custom function to process the settings before saving them to disk: // save_settings(); } catch (std::exception&) { // Improper JSON. } } virtual bool on_hotkey(size_t hotkeyId) override { if (m_enabled) { Logger::trace(L"AlwaysOnTop hotkey pressed, id={}", hotkeyId); if (!is_process_running()) { Enable(); } if (hotkeyId == 0) { SetEvent(m_hPinEvent); } else if (hotkeyId == 1) { SetEvent(m_hIncreaseOpacityEvent); } else if (hotkeyId == 2) { SetEvent(m_hDecreaseOpacityEvent); } return true; } return false; } virtual size_t get_hotkeys(Hotkey* hotkeys, size_t buffer_size) override { size_t count = 0; // Hotkey 0: Pin/Unpin (e.g., Win+Ctrl+T) if (m_hotkey.key) { if (hotkeys && buffer_size > count) { hotkeys[count] = m_hotkey; Logger::trace(L"AlwaysOnTop hotkey[0]: win={}, ctrl={}, shift={}, alt={}, key={}", m_hotkey.win, m_hotkey.ctrl, m_hotkey.shift, m_hotkey.alt, m_hotkey.key); } count++; } // Hotkey 1: Increase opacity (same modifiers + VK_OEM_PLUS '=') if (m_hotkey.key) { if (hotkeys && buffer_size > count) { hotkeys[count] = m_hotkey; hotkeys[count].key = VK_OEM_PLUS; // '=' key Logger::trace(L"AlwaysOnTop hotkey[1] (increase opacity): win={}, ctrl={}, shift={}, alt={}, key={}", hotkeys[count].win, hotkeys[count].ctrl, hotkeys[count].shift, hotkeys[count].alt, hotkeys[count].key); } count++; } // Hotkey 2: Decrease opacity (same modifiers + VK_OEM_MINUS '-') if (m_hotkey.key) { if (hotkeys && buffer_size > count) { hotkeys[count] = m_hotkey; hotkeys[count].key = VK_OEM_MINUS; // '-' key Logger::trace(L"AlwaysOnTop hotkey[2] (decrease opacity): win={}, ctrl={}, shift={}, alt={}, key={}", hotkeys[count].win, hotkeys[count].ctrl, hotkeys[count].shift, hotkeys[count].alt, hotkeys[count].key); } count++; } Logger::trace(L"AlwaysOnTop get_hotkeys returning count={}", count); return count; } // Enable the powertoy virtual void enable() { Logger::info("AlwaysOnTop enabling"); Enable(); } // Disable the powertoy virtual void disable() { Logger::info("AlwaysOnTop disabling"); Disable(true); } // Returns if the powertoy is enabled virtual bool is_enabled() override { return m_enabled; } // Destroy the powertoy and free memory virtual void destroy() override { Disable(false); delete this; } AlwaysOnTopModuleInterface() { app_name = L"AlwaysOnTop"; //TODO: localize app_key = NonLocalizable::ModuleKey; m_hPinEvent = CreateDefaultEvent(CommonSharedConstants::ALWAYS_ON_TOP_PIN_EVENT); m_hTerminateEvent = CreateDefaultEvent(CommonSharedConstants::ALWAYS_ON_TOP_TERMINATE_EVENT); m_hIncreaseOpacityEvent = CreateDefaultEvent(CommonSharedConstants::ALWAYS_ON_TOP_INCREASE_OPACITY_EVENT); m_hDecreaseOpacityEvent = CreateDefaultEvent(CommonSharedConstants::ALWAYS_ON_TOP_DECREASE_OPACITY_EVENT); init_settings(); } private: void Enable() { m_enabled = true; // Log telemetry Trace::AlwaysOnTop::Enable(true); unsigned long powertoys_pid = GetCurrentProcessId(); std::wstring executable_args = L""; executable_args.append(std::to_wstring(powertoys_pid)); ResetEvent(m_hPinEvent); SHELLEXECUTEINFOW sei{ sizeof(sei) }; sei.fMask = { SEE_MASK_NOCLOSEPROCESS | SEE_MASK_FLAG_NO_UI }; sei.lpFile = NonLocalizable::ModulePath; sei.nShow = SW_SHOWNORMAL; sei.lpParameters = executable_args.data(); if (ShellExecuteExW(&sei) == false) { Logger::error(L"Failed to start AlwaysOnTop"); auto message = get_last_error_message(GetLastError()); if (message.has_value()) { Logger::error(message.value()); } } else { m_hProcess = sei.hProcess; } } void Disable(bool const traceEvent) { m_enabled = false; ResetEvent(m_hPinEvent); // Log telemetry if (traceEvent) { Trace::AlwaysOnTop::Enable(false); } SetEvent(m_hTerminateEvent); // Wait for 1.5 seconds for the process to end correctly and stop etw tracer WaitForSingleObject(m_hProcess, 1500); // If process is still running, terminate it if (m_hProcess) { TerminateProcess(m_hProcess, 0); m_hProcess = nullptr; } } void parse_hotkey(PowerToysSettings::PowerToyValues& settings) { auto settingsObject = settings.get_raw_json(); if (settingsObject.GetView().Size()) { try { auto jsonHotkeyObject = settingsObject.GetNamedObject(JSON_KEY_PROPERTIES).GetNamedObject(JSON_KEY_HOTKEY).GetNamedObject(JSON_KEY_VALUE); m_hotkey.win = jsonHotkeyObject.GetNamedBoolean(JSON_KEY_WIN); m_hotkey.alt = jsonHotkeyObject.GetNamedBoolean(JSON_KEY_ALT); m_hotkey.shift = jsonHotkeyObject.GetNamedBoolean(JSON_KEY_SHIFT); m_hotkey.ctrl = jsonHotkeyObject.GetNamedBoolean(JSON_KEY_CTRL); m_hotkey.key = static_cast(jsonHotkeyObject.GetNamedNumber(JSON_KEY_CODE)); } catch (...) { Logger::error("Failed to initialize AlwaysOnTop start shortcut"); } } else { Logger::info("AlwaysOnTop settings are empty"); } } bool is_process_running() { return WaitForSingleObject(m_hProcess, 0) == WAIT_TIMEOUT; } void init_settings() { try { // Load and parse the settings file for this PowerToy. PowerToysSettings::PowerToyValues settings = PowerToysSettings::PowerToyValues::load_from_settings_file(get_key()); parse_hotkey(settings); } catch (std::exception&) { Logger::warn(L"An exception occurred while loading the settings file"); // Error while loading from the settings file. Let default values stay as they are. } } std::wstring app_name; std::wstring app_key; //contains the non localized key of the powertoy bool m_enabled = false; HANDLE m_hProcess = nullptr; Hotkey m_hotkey; // Handle to event used to pin/unpin windows HANDLE m_hPinEvent; HANDLE m_hTerminateEvent; HANDLE m_hIncreaseOpacityEvent; HANDLE m_hDecreaseOpacityEvent; }; extern "C" __declspec(dllexport) PowertoyModuleIface* __cdecl powertoy_create() { return new AlwaysOnTopModuleInterface(); }