DreaminePasswordBox.cs

이 파일의 문서화 페이지로 가기

// \file DreaminePasswordBox.cs
// \brief Hint/Error 지원 + Password 바인딩 가능한 커스텀 PasswordBox 컨트롤
// \details
// - ControlTemplate 내부 PART_PasswordBox(PasswordBox)와 연동
// - Password DP(TwoWay) 지원
// - 템플릿 재적용 시 이벤트 중복 등록 방지
// - PasswordBox.PasswordChanged <-> DP 변경 간 재진입(무한루프) 방지
// \author VsLibrary
// \date 2026-02-11
 
using System;
using System.Linq;
using System.Windows;
using System.Windows.Controls;
 
namespace Dreamine.UI.Wpf.Controls
{
    public class DreaminePasswordBox : Control
    {
        // =====================================================================
        // \brief Static constructor - style merge
        // =====================================================================
        static DreaminePasswordBox()
        {
            DefaultStyleKeyProperty.OverrideMetadata(typeof(DreaminePasswordBox),
                new FrameworkPropertyMetadata(typeof(DreaminePasswordBox)));
 
            // \brief 스타일 리소스 병합
            var uri = new Uri("/Dreamine.UI.Wpf.Themes;component/DreaminePasswordBoxStyle.xaml", UriKind.RelativeOrAbsolute);
 
            if (Application.Current != null)
            {
                bool alreadyAdded = Application.Current.Resources.MergedDictionaries
                    .OfType<ResourceDictionary>()
                    .Any(x => x.Source != null && x.Source.Equals(uri));
 
                if (!alreadyAdded)
                {
                    var dict = new ResourceDictionary { Source = uri };
                    Application.Current.Resources.MergedDictionaries.Add(dict);
                }
            }
        }
 
        // =====================================================================
        // \brief DP: Hint / Error / IsPasswordEmpty / Password
        // =====================================================================

        public static readonly DependencyProperty HintProperty =
            DependencyProperty.Register(nameof(Hint), typeof(string), typeof(DreaminePasswordBox),
                new PropertyMetadata(string.Empty));

        public static readonly DependencyProperty ErrorProperty =
            DependencyProperty.Register(nameof(Error), typeof(string), typeof(DreaminePasswordBox),
                new PropertyMetadata(string.Empty));

        public static readonly DependencyProperty IsPasswordEmptyProperty =
            DependencyProperty.Register(nameof(IsPasswordEmpty), typeof(bool), typeof(DreaminePasswordBox),
                new PropertyMetadata(true));

        public static readonly DependencyProperty PasswordProperty =
            DependencyProperty.Register(
                nameof(Password),
                typeof(string),
                typeof(DreaminePasswordBox),
                new FrameworkPropertyMetadata(
                    string.Empty,
                    FrameworkPropertyMetadataOptions.BindsTwoWayByDefault,
                    OnPasswordChanged));

        public string Password
        {
            get => (string)GetValue(PasswordProperty);
            set => SetValue(PasswordProperty, value);
        }

        public string Hint
        {
            get => (string)GetValue(HintProperty);
            set => SetValue(HintProperty, value);
        }

        public string Error
        {
            get => (string)GetValue(ErrorProperty);
            set => SetValue(ErrorProperty, value);
        }

        public bool IsPasswordEmpty
        {
            get => (bool)GetValue(IsPasswordEmptyProperty);
            set => SetValue(IsPasswordEmptyProperty, value);
        }
 
        // =====================================================================
        // \brief Internal fields
        // =====================================================================

        private PasswordBox? _partPasswordBox;

        private RoutedEventHandler? _passwordChangedHandler;

        private bool _isSyncing;
 
        // =====================================================================
        // \brief Template hook
        // =====================================================================

        public override void OnApplyTemplate()
        {
            base.OnApplyTemplate();
 
            // \brief 이전 PART가 있으면 이벤트 해제
            DetachPartHandlers();
 
            _partPasswordBox = GetTemplateChild("PART_PasswordBox") as PasswordBox;
            if (_partPasswordBox == null)
                return;
 
            // \brief 최초 동기화: DP -> PART
            SyncDpToPart(Password);
 
            // \brief PasswordChanged 연결 (참조 보관)
            _passwordChangedHandler = (_, __) =>
            {
                if (_partPasswordBox == null)
                    return;
 
                if (_isSyncing)
                    return;
 
                try
                {
                    _isSyncing = true;
 
                    string pwd = _partPasswordBox.Password ?? string.Empty;
 
                    // \brief PART -> DP
                    if (!string.Equals(Password ?? string.Empty, pwd, StringComparison.Ordinal))
                        SetCurrentValue(PasswordProperty, pwd);
 
                    // \brief empty 플래그 갱신
                    SetCurrentValue(IsPasswordEmptyProperty, string.IsNullOrEmpty(pwd));
                }
                finally
                {
                    _isSyncing = false;
                }
            };
 
            _partPasswordBox.PasswordChanged += (s, e) => _passwordChangedHandler?.Invoke(s, e);
 
            // \brief 컨트롤 클릭 시 내부 입력으로 포커스 이동 (UX)
            this.MouseDown += OnHostMouseDown;
            this.GotKeyboardFocus += OnHostGotKeyboardFocus;
        }

        private void DetachPartHandlers()
        {
            // \note PasswordBox.PasswordChanged는 익명 람다로 직접 해제하기 어려우니
            //       템플릿 재적용 시 새 PART로 갈아끼우는 패턴에서 “PART 캐시 교체”로 방어한다.
            //       (현재 구조는 PART가 바뀌면 이전 PART는 UI 트리에서 떨어지므로 누적 영향이 크지 않음)
 
            this.MouseDown -= OnHostMouseDown;
            this.GotKeyboardFocus -= OnHostGotKeyboardFocus;
 
            _partPasswordBox = null;
            _passwordChangedHandler = null;
        }

        private void OnHostMouseDown(object sender, System.Windows.Input.MouseButtonEventArgs e)
        {
            _partPasswordBox?.Focus();
        }

        private void OnHostGotKeyboardFocus(object sender, System.Windows.Input.KeyboardFocusChangedEventArgs e)
        {
            if (e.NewFocus == this)
            {
                _partPasswordBox?.Focus();
                e.Handled = true;
            }
        }
 
        // =====================================================================
        // \brief DP -> PART 동기화
        // =====================================================================

        private static void OnPasswordChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
        {
            if (d is not DreaminePasswordBox control)
                return;
 
            if (control._isSyncing)
                return;
 
            string newPassword = e.NewValue as string ?? string.Empty;
 
            control.SyncDpToPart(newPassword);
        }

        private void SyncDpToPart(string newPassword)
        {
            try
            {
                _isSyncing = true;
 
                SetCurrentValue(IsPasswordEmptyProperty, string.IsNullOrEmpty(newPassword));
 
                if (_partPasswordBox != null)
                {
                    string current = _partPasswordBox.Password ?? string.Empty;
                    if (!string.Equals(current, newPassword, StringComparison.Ordinal))
                        _partPasswordBox.Password = newPassword;
                }
            }
            finally
            {
                _isSyncing = false;
            }
        }
    }
}