src/modules/cmdpal/Microsoft.CmdPal.UI.ViewModels/Models/MonitorInfo.cs - main - githubmirror/PowerToys

src/modules/cmdpal/Microsoft.CmdPal.UI.ViewModels/Models/MonitorInfo.cs

60 строк2 KB

Michael Jolley

CmdPal Dock: Multi-monitor support (#46915)

14 май 2026, 01:37

14 май 2026, 01:37966c1db

// 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.Text.Json.Serialization;

namespace Microsoft.CmdPal.UI.ViewModels.Models;

/// <summary>
/// Represents a physical display monitor connected to the system.
/// </summary>
public sealed record MonitorInfo
{
    /// <summary>
    /// Gets the GDI device name (e.g. <c>\\.\DISPLAY1</c>).
    /// This is volatile and may change across reboots or plug/unplug events.
    /// Use <see cref="StableId"/> for persistent identification.
    /// </summary>
    public required string DeviceId { get; init; }

    /// <summary>
    /// Gets a stable hardware identifier derived from the Display Configuration API
    /// device path (e.g. <c>\\?\DISPLAY#GSM1388#4&amp;125707d6&amp;0&amp;UID8388688#{guid}</c>).
    /// Unlike <see cref="DeviceId"/>, this value survives reboots, driver updates,
    /// and plug/unplug events on the same GPU port. Falls back to <see cref="DeviceId"/>
    /// when the Display Configuration API is unavailable.
    /// </summary>
    public required string StableId { get; init; }

    /// <summary>
    /// Gets the human-readable display name (e.g. <c>DELL U2723QE</c>).
    /// </summary>
    public required string DisplayName { get; init; }

    /// <summary>
    /// Gets the full monitor rectangle in virtual-screen coordinates.
    /// </summary>
    public required ScreenRect Bounds { get; init; }

    /// <summary>
    /// Gets the work area (excludes the taskbar) in virtual-screen coordinates.
    /// </summary>
    public required ScreenRect WorkArea { get; init; }

    /// <summary>
    /// Gets the DPI value for this monitor (e.g. 96, 120, 144, 192).
    /// </summary>
    public required uint Dpi { get; init; }

    /// <summary>
    /// Gets a value indicating whether this is the primary monitor.
    /// </summary>
    public required bool IsPrimary { get; init; }

    /// <summary>
    /// Gets the scale factor for this monitor (e.g. 1.0 = 100%, 1.5 = 150%).
    /// </summary>
    [JsonIgnore]
    public double ScaleFactor => Dpi / 96.0;
}