mirror of
https://github.com/microsoft/PowerToys.git
synced 2026-04-03 09:46:54 +02:00
Fix SA1623: Fix property documentation summaries (#46717)
Update 29 property XML doc summaries to begin with Gets, Gets or sets, or Gets a value indicating whether as required by StyleCop SA1623. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
@@ -12,7 +12,7 @@ public struct InterlockedBoolean(bool initialValue = false)
|
||||
private int _value = initialValue ? 1 : 0;
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the boolean value atomically
|
||||
/// Gets or sets a value indicating whether the atomic boolean is true.
|
||||
/// </summary>
|
||||
public bool Value
|
||||
{
|
||||
|
||||
@@ -8,6 +8,6 @@ public sealed class PinyinFuzzyMatcherOptions
|
||||
{
|
||||
public PinyinMode Mode { get; init; } = PinyinMode.AutoSimplifiedChineseUi;
|
||||
|
||||
/// <summary>Remove IME syllable separators (') for query secondary variant.</summary>
|
||||
/// <summary>Gets a value indicating whether IME syllable separators (') are removed for query secondary variant.</summary>
|
||||
public bool RemoveApostrophesForQuery { get; init; } = true;
|
||||
}
|
||||
|
||||
@@ -341,25 +341,25 @@ public sealed partial class AppearanceSettingsViewModel : ObservableObject, IDis
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Gets whether the backdrop opacity slider should be visible.
|
||||
/// Gets a value indicating whether the backdrop opacity slider should be visible.
|
||||
/// </summary>
|
||||
public bool IsBackdropOpacityVisible =>
|
||||
BackdropStyles.Get(_settingsService.Settings.BackdropStyle).SupportsOpacity;
|
||||
|
||||
/// <summary>
|
||||
/// Gets whether the backdrop description (for styles without options) should be visible.
|
||||
/// Gets a value indicating whether the backdrop description (for styles without options) should be visible.
|
||||
/// </summary>
|
||||
public bool IsMicaBackdropDescriptionVisible =>
|
||||
!BackdropStyles.Get(_settingsService.Settings.BackdropStyle).SupportsOpacity;
|
||||
|
||||
/// <summary>
|
||||
/// Gets whether background/colorization settings are available.
|
||||
/// Gets a value indicating whether background/colorization settings are available.
|
||||
/// </summary>
|
||||
public bool IsBackgroundSettingsEnabled =>
|
||||
BackdropStyles.Get(_settingsService.Settings.BackdropStyle).SupportsColorization;
|
||||
|
||||
/// <summary>
|
||||
/// Gets whether the "not available" message should be shown (inverse of IsBackgroundSettingsEnabled).
|
||||
/// Gets a value indicating whether the "not available" message should be shown (inverse of IsBackgroundSettingsEnabled).
|
||||
/// </summary>
|
||||
public bool IsBackgroundNotAvailableVisible =>
|
||||
!BackdropStyles.Get(_settingsService.Settings.BackdropStyle).SupportsColorization;
|
||||
|
||||
@@ -36,17 +36,17 @@ public sealed record BackdropStyleConfig
|
||||
public float FixedOpacity { get; init; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets whether this backdrop style supports custom colorization (tint colors).
|
||||
/// Gets a value indicating whether this backdrop style supports custom colorization (tint colors).
|
||||
/// </summary>
|
||||
public bool SupportsColorization { get; init; } = true;
|
||||
|
||||
/// <summary>
|
||||
/// Gets whether this backdrop style supports custom background images.
|
||||
/// Gets a value indicating whether this backdrop style supports custom background images.
|
||||
/// </summary>
|
||||
public bool SupportsBackgroundImage { get; init; } = true;
|
||||
|
||||
/// <summary>
|
||||
/// Gets whether this backdrop style supports opacity adjustment.
|
||||
/// Gets a value indicating whether this backdrop style supports opacity adjustment.
|
||||
/// </summary>
|
||||
public bool SupportsOpacity { get; init; } = true;
|
||||
|
||||
|
||||
@@ -67,7 +67,7 @@ public sealed class ThemeSnapshot
|
||||
public required float BackgroundBrightness { get; init; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets whether colorization is active (accent color, custom color, or image mode).
|
||||
/// Gets a value indicating whether colorization is active (accent color, custom color, or image mode).
|
||||
/// </summary>
|
||||
public required bool HasColorization { get; init; }
|
||||
}
|
||||
|
||||
@@ -93,19 +93,19 @@ public record DockBandSettings
|
||||
public required string CommandId { get; init; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets whether titles are shown for items in this band.
|
||||
/// Gets whether titles are shown for items in this band.
|
||||
/// If null, falls back to dock-wide ShowLabels setting.
|
||||
/// </summary>
|
||||
public bool? ShowTitles { get; init; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets whether subtitles are shown for items in this band.
|
||||
/// Gets whether subtitles are shown for items in this band.
|
||||
/// If null, falls back to dock-wide ShowLabels setting.
|
||||
/// </summary>
|
||||
public bool? ShowSubtitles { get; init; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets a value for backward compatibility. Maps to ShowTitles.
|
||||
/// Gets a value for backward compatibility. Maps to ShowTitles.
|
||||
/// </summary>
|
||||
[System.Text.Json.Serialization.JsonIgnore]
|
||||
public bool? ShowLabels
|
||||
|
||||
@@ -9,37 +9,37 @@ namespace Microsoft.CmdPal.UI.ViewModels;
|
||||
public sealed class WindowPosition
|
||||
{
|
||||
/// <summary>
|
||||
/// Gets or sets left position in device pixels.
|
||||
/// Gets the left position in device pixels.
|
||||
/// </summary>
|
||||
public int X { get; init; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets top position in device pixels.
|
||||
/// Gets the top position in device pixels.
|
||||
/// </summary>
|
||||
public int Y { get; init; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets width in device pixels.
|
||||
/// Gets the width in device pixels.
|
||||
/// </summary>
|
||||
public int Width { get; init; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets height in device pixels.
|
||||
/// Gets the height in device pixels.
|
||||
/// </summary>
|
||||
public int Height { get; init; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets width of the screen in device pixels where the window is located.
|
||||
/// Gets the width of the screen in device pixels where the window is located.
|
||||
/// </summary>
|
||||
public int ScreenWidth { get; init; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets height of the screen in device pixels where the window is located.
|
||||
/// Gets the height of the screen in device pixels where the window is located.
|
||||
/// </summary>
|
||||
public int ScreenHeight { get; init; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets DPI (dots per inch) of the display where the window is located.
|
||||
/// Gets the DPI (dots per inch) of the display where the window is located.
|
||||
/// </summary>
|
||||
public int Dpi { get; init; }
|
||||
|
||||
|
||||
@@ -18,7 +18,7 @@ namespace Microsoft.CmdPal.UI.Events;
|
||||
public class CmdPalDockConfiguration : EventBase, IEvent
|
||||
{
|
||||
/// <summary>
|
||||
/// Gets or sets whether the dock is enabled.
|
||||
/// Gets or sets a value indicating whether the dock is enabled.
|
||||
/// </summary>
|
||||
public bool IsDockEnabled { get; set; }
|
||||
|
||||
|
||||
@@ -33,7 +33,7 @@ public class CmdPalExtensionInvoked : EventBase, IEvent
|
||||
public string CommandName { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets whether the command executed successfully.
|
||||
/// Gets or sets a value indicating whether the command executed successfully.
|
||||
/// </summary>
|
||||
public bool Success { get; set; }
|
||||
|
||||
|
||||
@@ -76,7 +76,7 @@ public class AllAppsSettings : JsonSettingsManager, ISettingsInterface
|
||||
};
|
||||
|
||||
/// <summary>
|
||||
/// Parsed search result limit. Returns <see langword="null"/> when the caller should
|
||||
/// Gets the parsed search result limit. Returns <see langword="null"/> when the caller should
|
||||
/// use its own default (unrecognized value, empty, or old stored "0").
|
||||
/// </summary>
|
||||
public int? SearchResultLimit
|
||||
|
||||
@@ -12,7 +12,7 @@ namespace Microsoft.CommandPalette.Extensions.Toolkit;
|
||||
public static class ShellHelpers
|
||||
{
|
||||
/// <summary>
|
||||
/// These are the executable file extensions that Windows Shell recognizes. Unlike CMD/PowerShell,
|
||||
/// Gets the executable file extensions that Windows Shell recognizes. Unlike CMD/PowerShell,
|
||||
/// Shell does not use PATHEXT, but has a magic fixed list.
|
||||
/// </summary>
|
||||
public static string[] ExecutableExtensions { get; } = [".PIF", ".COM", ".EXE", ".BAT", ".CMD"];
|
||||
|
||||
@@ -17,7 +17,7 @@ namespace PowerDisplay.Common.Utils
|
||||
public static class VcpNames
|
||||
{
|
||||
/// <summary>
|
||||
/// Optional delegate to provide localized VCP code names.
|
||||
/// Gets or sets the optional delegate to provide localized VCP code names.
|
||||
/// Set this at application startup to enable localization.
|
||||
/// The delegate receives a VCP code and should return the localized name, or null to use the default.
|
||||
/// </summary>
|
||||
|
||||
Reference in New Issue
Block a user