| -api-id | -api-type |
|---|---|
T:Windows.UI.Xaml.Controls.StackPanel |
winrt class |
Arranges child elements into a single line that can be oriented horizontally or vertically.
<StackPanel .../>
-or-
<StackPanel ...>
oneOrMoreChildren
</StackPanel>
Tip
For more info, design guidance, and code examples, see Layout panels.
StackPanel is a layout panel that arranges child elements into a single line that can be oriented horizontally or vertically.
:::image type="content" source="images/controls/StackPanel.png" alt-text="StackPanel layout control":::
By default, StackPanel stacks items vertically from top to bottom in the order they are declared. You can set the Orientation property to Horizontal to stack items from left to right.
You can insert items into a StackPanel at a specific location using the InsertAt method in code-behind.
StackPanel defines border properties that let you draw a border around the StackPanel without using an additional Border element. The properties are StackPanel.BorderBrush, StackPanel.BorderThickness, StackPanel.CornerRadius, and StackPanel.Padding.
<StackPanel BorderBrush="Red" BorderThickness="2" CornerRadius="10" Padding="12">
<TextBlock Text="Hello World!"/>
</StackPanel>| Windows version | SDK version | Value added |
|---|---|---|
| 1607 | 14393 | GetInsertionIndexes |
| 1709 | 16299 | Spacing |
| 1809 | 17763 | BackgroundSizing |
Tip
For more info, design guidance, and code examples, see Stack panel.
[!div class="nextstepaction"] Open the WinUI 2 Gallery app and see the StackPanel in action
The WinUI 2 Gallery app includes interactive examples of most WinUI 2 controls, features, and functionality. Get the app from the Microsoft Store or get the source code on GitHub.
The following example shows how to create a StackPanel of items.
[!code-xamlLayoutOvwStackPanel_1]
[!code-xaml02]
[!code-csharp01]
[!code-vb01]
Panel, IScrollSnapPointsInfo, Layout panels, Define layouts, Alignment, margin, and padding, Canvas, Grid, ItemsStackPanel, VariableSizedWrapGrid, VirtualizingStackPanel, Controls list, Controls by function