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:
Clint Rutkas
2026-04-01 09:46:25 -07:00
committed by GitHub
parent 1314f68602
commit 565094abbe
14 changed files with 29 additions and 29 deletions

View File

@@ -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
{

View File

@@ -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;
}

View File

@@ -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;

View File

@@ -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;

View File

@@ -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; }
}

View File

@@ -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

View File

@@ -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; }

View File

@@ -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; }

View File

@@ -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; }

View File

@@ -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

View File

@@ -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"];

View File

@@ -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>