WrapPanel

이후에는 Orientation 속성 값에 따라 순서가 위에서 아래로 또는 오른쪽에서 왼쪽으로 순차적으로 지정됩니다.

WrapPanel 위치 자식 컨트롤은 방향, 가로 방향(기본값) 위치에 따라 컨트롤을 왼쪽에서 오른쪽으로, 세로 방향 위치는 위쪽에서 아래쪽으로 컨트롤을 배치하며, 최대 너비 또는 높이에 도달하면 컨트롤은 방향에 따라 행 또는 열을 자동으로 만듭니다.

HorizontalSpacing 및 VerticalSpacing 속성을 사용하여 항목 간에 간격을 자동으로 추가할 수 있습니다. 방향이 Horizontal이면 HorizontalSpacing은 각 개별 항목 사이에 균일한 가로 간격을 추가하고 VerticalSpacing은 항목의 각 행 사이에 균일한 간격을 추가합니다.

방향이 세로이면 HorizontalSpacing은 항목의 각 열 사이에 균일한 간격을 추가하고 VerticalSpacing은 개별 항목 간에 균일한 세로 간격을 추가합니다.

<!--  Licensed to the .NET Foundation under one or more agreements. The .NET Foundation licenses this file to you under the MIT license. See the LICENSE file in the project root for more information.  -->
<Page x:Class="PrimitivesExperiment.Samples.WrapPanelSample"
      xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
      xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
      xmlns:attributes="using:CommunityToolkit.Tooling.SampleGen.Attributes"
      xmlns:controls="using:CommunityToolkit.WinUI.Controls"
      xmlns:local="using:PrimitivesExperiment.Samples"
      xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
      xmlns:muxc="using:Microsoft.UI.Xaml.Controls"
      x:Name="ThisSamplePage">

    <Page.Resources>
        <DataTemplate x:Key="PhotoTemplate">
            <Grid Width="{Binding Width}"
                  Height="{Binding Height}"
                  Margin="0">
                <Image HorizontalAlignment="Center"
                       Stretch="UniformToFill">
                    <Image.Source>
                        <BitmapImage DecodePixelHeight="200"
                                     UriSource="{Binding Thumbnail}" />
                    </Image.Source>
                </Image>
                <Border VerticalAlignment="Bottom">
                    <Border.Background>
                        <LinearGradientBrush EndPoint="0,1">
                            <GradientStop Offset="0" Color="Transparent" />
                            <GradientStop Offset="1" Color="#33000000" />
                        </LinearGradientBrush>
                    </Border.Background>
                    <TextBlock Margin="5,20,5,5"
                               VerticalAlignment="Bottom"
                               Foreground="White"
                               Text="{Binding Category}" />
                </Border>
            </Grid>
        </DataTemplate>
        <Style TargetType="ListViewItem">
            <!--  Change those values to change the WrapPanel's children alignment  -->
            <Setter Property="VerticalContentAlignment" Value="Center" />
            <Setter Property="HorizontalContentAlignment" Value="Center" />
            <Setter Property="Margin" Value="0" />
            <Setter Property="Padding" Value="0" />
            <Setter Property="MinWidth" Value="0" />
            <Setter Property="MinHeight" Value="0" />
        </Style>
    </Page.Resources>

    <Grid>
        <Grid.RowDefinitions>
            <RowDefinition Height="Auto" />
            <RowDefinition Height="*" />
        </Grid.RowDefinitions>
        <StackPanel Orientation="Horizontal"
                    Spacing="4">
            <Button Click="AddButton_Click"
                    Content="Add random sized image" />
            <Button Click="AddFixedBtn_Click"
                    Content="Add fixed sized image" />
            <Button Click="SwitchBtn_Click"
                    Content="Switch Orientation" />
        </StackPanel>
        <ListView Name="WrapPanelContainer"
                  Grid.Row="1"
                  IsItemClickEnabled="True"
                  ItemClick="ItemControl_ItemClick"
                  ItemTemplate="{StaticResource PhotoTemplate}"
                  ItemsSource="{x:Bind WrapPanelCollection, Mode=OneWay}">
            <ItemsControl.ItemsPanel>
                <ItemsPanelTemplate>
                    <controls:WrapPanel x:Name="sampleWrapPanel"
                                        Padding="12"
                                        HorizontalSpacing="{Binding HorizontalSpacing, ElementName=ThisSamplePage, Mode=OneWay}"
                                        VerticalSpacing="{Binding VerticalSpacing, ElementName=ThisSamplePage, Mode=OneWay}" />
                </ItemsPanelTemplate>
            </ItemsControl.ItemsPanel>
        </ListView>
    </Grid>
</Page>

// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
// See the LICENSE file in the project root for more information.

using CommunityToolkit.WinUI;

// TODO: Discuss with Uno folks about their own internal WrapPanel implementation.
using WrapPanel = CommunityToolkit.WinUI.Controls.WrapPanel;

namespace PrimitivesExperiment.Samples;

[ToolkitSampleNumericOption("HorizontalSpacing", initial: 5, min: 0, max: 200, step: 1, Title = "Horizontal Spacing")]
[ToolkitSampleNumericOption("VerticalSpacing", initial: 5, min: 0, max: 200, step: 1, Title = "VerticalSpacing")]

[ToolkitSample(id: nameof(WrapPanelSample), "WrapPanel", description: $"A sample for showing how to create and use a {nameof(WrapPanel)}.")]
public sealed partial class WrapPanelSample : Page
{
    private static readonly Random Rand = new Random();
    private ObservableCollection<PhotoDataItemWithDimension> WrapPanelCollection = new();

    public WrapPanelSample()
    {
        this.InitializeComponent();
    }

    private void ItemControl_ItemClick(object sender, ItemClickEventArgs e)
    {
        var item = e.ClickedItem as PhotoDataItemWithDimension;
        if (item == null)
        {
            return;
        }

        WrapPanelCollection.Remove(item);
    }

    private void AddButton_Click(object sender, RoutedEventArgs e)
    {
        WrapPanelCollection.Add(new PhotoDataItemWithDimension
        {
            Category = "Remove",
            Thumbnail = "ms-appx:///Assets/BigFourSummerHeat.jpg",
            Width = Rand.Next(60, 180),
            Height = Rand.Next(40, 140)
        });
    }

    private void AddFixedBtn_Click(object sender, RoutedEventArgs e)
    {
        WrapPanelCollection.Add(new PhotoDataItemWithDimension
        {
            Category = "Remove",
            Thumbnail = "ms-appx:///Assets/BigFourSummerHeat.jpg",
            Width = 150,
            Height = 100
        });
    }

    private void SwitchBtn_Click(object sender, RoutedEventArgs e)
    {
        if (WrapPanelContainer.FindDescendant<WrapPanel>() is WrapPanel sampleWrapPanel)
        {
            if (sampleWrapPanel.Orientation == Orientation.Horizontal)
            {
                sampleWrapPanel.Orientation = Orientation.Vertical;
                ScrollViewer.SetVerticalScrollMode(WrapPanelContainer, ScrollMode.Disabled);
                ScrollViewer.SetVerticalScrollBarVisibility(WrapPanelContainer, ScrollBarVisibility.Disabled);
                ScrollViewer.SetHorizontalScrollMode(WrapPanelContainer, ScrollMode.Auto);
                ScrollViewer.SetHorizontalScrollBarVisibility(WrapPanelContainer, ScrollBarVisibility.Auto);
            }
            else
            {
                sampleWrapPanel.Orientation = Orientation.Horizontal;
                ScrollViewer.SetVerticalScrollMode(WrapPanelContainer, ScrollMode.Auto);
                ScrollViewer.SetVerticalScrollBarVisibility(WrapPanelContainer, ScrollBarVisibility.Auto);
                ScrollViewer.SetHorizontalScrollMode(WrapPanelContainer, ScrollMode.Disabled);
                ScrollViewer.SetHorizontalScrollBarVisibility(WrapPanelContainer, ScrollBarVisibility.Disabled);
            }
        }
    }

    public class PhotoDataItemWithDimension : PhotoDataItem
    {
        public double Width { get; set; }
        public double Height { get; set; }
    }

    public class PhotoDataItem
    {
        public string? Title { get; set; }

        public string? Category { get; set; }

        public string? Thumbnail { get; set; }

        public override string ToString()
        {
            return Title!;
        }
    }
}

예제

WrapPanel 컨트롤을 추가하는 다음 예제입니다.

<Page ....
      xmlns:controls="using:CommunityToolkit.WinUI.Controls">

    <Grid Background="{StaticResource Brush-Grey-05}">
        <Grid.RowDefinitions>
            <RowDefinition />
            <RowDefinition />
        </Grid.RowDefinitions>
        <Grid>
            <Grid.RowDefinitions>
                <RowDefinition Height="50" />
                <RowDefinition />
            </Grid.RowDefinitions>
            <Button Name="HorizontalButton" Click="HorizontalButton_Click" Content="Add Horizontal Control" />
            <controls:WrapPanel Name="HorizontalWrapPanel" Grid.Row="1" Margin="2" />
        </Grid>

        <Grid Grid.Row="1">
            <Grid.RowDefinitions>
                <RowDefinition Height="50" />
                <RowDefinition />
            </Grid.RowDefinitions>
            <Button Name="VerticalButton" Click="VerticalButton_Click" Content="Add Vertical Control" />
            <controls:WrapPanel Name="VerticalWrapPanel" Grid.Row="1" Margin="2"
                                 VerticalSpacing="10" HorizontalSpacing="10" Orientation="Vertical" />
        </Grid>
    </Grid>
</Page>