WPF 기반 Windows 파일 탐색기 사용자 인터페이스 구현

WPF(Windows Presentation Foundation)를 활용하여 Windows 파일 탐색기와 유사한 기능을 구현하는 방법에 대해 소개합니다. 때때로 우리는 애플리케이션 내에서 로컬 파일 시스템을 관리해야 할 필요를 느낍니다. 물론, Microsoft.Win32 네임스페이스의 OpenFileDialog 클래스를 사용하여 파일 탐색 및 가져오기 기능을 구현할 수 있지만, 더 많은 기능을 통합하거나 사용자 지정 UI로 직접 제어해야 할 경우도 있습니다. OpenFileDialog는 UserControl로 재사용할 수 없으므로, 이러한 요구사항을 충족시키기 위해서는 자체적인 파일 관리 컴포넌트를 개발해야 합니다.

여기서는 Windows 파일 탐색기의 일부 핵심 기능을 구현하며, 이 과정을 통해 WPF의 MVVM(Model-View-ViewModel) 패턴과 기본적인 소프트웨어 설계 원칙을 심화 이해하는 데 중점을 둡니다.

전체 구조 개요

구현할 사용자 인터페이스는 크게 세 가지 영역으로 구성됩니다:

  1. 파일 및 폴더 목록 표시 영역: 현재 디렉토리의 파일과 하위 폴더를 표시합니다.
  2. 탐색 컨트롤 영역: 뒤로, 앞으로, 상위 폴더 이동과 같은 빠른 탐색 기능을 제공합니다.
  3. 경로 표시 영역: 현재 디렉토리의 전체 경로를 시각적으로 표시하며, 경로 요소 클릭을 통한 이동을 지원합니다.

이 세 영역은 서로 높은 상호작용성을 가지므로, 일반적으로 각각을 별도의 UserControl로 구성하고 하나의 공통 ViewModel에 바인딩하여 관리하는 방법이 사용됩니다. 그러나 이 예제에서는 각 부분을 별도의 ViewModel로 분리하여 역할 분담을 시도했습니다. 이 방식은 코드 복잡도를 증가시킬 수 있으며, ViewModel 간의 통신 및 결합 관리에 대한 추가적인 고려가 필요함을 보여줍니다. 이러한 경험을 통해 소프트웨어 설계 시 적절한 모듈화 및 책임 분리의 중요성을 되돌아볼 수 있습니다.

1. 파일 및 폴더 목록 (FileList)

이 영역은 현재 디렉토리의 파일과 폴더를 표시하는 핵심 부분입니다. 여기서는 커스터마이징된 DataGrid를 사용하여 구현합니다.

<UserControl x:Class="FileSelectorDemo.Views.FileList"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" 
             xmlns:converter="clr-namespace:FileSelectorDemo.Converters"
             xmlns:d="http://schemas.microsoft.com/expression/blend/2008" 
             xmlns:behaviors="clr-namespace:FileSelectorDemo.Behaviors"
             xmlns:local="clr-namespace:FileSelectorDemo.Views"
             mc:Ignorable="d" 
             d:DesignHeight="300" d="DesignWidth=300">
    <UserControl.Resources>
        <converter:CountToVisibilityConverter x:Key="CountToVisibilityConverter"/>
        <converter:TypeToVisibleConverter x:Key="TypeToVisibleConverter"/>
        <converter:TypeToCollapsedConverter x:Key="TypeToCollapsedConverter"/>
        <converter:CollectionSelectedCountConverter x:Key="CollectionSelectedCountConverter"/>       
    </UserControl.Resources>
    <Grid>      
        <ScrollViewer HorizontalScrollBarVisibility="Auto" VerticalScrollBarVisibility="Auto">
            <Grid>
                <StackPanel Orientation="Vertical">
                    <DataGrid x:Name="fileListDataGrid" Style="{StaticResource DefaultDataGrid}" HorizontalAlignment="Stretch" VerticalAlignment="Stretch" 
                              behaviors:DoubleClickBehavior.Command="{Binding OpenCurrentDirectoryCommand}"
                              behaviors:DoubleClickBehavior.CommandParameter="{Binding SelectedItem,RelativeSource={RelativeSource Self}}"  
                              IsReadOnly="True"
                              behaviors:MouseLeftButtonUpClickBehavior.Command="{Binding SelectFileListItemCommand}" 
                              ItemsSource="{Binding CurrentFileList}"  
                              CanUserAddRows="False"  
                              AutoGenerateColumns="False" 
                              GridLinesVisibility="None"
                              SelectionUnit="FullRow"
                              SelectionMode="Extended">
                        <DataGrid.Columns>
                            <DataGridTemplateColumn MinWidth="60">
                                <DataGridTemplateColumn.Header>
                                    <CheckBox Content="모두 선택" Margin="2" FontSize="12" HorizontalAlignment="Center" VerticalAlignment="Center" 
                                              IsChecked="{Binding DataContext.IsSelectAllChecked,RelativeSource={RelativeSource Mode=FindAncestor,AncestorType={x:Type DataGrid}}}"/>
                                </DataGridTemplateColumn.Header>
                                <DataGridTemplateColumn.CellTemplate>
                                    <DataTemplate>
                                        <Grid HorizontalAlignment="Center" VerticalAlignment="Center">
                                            <TextBlock Text="선택 불가" FontSize="12" Foreground="Black" 
                                                       Visibility="{Binding ItemType,Converter={StaticResource TypeToCollapsedConverter}}" 
                                                       HorizontalAlignment="Left" VerticalAlignment="Center" />
                                            <CheckBox IsChecked="{Binding IsSelected,Mode=TwoWay,UpdateSourceTrigger=PropertyChanged}" 
                                                      IsThreeState="False" IsHitTestVisible="False" 
                                                      Visibility="{Binding ItemType,Converter={StaticResource TypeToVisibleConverter}}"  
                                                      HorizontalAlignment="Left" VerticalAlignment="Center" ToolTip="현재 항목 선택"/>
                                        </Grid>
                                    </DataTemplate>
                                </DataGridTemplateColumn.CellTemplate>
                            </DataGridTemplateColumn>
                            <DataGridTemplateColumn Header="이름" >
                                <DataGridTemplateColumn.CellTemplate>
                                    <DataTemplate>
                                        <StackPanel Orientation="Horizontal" HorizontalAlignment="Left" VerticalAlignment="Center">
                                            <Image Source="{Binding Icon}" Margin="2" HorizontalAlignment="Center" VerticalAlignment="Center"/>
                                            <TextBlock Text="{Binding Name}" Margin="2" HorizontalAlignment="Center" VerticalAlignment="Center"/>
                                        </StackPanel>
                                    </DataTemplate>
                                </DataGridTemplateColumn.CellTemplate>
                            </DataGridTemplateColumn>
                            <DataGridTextColumn Header="수정일" Binding="{Binding LastModifiedDate}"/>
                            <DataGridTextColumn Header="유형" Binding="{Binding ItemType}"/>
                            <DataGridTextColumn Header="크기" Binding="{Binding Size}"/>
                        </DataGrid.Columns>
                    </DataGrid>
                    <TextBlock Margin="2 5" HorizontalAlignment="Left" VerticalAlignment="Center" >
                        <Run>총 </Run>
                        <Run Text="{Binding CurrentFileList.Count,Mode=OneWay}"/>
                        <Run> 개 항목</Run>
                        <Run>(선택됨 </Run>
                        <Run Text="{Binding CurrentFileList,Converter={StaticResource CollectionSelectedCountConverter},Mode=OneWay}"/>
                        <Run> 개 항목)</Run>
                    </TextBlock>
                </StackPanel>
                <TextBlock Text="이 폴더는 비어있습니다."  Visibility="{Binding CurrentFileList.Count,Converter={StaticResource CountToVisibilityConverter}}" 
                           HorizontalAlignment="Center" VerticalAlignment="Center"/>
            </Grid>
        </ScrollViewer>          
    </Grid>
</UserControl>

DataGrid의 스타일은 일반적으로 별도의 리소스 딕셔너리에 정의됩니다. 다음은 DataGrid 설정 시 고려해야 할 주요 속성들입니다:

  1. IsReadOnly="True": 사용자가 그리드 셀을 직접 편집하지 못하도록 방지합니다.
  2. GridLinesVisibility="None": 그리드의 구분선을 표시하지 않아 Windows 네이티브 UI와 유사하게 만듭니다.
  3. CanUserAddRows="False": 그리드 하단에 새 행을 추가할 수 있는 빈 행이 표시되는 것을 방지합니다.
  4. AutoGenerateColumns="False": 데이터 소스의 속성을 기반으로 열이 자동으로 생성되는 것을 막고, 사용자 지정 열만 사용합니다.
  5. SelectionUnit="FullRow": 마우스 클릭 시 전체 행이 선택되도록 합니다.
  6. SelectionMode="Extended": Ctrl 키를 누른 채 클릭하여 여러 항목을 선택하는 다중 선택을 허용합니다.
  7. 가상화(Virtualization): 대량의 데이터를 효율적으로 처리하기 위해 다음과 같이 가상화 속성을 설정합니다.
    <Setter Property="VirtualizingStackPanel.IsVirtualizing" Value="True"/>
    <Setter Property="VirtualizingStackPanel.VirtualizationMode" Value="Recycling" />
    

    VirtualizingStackPanel.VirtualizationMode가 Recycling으로 설정되면, 스크롤되어 화면 밖으로 나간 아이템 컨테이너를 버리지 않고 재사용하여 성능을 향상시킵니다. 이는 항목 수가 많을 때 특히 유용합니다.

사용자 지정 이벤트 동작 (Attached Property)

DataGrid 행을 두 번 클릭하면 해당 하위 폴더가 열리고, 한 번 클릭하면 현재 행이 선택되도록 합니다. 이 이벤트 바인딩은 System.Windows.Interactivity 대신 사용자 지정 Attached Property를 사용하여 구현합니다. 다음은 마우스 더블클릭 이벤트를 ViewModel의 커맨드와 연결하는 Attached Property 예시입니다.

using System.Windows;
using System.Windows.Controls;
using System.Windows.Input;
using System.Windows.Media;

namespace FileSelectorDemo.Behaviors
{
    public class DoubleClickBehavior
    {
        public static readonly DependencyProperty CommandProperty =
            DependencyProperty.RegisterAttached("Command",
                typeof(ICommand),
                typeof(DoubleClickBehavior),
                new UIPropertyMetadata(OnCommandChanged));

        public static readonly DependencyProperty CommandParameterProperty =
            DependencyProperty.RegisterAttached("CommandParameter",
                                                typeof(object),
                                                typeof(DoubleClickBehavior),
                                                new UIPropertyMetadata(null));

        public static void SetCommand(DependencyObject target, ICommand value)
        {
            target.SetValue(CommandProperty, value);
        }

        public static ICommand GetCommand(DependencyObject target)
        {
            return (ICommand)target.GetValue(CommandProperty);
        }

        public static void SetCommandParameter(DependencyObject target, object value)
        {
            target.SetValue(CommandParameterProperty, value);
        }

        public static object GetCommandParameter(DependencyObject target)
        {
            return target.GetValue(CommandParameterProperty);
        }

        private static void OnCommandChanged(DependencyObject target, DependencyPropertyChangedEventArgs e)
        {
            if (target is Control control)
            {
                if (e.NewValue != null && e.OldValue == null)
                {
                    control.MouseDoubleClick += HandleMouseDoubleClick;
                }
                else if (e.NewValue == null && e.OldValue != null)
                {
                    control.MouseDoubleClick -= HandleMouseDoubleClick;
                }
            }
        }

        private static void HandleMouseDoubleClick(object sender, MouseButtonEventArgs e)
        {
            if (sender is DataGrid dataGrid)
            {
                Point mousePosition = e.GetPosition(dataGrid);
                IInputElement hitTestResult = dataGrid.InputHitTest(mousePosition);
                DependencyObject target = hitTestResult as DependencyObject;

                while (target != null)
                {
                    if (target is DataGridRow)
                    {
                        ICommand command = GetCommand(dataGrid);
                        object commandParameter = GetCommandParameter(dataGrid);
                        if (command != null && command.CanExecute(commandParameter))
                        {
                            command.Execute(commandParameter);
                        }
                        break;
                    }
                    target = VisualTreeHelper.GetParent(target);
                }
            }
        }
    }
}

이 Attached Property는 XAML에서 다음과 같이 사용됩니다:

behaviors:DoubleClickBehavior.Command="{Binding OpenCurrentDirectoryCommand}"
behaviors:DoubleClickBehavior.CommandParameter="{Binding SelectedItem,RelativeSource={RelativeSource Self}}"

이 방법을 통해 View 계층의 이벤트를 ViewModel의 커맨드와 유연하게 바인딩할 수 있습니다.

2. 탐색 컨트롤 (Navigation)

이 부분은 뒤로 가기, 앞으로 가기, 상위 폴더 이동 등의 빠른 탐색 기능을 제공합니다. 특히 '최근 방문 항목' 기능은 사용자가 최근에 방문한 10개의 디렉토리(개발자 정의)를 저장하여 빠른 경로 전환을 돕습니다. 이 기능은 ToggleButton과 Popup의 조합으로 구현됩니다. 마우스 오버 시 아이콘이 변경되는 것은 각 모델의 CurrentDirection 속성에 따라 DataTrigger를 사용하여 처리됩니다.

<Popup Placement="Bottom" PlacementTarget="{Binding ElementName=NavigationPanel}" StaysOpen="False" HorizontalAlignment="Stretch" VerticalAlignment="Stretch"
               IsOpen="{Binding IsChecked,ElementName=HistoryToggleButton,Mode=OneWay}" PopupAnimation="Slide">
            <ItemsControl Background="#f5f5f5" BorderBrush="Gray" BorderThickness="1" Padding="0" 
                          ItemsSource="{Binding AttachedDataContext.DirectoryHistory,RelativeSource={RelativeSource Mode=FindAncestor,AncestorType={x:Type UserControl}}}">
                <ItemsControl.Template>
                    <ControlTemplate TargetType="{x:Type ItemsControl}">
                        <Border x:Name="outer" Padding="0 2" Background="#f5f5f5">
                            <StackPanel Orientation="Vertical" IsItemsHost="True"/>
                        </Border>                        
                    </ControlTemplate>
                </ItemsControl.Template>
                <ItemsControl.ItemTemplate>
                    <DataTemplate>
                        <Button x:Name="directoryHistoryButton" 
                                Command="{Binding AttachedDataContext.SwitchDirectoryCommand,RelativeSource={RelativeSource Mode=FindAncestor,AncestorType={x:Type UserControl}}}"
                                CommandParameter="{Binding}">
                            <Button.Template>
                                <ControlTemplate TargetType="{x:Type Button}">
                                    <Border x:Name="backgroundBorder" Padding="0" Background="#f5f5f5" HorizontalAlignment="Stretch" VerticalAlignment="Stretch">
                                        <StackPanel Orientation="Horizontal" HorizontalAlignment="Left" VerticalAlignment="Center">
                                            <Path x:Name="pathIcon" Margin="2" HorizontalAlignment="Center" VerticalAlignment="Center" 
                                                  Stroke="{DynamicResource {x:Static SystemColors.ActiveBorderBrushKey}}"  Width="24" Height="24"
                                                  Opacity="0" StrokeThickness="2"  StrokeLineJoin="Round"  SnapsToDevicePixels="False"/>                                         
                                            <Image Source="{Binding Icon}" Width="24" Height="24" Margin="2" HorizontalAlignment="Center" VerticalAlignment="Center"/>
                                            <TextBlock Text="{Binding Name}" Margin="2" HorizontalAlignment="Center" VerticalAlignment="Center"/>
                                        </StackPanel>
                                    </Border>
                                    <ControlTemplate.Triggers>
                                        <DataTrigger Binding="{Binding NavigationStatus}" Value="선택됨">
                                            <Setter Property="Opacity" Value="1" TargetName="pathIcon"/>
                                            <Setter Property="Data" Value="M 2,10 L 8,14 18,6" TargetName="pathIcon"/>
                                        </DataTrigger>
                                        <DataTrigger Binding="{Binding NavigationStatus}" Value="이전">
                                            <Setter Property="Opacity" Value="0" TargetName="pathIcon"/>
                                            <Setter Property="Data" Value="M8,6 L1,11 8,16 M0,11 L15,11" TargetName="pathIcon"/>
                                        </DataTrigger>
                                        <DataTrigger Binding="{Binding NavigationStatus}" Value="다음">
                                            <Setter Property="Opacity" Value="0" TargetName="pathIcon"/>
                                            <Setter Property="Data" Value="M8,6 L15,11 8,16 M0,11 L15,11" TargetName="pathIcon"/>
                                        </DataTrigger>
                                        <Trigger Property="IsMouseOver" Value="true">
                                            <Setter Property="Background" Value="#91c9f7" TargetName="backgroundBorder"/>
                                            <Setter Property="Opacity" Value="1" TargetName="pathIcon"/>
                                        </Trigger>
                                    </ControlTemplate.Triggers>
                                </ControlTemplate>
                            </Button.Template>  
                        </Button>                                      
                    </DataTemplate>
                </ItemsControl.ItemTemplate>
            </ItemsControl>
        </Popup>

3. 경로 표시 (BreadCrumbView)

이 부분은 현재 폴더의 경로를 표시하고, 경로의 각 구성 요소를 클릭하여 해당 경로로 이동할 수 있는 기능을 제공합니다. 이 컴포넌트는 ItemsControl, ToggleButton, Popup의 조합으로 구현됩니다. 특히 중요한 점은 이 뷰의 ViewModel(BreadCrumbViewModel)이 FileListViewModel에 정의된 커맨드와 데이터를 재사용해야 한다는 것입니다. 이를 위해 BreadCrumbView는 FileListViewModel의 컨텍스트에 접근할 수 있는 방법을 제공해야 합니다.

using System.Windows;
using System.Windows.Controls;

namespace FileSelectorDemo.Views
{
    public partial class BreadCrumbView : UserControl
    {
        public BreadCrumbView()
        {
            InitializeComponent();
            Loaded += OnBreadCrumbViewLoaded;
        }

        private void OnBreadCrumbViewLoaded(object sender, RoutedEventArgs e)
        {
            this.DataContext = new ViewModels.BreadCrumbViewModel(MainContextReference);
        }

        /// <summary>
        /// FileList의 DataContext 객체에 대한 참조를 저장합니다.
        /// </summary>
        public object MainContextReference
        {
            get { return GetValue(MainContextReferenceProperty); }
            set { SetValue(MainContextReferenceProperty, value); }
        }

        public static readonly DependencyProperty MainContextReferenceProperty =
            DependencyProperty.Register("MainContextReference", typeof(object), typeof(BreadCrumbView), new PropertyMetadata(null));
    }
}

MainContextReference라는 의존성 속성을 정의함으로써, BreadCrumbViewModel은 FileListViewModel의 속성과 커맨드에 접근할 수 있습니다. 이는 FileListViewModel의 책임 과중을 피하면서도 필요한 데이터를 공유하는 방법 중 하나입니다. 하지만 여러 ViewModel 간의 결합도가 높아지면 코드의 복잡성이 증가하고, ViewModel 간의 상호작용을 위해 Action이나 이벤트를 사용하는 경우가 많아집니다. 이러한 문제점을 해결하기 위해 Prism이나 Caliburn.Micro와 같은 MVVM 프레임워크를 사용하면 애플리케이션 아키텍처를 더욱 명확하고 모듈화하며 유연하게 만들 수 있습니다.

이 데모를 통해 얻은 경험은 실제 프로젝트에서 소프트웨어 아키텍처를 설계하고 적절한 모듈화 및 책임 분리 수준을 결정하는 데 중요한 통찰력을 제공합니다.

태그: WPF MVVM C# XAML DataGrid

11월 11일 09:32에 게시됨