Bodenberg.AppDimens.Sdps.WinUI 3.6.1

Bodenberg.AppDimens.Sdps.WinUI

📖 Documentation: Bodenberg.AppDimens.Sdps.WinUI guide · complete API reference · all AppDimens .NET packages

Responsive sizes for WinUI 3 (Windows App SDK). Write {sdps:Sdp Value=16} instead of 16 and your margins, buttons and text adapt to the window — and are re-applied automatically when the user resizes the window or moves it to a monitor with another scale.

Same engine as Bodenberg.AppDimens.Maui.Sdps (Android sdp/ssp parity), packaged for WinUI 3 with no .NET MAUI dependency.

Table of contents

1. How it works
2. Step 1 — Install
3. Step 2 — Initialize in App.OnLaunched
4. Step 3 — Use it in XAML
5. Step 4 — Use it in C#
6. Complete example page
7. Which function should I use?
8. Bindings and x:Bind
9. Troubleshooting
10. Português (resumo)

How it works

• Keep the numbers you already use (16 for padding, 14 for text…).
• AppDimens treats them as sizes on a 300-unit-wide reference screen and scales them to the window.
• WinUI units are device-independent (effective pixels), so the result is right at any display scale.
• Values set with {sdps:...} in XAML are re-applied automatically when the window changes.

WinUI markup extensions need the property name: always write Value= → {sdps:Sdp Value=16}.

Step 1 — Install

dotnet add package Bodenberg.AppDimens.Sdps.WinUI

or Manage NuGet Packages… → search Bodenberg.AppDimens.Sdps.WinUI → Install.

Step 2 — Initialize in App.OnLaunched

Open App.xaml.cs and add one line after the window is created:

using AppDimens.Sdps.WinUI;

protected override void OnLaunched(Microsoft.UI.Xaml.LaunchActivatedEventArgs args)
{
    m_window = new MainWindow();
    AppDimensWinUI.Initialize(m_window);   // ← sizes now follow THIS window
    m_window.Activate();
}

Step 3 — Use it in XAML

1. Add the namespace to the root element (Window, Page or UserControl):

xmlns:sdps="using:AppDimens.Sdps.WinUI"

2. Replace fixed numbers:

<Button Width="120" Height="40" Margin="16" FontSize="14" Content="Save" />


<Button Width="{sdps:Sdp Value=120}"
        Height="{sdps:Hdp Value=40}"
        Margin="{sdps:Sdp Value=16}"
        FontSize="{sdps:Ssp Value=14}"
        Content="Save" />

Margin, Padding, CornerRadius and Grid row/column sizes are converted automatically.

Step 4 — Use it in C#

using AppDimens.Sdps.WinUI;   // 16.Sdp(), 14.Ssp() …

saveButton.Width   = 120.Sdp();
saveButton.Margin  = new Thickness(16.Sdp());
titleText.FontSize = 22.Ssp();

// values set from code: re-apply after a resize
AppDimensWinUI.Changed += (_, _) => titleText.FontSize = 22.Ssp();

Complete example page

<Page x:Class="MyApp.MainPage"
      xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
      xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
      xmlns:sdps="using:AppDimens.Sdps.WinUI">

    <Grid Padding="{sdps:Sdp Value=16}" RowSpacing="{sdps:Sdp Value=8}">
        <Grid.RowDefinitions>
            <RowDefinition Height="{sdps:Hdp Value=56}" />
            <RowDefinition Height="*" />
        </Grid.RowDefinitions>

        <TextBlock Text="Dashboard" FontSize="{sdps:Ssp Value=22}" VerticalAlignment="Center" />

        <Border Grid.Row="1" CornerRadius="{sdps:Sdp Value=12}" Padding="{sdps:Sdp Value=16}"
                Background="{ThemeResource CardBackgroundFillColorDefaultBrush}">
            <StackPanel Spacing="{sdps:Sdp Value=8}">
                <TextBlock Text="Resize the window: every size is recalculated."
                           FontSize="{sdps:Ssp Value=14}" TextWrapping="Wrap" />
                <Button Content="Save" Width="{sdps:Sdp Value=120}" />
            </StackPanel>
        </Border>
    </Grid>
</Page>

Which function should I use?

Extra options: Live=False (compute once) and As=Thickness|CornerRadius|GridLength|Double (force the type).

Bindings and x:Bind

<Page.Resources>
    <sdps:DimenConverter x:Key="Sdp" Function="Sdp" />
</Page.Resources>

<Border Width="{x:Bind ViewModel.CardWidth, Converter={StaticResource Sdp}}" />
<TextBlock FontSize="{x:Bind ViewModel.TitleSize, Converter={StaticResource Sdp}, ConverterParameter=Ssp}" />

Troubleshooting

Português (resumo)

1. Instale: dotnet add package Bodenberg.AppDimens.Sdps.WinUI
2. Em App.OnLaunched, depois de criar a janela: AppDimensWinUI.Initialize(m_window);
3. No XAML: xmlns:sdps="using:AppDimens.Sdps.WinUI" e troque números por {sdps:Sdp Value=16} (tamanhos), {sdps:Ssp Value=14} (texto), {sdps:Hdp Value=56} (altura), {sdps:Wdp Value=200} (largura).
4. Em C#: botao.Width = 120.Sdp(); — para atualizar no redimensionamento use AppDimensWinUI.Changed.

Links: Repository · WPF version · MAUI version