From 6d6fb9d764fdaa425fd9b7bcd9d8136732503445 Mon Sep 17 00:00:00 2001
From: Ruofan <zrfcfgs@outlook.com>
Date: Fri, 15 May 2026 14:35:04 +0800
Subject: [PATCH] Add Stretch for ContentAlignment on SettingsCard

---
 .../samples/SettingsPageExample.xaml             | 10 ++++++++++
 .../src/SettingsCard/SettingsCard.Properties.cs  |  7 ++++++-
 .../src/SettingsCard/SettingsCard.xaml           | 16 ++++++++++++++++
 3 files changed, 32 insertions(+), 1 deletion(-)

diff --git a/components/SettingsControls/samples/SettingsPageExample.xaml b/components/SettingsControls/samples/SettingsPageExample.xaml
index 1dad1eb0a..6891e7c66 100644
--- a/components/SettingsControls/samples/SettingsPageExample.xaml
+++ b/components/SettingsControls/samples/SettingsPageExample.xaml
@@ -57,6 +57,16 @@
                         <controls:SettingsCard ContentAlignment="Left">
                             <CheckBox Content="Here the ContentAlignment is set to Left. This is great for e.g. CheckBoxes or RadioButtons" />
                         </controls:SettingsCard>
+                        <controls:SettingsCard ContentAlignment="Stretch">
+                            <Border>
+                                <StackPanel>
+                                    <TextBlock TextWrapping="WrapWholeWords"
+                                               Text="Here the ContentAlignment is set to Stretch, so the content fills the entire card. This is great for controls like Sliders that benefit from having more space." />
+                                    <Slider Margin="0,10,0,0"
+                                            HorizontalAlignment="Stretch" />
+                                </StackPanel>
+                            </Border>
+                        </controls:SettingsCard>
                     </controls:SettingsExpander.Items>
                 </controls:SettingsExpander>
 
diff --git a/components/SettingsControls/src/SettingsCard/SettingsCard.Properties.cs b/components/SettingsControls/src/SettingsCard/SettingsCard.Properties.cs
index 559cc775a..5d437a966 100644
--- a/components/SettingsControls/src/SettingsCard/SettingsCard.Properties.cs
+++ b/components/SettingsControls/src/SettingsCard/SettingsCard.Properties.cs
@@ -211,5 +211,10 @@ public enum ContentAlignment
     /// <summary>
     /// The Content is vertically aligned.
     /// </summary>
-    Vertical
+    Vertical,
+
+    /// <summary>
+    /// The Content stretches and fills all the available space.
+    /// </summary>
+    Stretch
 }
diff --git a/components/SettingsControls/src/SettingsCard/SettingsCard.xaml b/components/SettingsControls/src/SettingsCard/SettingsCard.xaml
index 280caf7b4..763626cfc 100644
--- a/components/SettingsControls/src/SettingsCard/SettingsCard.xaml
+++ b/components/SettingsControls/src/SettingsCard/SettingsCard.xaml
@@ -370,6 +370,22 @@
                                             <Setter Target="PART_ContentPresenter.HorizontalContentAlignment" Value="{Binding HorizontalContentAlignment, RelativeSource={RelativeSource TemplatedParent}}" />
                                         </VisualState.Setters>
                                     </VisualState>
+
+                                    <!--  Union Left and Vertical, HeaderIcon/Header/Description collapsed, Content stretches and fills all the available space  -->
+                                    <VisualState x:Name="Stretch">
+                                        <VisualState.StateTriggers>
+                                            <tk:IsEqualStateTrigger Value="{Binding ContentAlignment, RelativeSource={RelativeSource TemplatedParent}}"
+                                                                    To="Stretch" />
+                                        </VisualState.StateTriggers>
+                                        <VisualState.Setters>
+                                            <Setter Target="PART_HeaderIconPresenterHolder.Visibility" Value="Collapsed" />
+                                            <Setter Target="PART_DescriptionPresenter.Visibility" Value="Collapsed" />
+                                            <Setter Target="PART_HeaderPresenter.Visibility" Value="Collapsed" />
+                                            <Setter Target="PART_ContentPresenter.(Grid.Row)" Value="1" />
+                                            <Setter Target="PART_ContentPresenter.(Grid.Column)" Value="1" />
+                                            <Setter Target="PART_ContentPresenter.HorizontalAlignment" Value="Stretch" />
+                                        </VisualState.Setters>
+                                    </VisualState>
                                 </VisualStateGroup>
 
                                 <!--  Collapsing the Content presenter whenever it's empty  -->