[C#/WINUI2.5] GridView 엘리먼트 : 커스텀 레이아웃 설정하기

■ GridView 엘리먼트에서 커스텀 레이아웃을 설정하는 방법을 보여준다.

▶ CustomItem.cs


using System;
using System.Collections.Generic;

namespace TestProject
{
    /// <summary>
    /// 커스텀 항목
    /// </summary>
    public class CustomItem
    {
        //////////////////////////////////////////////////////////////////////////////////////////////////// Property
        ////////////////////////////////////////////////////////////////////////////////////////// Public

        #region 제목 - Title

        /// <summary>
        /// 제목
        /// </summary>
        public string Title { get; set; }

        #endregion
        #region 이미지 위치 - ImageLocation

        /// <summary>
        /// 이미지 위치
        /// </summary>
        public string ImageLocation { get; set; }

        #endregion
        #region 조회 수 - Views

        /// <summary>
        /// 조회 수
        /// </summary>
        public string Views { get; set; }

        #endregion
        #region 좋아요 - Likes

        /// <summary>
        /// 좋아요
        /// </summary>
        public string Likes { get; set; }

        #endregion
        #region 설명 - Description

        /// <summary>
        /// 설명
        /// </summary>
        public string Description { get; set; }

        #endregion

        //////////////////////////////////////////////////////////////////////////////////////////////////// Constructor
        ////////////////////////////////////////////////////////////////////////////////////////// Public

        #region 생성자 - CustomItem()

        /// <summary>
        /// 생성자
        /// </summary>
        public CustomItem()
        {
        }

        #endregion

        //////////////////////////////////////////////////////////////////////////////////////////////////// Method
        ////////////////////////////////////////////////////////////////////////////////////////// Static
        //////////////////////////////////////////////////////////////////////////////// Public

        #region 리스트 구하기 - GetList()

        /// <summary>
        /// 리스트 구하기
        /// </summary>
        /// <returns>리스트</returns>
        public static List<CustomItem> GetList()
        {
            string[] textArray = new[]
            {
                "Lorem ipsum dolor sit amet, consectetur adipiscing elit. " +
                "Integer id facilisis lectus. "                             +
                "Cras nec convallis ante, quis pulvinar tellus. "           +
                "Integer dictum accumsan pulvinar. "                        +
                "Pellentesque eget enim sodales sapien vestibulum consequat.",
                "Nullam eget mattis metus. Donec pharetra, tellus in mattis tincidunt, magna ipsum gravida nibh, vitae lobortis ante odio vel quam.",
                "Quisque accumsan pretium ligula in faucibus. "                             +
                "Mauris sollicitudin augue vitae lorem cursus condimentum quis ac mauris. " +
                "Pellentesque quis turpis non nunc pretium sagittis. "                      +
                "Nulla facilisi. "                                                          +
                "Maecenas eu lectus ante. "                                                 +
                "Proin eleifend vel lectus non tincidunt. "                                 +
                "Fusce condimentum luctus nisi, in elementum ante tincidunt nec.",
                "Aenean in nisl at elit venenatis blandit ut vitae lectus. "                  +
                "Praesent in sollicitudin nunc. "                                             +
                "Pellentesque justo augue, pretium at sem lacinia, scelerisque semper erat. " +
                "Ut cursus tortor at metus lacinia dapibus.",
                "Ut consequat magna luctus justo egestas vehicula. " +
                "Integer pharetra risus libero, et posuere justo mattis et.",
                "Proin malesuada, libero vitae aliquam venenatis, diam est faucibus felis, vitae efficitur erat nunc non mauris. " +
                "Suspendisse at sodales erat.",
                "Aenean vulputate, turpis non tincidunt ornare, metus est sagittis erat, id lobortis orci odio eget quam. " +
                "Suspendisse ex purus, lobortis quis suscipit a, volutpat vitae turpis.",
                "Duis facilisis, quam ut laoreet commodo, elit ex aliquet massa, non varius tellus lectus et nunc. " +
                "Donec vitae risus ut ante pretium semper. "                                                         +
                "Phasellus consectetur volutpat orci, eu dapibus turpis. "                                           +
                "Fusce varius sapien eu mattis pharetra.",
            };

            Random random = new Random();

            const int listCount = 8;

            List<CustomItem> list = new List<CustomItem>();

            for(int i = 0; i < listCount; i++)
            {
                list.Add
                (
                    new CustomItem()
                    {
                        Title         = $"이미지 {i + 1}",
                        ImageLocation = $"/IMAGE/landscape{i + 1}.jpg",
                        Views         = random.Next(100, 999).ToString(),
                        Likes         = random.Next(10, 99).ToString(),
                        Description   = textArray[i % textArray.Length],
                    }
                );
            }

            return list;
        }

        #endregion
    }
}

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

using System;

using System.Collections.Generic;

namespace TestProject

{

/// <summary>

/// 커스텀 항목

/// </summary>

public class CustomItem

{

//////////////////////////////////////////////////////////////////////////////////////////////////// Property

////////////////////////////////////////////////////////////////////////////////////////// Public

#region 제목 - Title

/// <summary>

/// 제목

/// </summary>

public string Title { get; set; }

#endregion

#region 이미지 위치 - ImageLocation

/// <summary>

/// 이미지 위치

/// </summary>

public string ImageLocation { get; set; }

#endregion

#region 조회 수 - Views

/// <summary>

/// 조회 수

/// </summary>

public string Views { get; set; }

#endregion

#region 좋아요 - Likes

/// <summary>

/// 좋아요

/// </summary>

public string Likes { get; set; }

#endregion

#region 설명 - Description

/// <summary>

/// 설명

/// </summary>

public string Description { get; set; }

#endregion

//////////////////////////////////////////////////////////////////////////////////////////////////// Constructor

////////////////////////////////////////////////////////////////////////////////////////// Public

#region 생성자 - CustomItem()

/// <summary>

/// 생성자

/// </summary>

public CustomItem()

{

}

#endregion

//////////////////////////////////////////////////////////////////////////////////////////////////// Method

////////////////////////////////////////////////////////////////////////////////////////// Static

//////////////////////////////////////////////////////////////////////////////// Public

#region 리스트 구하기 - GetList()

/// <summary>

/// 리스트 구하기

/// </summary>

/// <returns>리스트</returns>

public static List<CustomItem> GetList()

{

string[] textArray = new[]

{

"Lorem ipsum dolor sit amet, consectetur adipiscing elit. " +

"Integer id facilisis lectus. " +

"Cras nec convallis ante, quis pulvinar tellus. " +

"Integer dictum accumsan pulvinar. " +

"Pellentesque eget enim sodales sapien vestibulum consequat.",

"Nullam eget mattis metus. Donec pharetra, tellus in mattis tincidunt, magna ipsum gravida nibh, vitae lobortis ante odio vel quam.",

"Quisque accumsan pretium ligula in faucibus. " +

"Mauris sollicitudin augue vitae lorem cursus condimentum quis ac mauris. " +

"Pellentesque quis turpis non nunc pretium sagittis. " +

"Nulla facilisi. " +

"Maecenas eu lectus ante. " +

"Proin eleifend vel lectus non tincidunt. " +

"Fusce condimentum luctus nisi, in elementum ante tincidunt nec.",

"Aenean in nisl at elit venenatis blandit ut vitae lectus. " +

"Praesent in sollicitudin nunc. " +

"Pellentesque justo augue, pretium at sem lacinia, scelerisque semper erat. " +

"Ut cursus tortor at metus lacinia dapibus.",

"Ut consequat magna luctus justo egestas vehicula. " +

"Integer pharetra risus libero, et posuere justo mattis et.",

"Proin malesuada, libero vitae aliquam venenatis, diam est faucibus felis, vitae efficitur erat nunc non mauris. " +

"Suspendisse at sodales erat.",

"Aenean vulputate, turpis non tincidunt ornare, metus est sagittis erat, id lobortis orci odio eget quam. " +

"Suspendisse ex purus, lobortis quis suscipit a, volutpat vitae turpis.",

"Duis facilisis, quam ut laoreet commodo, elit ex aliquet massa, non varius tellus lectus et nunc. " +

"Donec vitae risus ut ante pretium semper. " +

"Phasellus consectetur volutpat orci, eu dapibus turpis. " +

"Fusce varius sapien eu mattis pharetra.",

};

Random random = new Random();

const int listCount = 8;

List<CustomItem> list = new List<CustomItem>();

for(int i = 0; i < listCount; i++)

{

list.Add

(

new CustomItem()

{

Title = $"이미지 {i + 1}",

ImageLocation = $"/IMAGE/landscape{i + 1}.jpg",

Views = random.Next(100, 999).ToString(),

Likes = random.Next(10, 99).ToString(),

Description = textArray[i % textArray.Length],

}

);

}

return list;

}

#endregion

}

▶ MainPage.xaml


<Page x:Class="TestProject.MainPage"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:muxc="using:Microsoft.UI.Xaml.Controls"
    xmlns:local="using:TestProject"
    Background="{ThemeResource ApplicationPageBackgroundThemeBrush}"
    FontFamily="나눔고딕코딩"
    FontSize="16">
    <Page.Resources>
        <DataTemplate x:Key="ImageOverlayDataTemplateKey" x:DataType="local:CustomItem">
            <Grid AutomationProperties.Name="{x:Bind Title}"
                Width="100">
                <Image
                    Stretch="UniformToFill"
                    Source="{x:Bind ImageLocation}" />
                <StackPanel
                    VerticalAlignment="Bottom"
                    Height="40"
                    Orientation="Vertical"
                    Background="{ThemeResource SystemControlBackgroundBaseMediumBrush}"
                    Padding="5 1 5 1"
                    Opacity=".75">
                    <TextBlock
                        Foreground="{ThemeResource SystemControlForegroundAltHighBrush}"
                        Text="{x:Bind Title}" />
                    <StackPanel Orientation="Horizontal">
                        <TextBlock
                            Style="{ThemeResource CaptionTextBlockStyle}"
                            Foreground="{ThemeResource SystemControlForegroundAltHighBrush}"
                            Text="좋아요 : " />
                        <TextBlock
                            Style="{ThemeResource CaptionTextBlockStyle}"
                            Foreground="{ThemeResource SystemControlForegroundAltHighBrush}"
                            Text="{x:Bind Likes}" />
                    </StackPanel>
                </StackPanel>
            </Grid>
        </DataTemplate>
    </Page.Resources>
    <Grid>
        <Grid
            HorizontalAlignment="Center"
            VerticalAlignment="Center">
            <Grid.ColumnDefinitions>
                <ColumnDefinition Width="Auto" />
                <ColumnDefinition Width="50"   />
                <ColumnDefinition Width="Auto" />
            </Grid.ColumnDefinitions>
            <GridView Name="gridView" Grid.Column="0"
                ItemTemplate="{StaticResource ImageOverlayDataTemplateKey}">
                <GridView.ItemContainerStyle>
                    <Style TargetType="GridViewItem">
                        <Setter Property="Margin" Value="5" />
                    </Style>
                </GridView.ItemContainerStyle>
                <GridView.ItemsPanel>
                    <ItemsPanelTemplate>
                        <ItemsWrapGrid
                            Orientation="Horizontal"
                            MaximumRowsOrColumns="3"
                            Loaded="itemsWrapGrid_Loaded" />
                    </ItemsPanelTemplate>
                </GridView.ItemsPanel>
            </GridView>
            <StackPanel Grid.Column="2">
                <StackPanel.Resources>
                    <Style x:Key="DefaultNumberBoxStyleKey" TargetType="muxc:NumberBox">
                        <Setter Property="SpinButtonPlacementMode"    Value="Inline"  />
                        <Setter Property="SmallChange"                Value="1"       />
                        <Setter Property="HorizontalAlignment"        Value="Stretch" />
                        <Setter Property="HorizontalContentAlignment" Value="Stretch" />
                        <Setter Property="MaxWidth"                   Value="250"     />
                        <Setter Property="Margin"                     Value="0 0 0 0" />
                    </Style>
                </StackPanel.Resources>
                <muxc:NumberBox Name="columnSpaceNumberBox"
                    Style="{ThemeResource DefaultNumberBoxStyleKey}"
                    AutomationProperties.Name="space between columns"
                    Minimum="0"
                    Maximum="100"
                    Value="5"
                    Header="컬럼 간격"
                    ValueChanged="numberBox_ValueChanged" />
                <muxc:NumberBox Name="rowSpaceNumberBox"
                    Style="{ThemeResource DefaultNumberBoxStyleKey}"
                    AutomationProperties.Name="space between rows"
                    Margin="0 10 0 0"
                    Minimum="0"
                    Maximum="100"
                    Value="5"
                    Header="행 간격"
                    ValueChanged="numberBox_ValueChanged" />
                <muxc:NumberBox Name="wrapItemCountNumberBox"
                    Style="{ThemeResource DefaultNumberBoxStyleKey}"
                    AutomationProperties.Name="maximum number of items before wrapping"
                    Margin="0 10 0 0"
                    Minimum="1"
                    Maximum="8"
                    Value="3"
                    Header="랩핑 전 항목 최대 수"
                    ValueChanged="numberBox_ValueChanged" />
            </StackPanel>
        </Grid>
    </Grid>
</Page>

100

101

102

103

104

105

106

107

<Page x:Class="TestProject.MainPage"

xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"

xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"

xmlns:muxc="using:Microsoft.UI.Xaml.Controls"

xmlns:local="using:TestProject"

Background="{ThemeResource ApplicationPageBackgroundThemeBrush}"

FontFamily="나눔고딕코딩"

FontSize="16">

<Page.Resources>

<Grid AutomationProperties.Name="{x:Bind Title}"

Width="100">

<Image

Stretch="UniformToFill"

Source="{x:Bind ImageLocation}" />

<StackPanel

VerticalAlignment="Bottom"

Height="40"

Orientation="Vertical"

Background="{ThemeResource SystemControlBackgroundBaseMediumBrush}"

Padding="5 1 5 1"

Opacity=".75">

<TextBlock

Foreground="{ThemeResource SystemControlForegroundAltHighBrush}"

Text="{x:Bind Title}" />

<TextBlock

Style="{ThemeResource CaptionTextBlockStyle}"

Foreground="{ThemeResource SystemControlForegroundAltHighBrush}"

Text="좋아요 : " />

<TextBlock

Style="{ThemeResource CaptionTextBlockStyle}"

Foreground="{ThemeResource SystemControlForegroundAltHighBrush}"

Text="{x:Bind Likes}" />

</StackPanel>

</Grid>

</DataTemplate>

</Page.Resources>

<Grid>

<Grid

HorizontalAlignment="Center"

VerticalAlignment="Center">

<Grid.ColumnDefinitions>

</Grid.ColumnDefinitions>

<GridView Name="gridView" Grid.Column="0"

ItemTemplate="{StaticResource ImageOverlayDataTemplateKey}">

<GridView.ItemContainerStyle>

</Style>

</GridView.ItemContainerStyle>

<GridView.ItemsPanel>

<ItemsWrapGrid

Orientation="Horizontal"

MaximumRowsOrColumns="3"

Loaded="itemsWrapGrid_Loaded" />

</ItemsPanelTemplate>

</GridView.ItemsPanel>

</GridView>

<StackPanel.Resources>

</Style>

</StackPanel.Resources>

<muxc:NumberBox Name="columnSpaceNumberBox"

Style="{ThemeResource DefaultNumberBoxStyleKey}"

AutomationProperties.Name="space between columns"

Minimum="0"

Maximum="100"

Value="5"

Header="컬럼 간격"

ValueChanged="numberBox_ValueChanged" />

<muxc:NumberBox Name="rowSpaceNumberBox"

Style="{ThemeResource DefaultNumberBoxStyleKey}"

AutomationProperties.Name="space between rows"

Margin="0 10 0 0"

Minimum="0"

Maximum="100"

Value="5"

Header="행 간격"

ValueChanged="numberBox_ValueChanged" />

<muxc:NumberBox Name="wrapItemCountNumberBox"

Style="{ThemeResource DefaultNumberBoxStyleKey}"

AutomationProperties.Name="maximum number of items before wrapping"

Margin="0 10 0 0"

Minimum="1"

Maximum="8"

Value="3"

Header="랩핑 전 항목 최대 수"

ValueChanged="numberBox_ValueChanged" />

</StackPanel>

</Grid>

</Page>

▶ MainPage.xaml.cs


using Microsoft.UI.Xaml.Controls;
using System.Collections.Generic;
using System.Collections.ObjectModel;
using Windows.Foundation;
using Windows.Graphics.Display;
using Windows.UI.ViewManagement;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;

namespace TestProject
{
    /// <summary>
    /// 메인 페이지
    /// </summary>
    public sealed partial class MainPage : Page
    {
        //////////////////////////////////////////////////////////////////////////////////////////////////// Field
        ////////////////////////////////////////////////////////////////////////////////////////// Private

        #region Field

        /// <summary>
        /// 항목 랩 그리그
        /// </summary>
        private ItemsWrapGrid itemsWrapGrid = null;

        #endregion

        //////////////////////////////////////////////////////////////////////////////////////////////////// Constructor
        ////////////////////////////////////////////////////////////////////////////////////////// Public

        #region 생성자 - MainPage()

        /// <summary>
        /// 생성자
        /// </summary>
        public MainPage()
        {
            InitializeComponent();

            #region 윈도우 크기를 설정한다.

            double width  = 800d;
            double height = 600d;

            double dpi = (double)DisplayInformation.GetForCurrentView().LogicalDpi;

            ApplicationView.PreferredLaunchWindowingMode = ApplicationViewWindowingMode.PreferredLaunchViewSize;

            Size windowSize = new Size(width * 96d / dpi, height * 96d / dpi);

            ApplicationView.PreferredLaunchViewSize = windowSize;

            Window.Current.Activate();

            ApplicationView.GetForCurrentView().TryResizeView(windowSize);

            #endregion
            #region 윈도우 제목을 설정한다.

            ApplicationView.GetForCurrentView().Title = "GridView 엘리먼트 : 커스텀 레이아웃 설정하기";

            #endregion

            List<CustomItem> sourceList = CustomItem.GetList();

            ObservableCollection<CustomItem> sourceCollection = new ObservableCollection<CustomItem>(sourceList);

            this.gridView.ItemsSource = sourceCollection;
        }

        #endregion

        //////////////////////////////////////////////////////////////////////////////////////////////////// Method
        ////////////////////////////////////////////////////////////////////////////////////////// Private

        #region 항목 랩 그리그 로드시 처리하기 - itemsWrapGrid_Loaded(sender, e)

        /// <summary>
        /// 항목 랩 그리그 로드시 처리하기
        /// </summary>
        /// <param name="sender">이벤트 발생자</param>
        /// <param name="e">이벤트 인자</param>
        private void itemsWrapGrid_Loaded(object sender, RoutedEventArgs e)
        {
            this.itemsWrapGrid = sender as ItemsWrapGrid;
        }

        #endregion
        #region 숫자 박스 값 변경시 처리하기 - numberBox_ValueChanged(sender, e)

        /// <summary>
        /// 숫자 박스 값 변경시 처리하기
        /// </summary>
        /// <param name="sender">이벤트 발생자</param>
        /// <param name="e">이벤트 인자</param>
        private void numberBox_ValueChanged(NumberBox sender, NumberBoxValueChangedEventArgs e)
        {
            if(this.itemsWrapGrid == null)
            {
                return;
            }

            if(sender == this.wrapItemCountNumberBox)
            {
                this.itemsWrapGrid.MaximumRowsOrColumns = (int)this.wrapItemCountNumberBox.Value;

                return;
            }

            int rowSpace    = (int)this.rowSpaceNumberBox.Value;
            int columnSpace = (int)this.columnSpaceNumberBox.Value;

            for(int i = 0; i < this.gridView.Items.Count; i++)
            {
                GridViewItem item = this.gridView.ContainerFromIndex(i) as GridViewItem;

                Thickness newMargin = item.Margin;

                newMargin.Left   = columnSpace;
                newMargin.Top    = rowSpace;
                newMargin.Right  = columnSpace;
                newMargin.Bottom = rowSpace;

                item.Margin = newMargin;
            }
        }

        #endregion
    }
}

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

using Microsoft.UI.Xaml.Controls;

using System.Collections.Generic;

using System.Collections.ObjectModel;

using Windows.Foundation;

using Windows.Graphics.Display;

using Windows.UI.ViewManagement;

using Windows.UI.Xaml;

using Windows.UI.Xaml.Controls;

namespace TestProject

{

/// <summary>

/// 메인 페이지

/// </summary>

public sealed partial class MainPage : Page

{

//////////////////////////////////////////////////////////////////////////////////////////////////// Field

////////////////////////////////////////////////////////////////////////////////////////// Private

#region Field

/// <summary>

/// 항목 랩 그리그

/// </summary>

private ItemsWrapGrid itemsWrapGrid = null;

#endregion

//////////////////////////////////////////////////////////////////////////////////////////////////// Constructor

////////////////////////////////////////////////////////////////////////////////////////// Public

#region 생성자 - MainPage()

/// <summary>

/// 생성자

/// </summary>

public MainPage()

{

InitializeComponent();

#region 윈도우 크기를 설정한다.

double width = 800d;

double height = 600d;

double dpi = (double)DisplayInformation.GetForCurrentView().LogicalDpi;

ApplicationView.PreferredLaunchWindowingMode = ApplicationViewWindowingMode.PreferredLaunchViewSize;

Size windowSize = new Size(width * 96d / dpi, height * 96d / dpi);

ApplicationView.PreferredLaunchViewSize = windowSize;

Window.Current.Activate();

ApplicationView.GetForCurrentView().TryResizeView(windowSize);

#endregion

#region 윈도우 제목을 설정한다.

ApplicationView.GetForCurrentView().Title = "GridView 엘리먼트 : 커스텀 레이아웃 설정하기";

#endregion

List<CustomItem> sourceList = CustomItem.GetList();

ObservableCollection<CustomItem> sourceCollection = new ObservableCollection<CustomItem>(sourceList);

this.gridView.ItemsSource = sourceCollection;

}

#endregion

//////////////////////////////////////////////////////////////////////////////////////////////////// Method

////////////////////////////////////////////////////////////////////////////////////////// Private

#region 항목 랩 그리그 로드시 처리하기 - itemsWrapGrid_Loaded(sender, e)

/// <summary>

/// 항목 랩 그리그 로드시 처리하기

/// </summary>

/// <param name="sender">이벤트 발생자</param>

/// <param name="e">이벤트 인자</param>

private void itemsWrapGrid_Loaded(object sender, RoutedEventArgs e)

{

this.itemsWrapGrid = sender as ItemsWrapGrid;

}

#endregion

#region 숫자 박스 값 변경시 처리하기 - numberBox_ValueChanged(sender, e)

/// <summary>

/// 숫자 박스 값 변경시 처리하기

/// </summary>

/// <param name="sender">이벤트 발생자</param>

/// <param name="e">이벤트 인자</param>

private void numberBox_ValueChanged(NumberBox sender, NumberBoxValueChangedEventArgs e)

{

if(this.itemsWrapGrid == null)

{

return;

}

if(sender == this.wrapItemCountNumberBox)

{

this.itemsWrapGrid.MaximumRowsOrColumns = (int)this.wrapItemCountNumberBox.Value;

return;

}

int rowSpace = (int)this.rowSpaceNumberBox.Value;

int columnSpace = (int)this.columnSpaceNumberBox.Value;

for(int i = 0; i < this.gridView.Items.Count; i++)

{

GridViewItem item = this.gridView.ContainerFromIndex(i) as GridViewItem;

Thickness newMargin = item.Margin;

newMargin.Left = columnSpace;

newMargin.Top = rowSpace;

newMargin.Right = columnSpace;

newMargin.Bottom = rowSpace;

item.Margin = newMargin;

}

#endregion

}

TestProject.zip