2502-V100-CommandLinkButton-needs-some-work (#2505)

* 2502-V100-CommandLinkButton-needs-some-work
- See issue for full details
- And the changelog

* 2502-V100-CommandLinkButton-needs-some-work
- See issue for full details
- And the changelog

* 2502-V100-CommandLinkButton-needs-some-work
- See issue for full details
- And the changelog

Author: giduac

Documents/Changelog/Changelog.md

@@ -3,6 +3,7 @@
 ====
 
 ## 2025-11-xx - Build 2511 (V10 - alpha) - November 2025
+* Resolved [#2502](https://github.com/Krypton-Suite/Standard-Toolkit/issues/2502), **[Breaking Change]** `KryptonCommandLinkButton` updates several properties and their behaviour. See issue for full details.
 * Resolved [#2495](https://github.com/Krypton-Suite/Standard-Toolkit/issues/2495), `KryptonProgressBar` private field `_mementoContent` can be null.
 * Resolved [#2490](https://github.com/Krypton-Suite/Standard-Toolkit/issues/2490), `KryptonComboBox` uses an incorrect Items editor string.
 * Resolved [#2487](https://github.com/Krypton-Suite/Standard-Toolkit/issues/2487), `PaletteBase.PalettePaint` event is not synchronized toward the user.

Source/Krypton Components/Krypton.Toolkit/Controls Toolkit/KryptonCommandLinkButton.cs

@@ -92,8 +92,7 @@ public KryptonCommandLinkButton()
         _useMnemonic = true;
 
         // Create content storage
-        CommandLinkImageValues = new CommandLinkImageValues(NeedPaintDelegate);
-        CommandLinkImageValues.Image = CommandLinkImageResources.Windows_11_CommandLink_Arrow;
+        UACShieldIcon = new CommandLinkImageValues(NeedPaintDelegate);
         CommandLinkTextValues = new CommandLinkTextValues(NeedPaintDelegate, GetDpiFactor);
 
         // Create the palette storage
@@ -129,7 +128,7 @@ public KryptonCommandLinkButton()
             _overrideTracking,
             _overridePressed,
             new PaletteMetricRedirect(Redirector),
-            CommandLinkImageValues, CommandLinkTextValues,
+            UACShieldIcon, CommandLinkTextValues,
             Orientation,
             UseMnemonic)
         {
@@ -162,16 +161,20 @@ public KryptonCommandLinkButton()
     /// <summary>
     /// Gets and sets the automatic resize of the control to fit contents.
     /// </summary>
-    [Browsable(false)]
+    [Browsable(true)]
     [Localizable(false)]
-    [EditorBrowsable(EditorBrowsableState.Never)]
-    [DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
+    [EditorBrowsable(EditorBrowsableState.Always)]
+    [DesignerSerializationVisibility(DesignerSerializationVisibility.Visible)]
     public override bool AutoSize
     {
         get => base.AutoSize;
+
         set
         {
-            // Do nothing }
+            if (base.AutoSize != value)
+            {
+                base.AutoSize = value;
+            }
         }
     }
 
@@ -229,7 +232,6 @@ public virtual VisualOrientation Orientation
 
                 // Update the associated visual elements that are effected
                 _drawCommandLinkButton.Orientation = value;
-
                 PerformNeedPaint(true);
             }
         }
@@ -273,7 +275,7 @@ public ButtonStyle ButtonStyle
     [Category("CommandLink")]
     [Description("CommandLink Button Image")]
     [DesignerSerializationVisibility(DesignerSerializationVisibility.Content)]
-    public CommandLinkImageValues CommandLinkImageValues { get; }
+    public CommandLinkImageValues UACShieldIcon { get; }
 
     private bool ShouldSerializeValues() => false;
 
@@ -604,30 +606,14 @@ protected override void ContextMenuClosed()
     /// <inheritdoc />
     protected override void OnPaint(PaintEventArgs? e)
     {
-        StateCommon.Content.LongText.Font = CommandLinkTextValues.DescriptionFont != null
-            ? CommandLinkTextValues.DescriptionFont
-            : null;
-
-        StateCommon.Content.ShortText.Font =
-            CommandLinkTextValues.HeadingFont != null
-                ? CommandLinkTextValues.HeadingFont
-                : null;
-
-        StateCommon.Content.LongText.TextH = CommandLinkTextValues.DescriptionTextHAlignment != null
-            ? CommandLinkTextValues.DescriptionTextHAlignment ?? PaletteRelativeAlign.Near
-            : PaletteRelativeAlign.Near;
-
-        StateCommon.Content.LongText.TextV = CommandLinkTextValues.DescriptionTextVAlignment != null
-            ? CommandLinkTextValues.DescriptionTextVAlignment ?? PaletteRelativeAlign.Far
-            : PaletteRelativeAlign.Far;
-
-        StateCommon.Content.ShortText.TextH = CommandLinkTextValues.HeadingTextHAlignment != null
-            ? CommandLinkTextValues.HeadingTextHAlignment ?? PaletteRelativeAlign.Near
-            : PaletteRelativeAlign.Near;
-
-        StateCommon.Content.ShortText.TextV = CommandLinkTextValues.HeadingTextVAlignment != null
-            ? CommandLinkTextValues.HeadingTextVAlignment ?? PaletteRelativeAlign.Center
-            : PaletteRelativeAlign.Center;
+        StateCommon.Content.LongText.Font = CommandLinkTextValues.DescriptionFont;
+        StateCommon.Content.ShortText.Font = CommandLinkTextValues.HeadingFont;
+
+        StateCommon.Content.LongText.TextH = CommandLinkTextValues.DescriptionTextHAlignment;
+        StateCommon.Content.LongText.TextV = CommandLinkTextValues.DescriptionTextVAlignment;
+
+        StateCommon.Content.ShortText.TextH = CommandLinkTextValues.HeadingTextHAlignment;
+        StateCommon.Content.ShortText.TextV = CommandLinkTextValues.HeadingTextVAlignment;
 
         base.OnPaint(e);
     }

Source/Krypton Components/Krypton.Toolkit/Designers/Action Lists/KryptonCommandLinkButtonActionList.cs

@@ -106,14 +106,14 @@ public string Description
     /// </summary>
     public Image? Image
     {
-        get => _button.CommandLinkImageValues.Image;
+        get => _button.CommandLinkTextValues.Image;
 
         set
         {
-            if (_button.CommandLinkImageValues.Image != value)
+            if (_button.CommandLinkTextValues.Image != value)
             {
-                _service?.OnComponentChanged(_button, null, _button.CommandLinkImageValues.Image, value);
-                _button.CommandLinkImageValues.Image = value;
+                _service?.OnComponentChanged(_button, null, _button.CommandLinkTextValues.Image, value);
+                _button.CommandLinkTextValues.Image = value;
             }
         }
     }

Source/Krypton Components/Krypton.Toolkit/Utilities/UACShieldIconSize.cs

@@ -12,8 +12,6 @@ namespace Krypton.Toolkit;
 /// <summary>Defines the UAC shield image size for a <see cref="KryptonButton"/>.</summary>
 public enum UACShieldIconSize
 {
-    // <summary>A custom image size.</summary>
-    // Custom = 0,
     /// <summary>The extra small image size (16 x 16).</summary>
     ExtraSmall = 1,
     /// <summary>The small image size (32 x 32).</summary>