Dreamine.UI.Wpf.Controls.DreamineTextBox 클래스 참조

더 자세히 ...

Dreamine.UI.Wpf.Controls.DreamineTextBox에 대한 상속 다이어그램 :

Dreamine.UI.Wpf.Controls.DreamineTextBox에 대한 협력 다이어그램:

Public 멤버 함수
	DreamineTextBox ()

정적 Public 멤버 함수
static void	SetCommandTriggerName (DependencyObject obj, string value)
static string	GetCommandTriggerName (DependencyObject obj)
static void	SetCommand (DependencyObject obj, ICommand value)
static ICommand	GetCommand (DependencyObject obj)
static void	SetCommandParameter (DependencyObject obj, object value)
static object	GetCommandParameter (DependencyObject obj)

정적 Public 속성
static readonly DependencyProperty	CommandProperty
static readonly DependencyProperty	CommandParameterProperty
static readonly DependencyProperty	CommandTriggerNameProperty
static readonly DependencyProperty	HintProperty
static readonly DependencyProperty	ErrorProperty

Protected 멤버 함수
override void	OnPreviewKeyDown (KeyEventArgs e)

속성
string	Hint [get, set]
string	Error [get, set]

Private 멤버 함수
void	OnGotKeyboardFocus_StorePreviousFocus (object sender, KeyboardFocusChangedEventArgs e)
UIElement?	FindFirstFocusableChild (DependencyObject parent)

정적 Private 멤버 함수
static	DreamineTextBox ()
static void	OnCommandChanged (DependencyObject d, DependencyPropertyChangedEventArgs e)
static void	TryExecuteCommand (DependencyObject d, string eventName, RoutedEventArgs eventArgs)

Private 속성
IInputElement?	_previousFocusedElement

상세한 설명

스타일 병합, 연결 명령 및 Enter 키 포커스 복귀 기능을 제공하는 텍스트 상자입니다.

DreamineTextBox.cs 파일의 24 번째 라인에서 정의되었습니다.

생성자 & 소멸자 문서화

DreamineTextBox() [1/2]

Dreamine.UI.Wpf.Controls.DreamineTextBox.DreamineTextBox ( )

inlinestaticprivate

기본 스타일 키를 등록하고 텍스트 상자 테마 리소스를 애플리케이션에 한 번 병합합니다.

DreamineTextBox.cs 파일의 44 번째 라인에서 정의되었습니다.

        {
            DefaultStyleKeyProperty.OverrideMetadata(typeof(DreamineTextBox),
                new FrameworkPropertyMetadata(typeof(DreamineTextBox)));
 
            var uri = new Uri("/Dreamine.UI.Wpf.Themes;component/DreamineTextBoxStyle.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);
                }
            }
        }

다음을 참조함 : DreamineTextBox().

다음에 의해서 참조됨 : DreamineTextBox().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

DreamineTextBox() [2/2]

Dreamine.UI.Wpf.Controls.DreamineTextBox.DreamineTextBox ( )

inline

새 인스턴스를 만들고 키보드 포커스 변경 이벤트를 구독합니다.

컨트롤 자체의 이벤트를 사용하여 창 단위 구독에 따른 중복과 수명 문제를 피합니다.

DreamineTextBox.cs 파일의 81 번째 라인에서 정의되었습니다.

        {
            // \brief Enter 복귀를 위해 이전 포커스 저장
            GotKeyboardFocus += OnGotKeyboardFocus_StorePreviousFocus;
        }

다음을 참조함 : OnGotKeyboardFocus_StorePreviousFocus().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

멤버 함수 문서화

FindFirstFocusableChild()

UIElement? Dreamine.UI.Wpf.Controls.DreamineTextBox.FindFirstFocusableChild ( DependencyObject parent )

inlineprivate

시각적 자식 트리를 깊이 우선으로 탐색하여 첫 포커스 가능 요소를 찾습니다.

매개변수

parent

탐색을 시작할 시각적 부모입니다.

반환값

표시되고 활성화된 첫 포커스 가능 요소이며, 없으면 null입니다.

예외

ArgumentNullException

parent 가 null일 때 발생합니다.

DreamineTextBox.cs 파일의 242 번째 라인에서 정의되었습니다.

        {
            for (int i = 0; i < VisualTreeHelper.GetChildrenCount(parent); i++)
            {
                var child = VisualTreeHelper.GetChild(parent, i);
 
                if (child is UIElement uie && uie.Focusable && uie.IsVisible && uie.IsEnabled)
                    return uie;
 
                var result = FindFirstFocusableChild(child);
                if (result != null)
                    return result;
            }
            return null;
        }

다음을 참조함 : FindFirstFocusableChild().

다음에 의해서 참조됨 : FindFirstFocusableChild(), OnGotKeyboardFocus_StorePreviousFocus().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

GetCommand()

ICommand Dreamine.UI.Wpf.Controls.DreamineTextBox.GetCommand ( DependencyObject obj )

inlinestatic

지정한 객체에 연결된 명령을 가져옵니다.

매개변수

obj	값을 읽을 종속성 객체입니다.

반환값

연결된 명령입니다.

예외

ArgumentNullException	obj 가 null일 때 발생합니다.
InvalidCastException	저장된 값이 ICommand로 변환될 수 없을 때 발생합니다.

DreamineTextBox.cs 파일의 452 번째 라인에서 정의되었습니다.

            => (ICommand)obj.GetValue(CommandProperty);

다음을 참조함 : CommandProperty.

다음에 의해서 참조됨 : TryExecuteCommand().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

GetCommandParameter()

object Dreamine.UI.Wpf.Controls.DreamineTextBox.GetCommandParameter ( DependencyObject obj )

inlinestatic

지정한 객체의 명령 매개변수를 가져옵니다.

매개변수

obj	값을 읽을 종속성 객체입니다.

반환값

구성된 명령 매개변수입니다.

예외

ArgumentNullException

obj 가 null일 때 발생합니다.

DreamineTextBox.cs 파일의 522 번째 라인에서 정의되었습니다.

            => obj.GetValue(CommandParameterProperty);

다음을 참조함 : CommandParameterProperty.

다음에 의해서 참조됨 : TryExecuteCommand().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

GetCommandTriggerName()

string Dreamine.UI.Wpf.Controls.DreamineTextBox.GetCommandTriggerName ( DependencyObject obj )

inlinestatic

지정한 객체의 명령 트리거 이름 목록을 가져옵니다.

매개변수

obj	값을 읽을 종속성 객체입니다.

반환값

쉼표로 구분한 이벤트 이름 목록입니다.

예외

ArgumentNullException

obj 가 null일 때 발생합니다.

DreamineTextBox.cs 파일의 374 번째 라인에서 정의되었습니다.

            => (string)obj.GetValue(CommandTriggerNameProperty);

다음을 참조함 : CommandTriggerNameProperty.

다음에 의해서 참조됨 : TryExecuteCommand().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

OnCommandChanged()

void Dreamine.UI.Wpf.Controls.DreamineTextBox.OnCommandChanged ( DependencyObject d, DependencyPropertyChangedEventArgs e )

inlinestaticprivate

명령 속성이 변경되면 지원되는 입력 및 텍스트 이벤트 처리기를 등록합니다.

매개변수

d	명령 속성이 변경된 객체입니다.
e	이전 값과 새 값을 포함하는 속성 변경 데이터입니다.

현재 구현은 변경될 때마다 처리기를 추가하므로 호출 측에서 반복 설정을 피해야 합니다.

DreamineTextBox.cs 파일의 557 번째 라인에서 정의되었습니다.

        {
            if (d is not UIElement element)
                return;
 
            element.AddHandler(UIElement.PreviewMouseUpEvent, new MouseButtonEventHandler((s, args) =>
            {
                TryExecuteCommand(d, "PreviewMouseUp", args);
            }), true);
 
            element.AddHandler(Control.MouseDoubleClickEvent, new MouseButtonEventHandler((s, args) =>
            {
                TryExecuteCommand(d, "MouseDoubleClick", args);
            }), true);
 
            element.AddHandler(UIElement.PreviewKeyDownEvent, new KeyEventHandler((s, args) =>
            {
                // \brief 기존 규칙 유지: PreviewKeyDown 훅이지만 이름은 "PreviewKeyUp"
                TryExecuteCommand(d, "PreviewKeyUp", args);
            }), true);
 
            element.AddHandler(UIElement.TouchUpEvent, new EventHandler<TouchEventArgs>((s, args) =>
            {
                TryExecuteCommand(d, "TouchUp", args);
            }));
 
            element.AddHandler(ButtonBase.ClickEvent, new RoutedEventHandler((s, args) =>
            {
                TryExecuteCommand(d, "Click", args);
            }));
 
            element.AddHandler(TextBox.TextChangedEvent, new TextChangedEventHandler((s, args) =>
            {
                TryExecuteCommand(d, "TextChanged", args);
            }));
        }

다음을 참조함 : TryExecuteCommand().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

OnGotKeyboardFocus_StorePreviousFocus()

void Dreamine.UI.Wpf.Controls.DreamineTextBox.OnGotKeyboardFocus_StorePreviousFocus ( object sender, KeyboardFocusChangedEventArgs e )

inlineprivate

키보드 포커스를 얻기 직전의 유효한 포커스 대상을 저장합니다.

매개변수

sender	이벤트를 발생시킨 객체입니다.
e	이전 및 새 키보드 포커스 정보를 포함하는 이벤트 데이터입니다.

DreamineTextBox.cs 파일의 111 번째 라인에서 정의되었습니다.

        {
            // \brief OldFocus가 Window/ContentControl로 들어오는 경우가 있으므로 교정
            var old = e.OldFocus;
 
            if (old is null)
            {
                _previousFocusedElement = null;
                return;
            }
 
            if (ReferenceEquals(old, this))
            {
                // \brief 자기 자신이면 의미 없음
                return;
            }
 
            if (old is DependencyObject dobj)
            {
                if (old is Window || old is ContentControl)
                {
                    var child = FindFirstFocusableChild(dobj);
                    _previousFocusedElement = child ?? old;
                    return;
                }
            }
 
            _previousFocusedElement = old;
        }

다음을 참조함 : _previousFocusedElement, FindFirstFocusableChild().

다음에 의해서 참조됨 : DreamineTextBox().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

OnPreviewKeyDown()

override void Dreamine.UI.Wpf.Controls.DreamineTextBox.OnPreviewKeyDown ( KeyEventArgs e )

inlineprotected

Enter 키 입력을 처리한 뒤 이전 포커스 대상으로 비동기 복귀합니다.

매개변수

e	누른 키와 처리 상태를 포함하는 키 이벤트 데이터입니다.

예외

ArgumentNullException

e 가 null일 때 기본 구현에서 발생할 수 있습니다.

포커스 이동 실패는 입력 흐름을 중단하지 않도록 의도적으로 무시합니다.

DreamineTextBox.cs 파일의 173 번째 라인에서 정의되었습니다.

        {
            base.OnPreviewKeyDown(e);
 
            if (e.Key != Key.Enter)
                return;
 
            var target = _previousFocusedElement;
 
            if (target == null || ReferenceEquals(target, this))
                return;
 
            // \brief Enter 키 입력은 여기서 소비
            e.Handled = true;
 
            // \brief 이벤트 파이프라인/내부 TextBox 처리 후 포커스 이동
            Dispatcher.BeginInvoke(new Action(() =>
            {
                try
                {
                    // \brief UIElement이면 Focus()가 더 잘 먹는 경우가 많음
                    if (target is UIElement uie)
                    {
                        uie.Focus();
                        Keyboard.Focus(uie);
                        return;
                    }
 
                    Keyboard.Focus(target);
                }
                catch
                {
                    // \brief 포커스 실패는 치명적이지 않으므로 무시(정책에 맞게 로그로 바꿔도 됨)
                }
            }), System.Windows.Threading.DispatcherPriority.Input);
        }

다음을 참조함 : _previousFocusedElement.

SetCommand()

void Dreamine.UI.Wpf.Controls.DreamineTextBox.SetCommand ( DependencyObject obj, ICommand value )

inlinestatic

지정한 객체에 연결 명령을 설정합니다.

매개변수

obj	값을 설정할 종속성 객체입니다.
value	실행할 명령입니다.

예외

ArgumentNullException

obj 가 null일 때 발생합니다.

DreamineTextBox.cs 파일의 409 번째 라인에서 정의되었습니다.

            => obj.SetValue(CommandProperty, value);

다음을 참조함 : CommandProperty.

SetCommandParameter()

void Dreamine.UI.Wpf.Controls.DreamineTextBox.SetCommandParameter ( DependencyObject obj, object value )

inlinestatic

지정한 객체에 명령 매개변수를 설정합니다.

매개변수

obj	값을 설정할 종속성 객체입니다.
value	명령에 전달할 값입니다.

예외

ArgumentNullException

obj 가 null일 때 발생합니다.

DreamineTextBox.cs 파일의 487 번째 라인에서 정의되었습니다.

            => obj.SetValue(CommandParameterProperty, value);

다음을 참조함 : CommandParameterProperty.

SetCommandTriggerName()

void Dreamine.UI.Wpf.Controls.DreamineTextBox.SetCommandTriggerName ( DependencyObject obj, string value )

inlinestatic

지정한 객체의 명령 트리거 이름 목록을 설정합니다.

매개변수

obj	값을 설정할 종속성 객체입니다.
value	쉼표로 구분한 이벤트 이름 목록입니다.

예외

ArgumentNullException

obj 가 null일 때 발생합니다.

DreamineTextBox.cs 파일의 339 번째 라인에서 정의되었습니다.

            => obj.SetValue(CommandTriggerNameProperty, value);

다음을 참조함 : CommandTriggerNameProperty.

TryExecuteCommand()

void Dreamine.UI.Wpf.Controls.DreamineTextBox.TryExecuteCommand ( DependencyObject d, string eventName, RoutedEventArgs eventArgs )

inlinestaticprivate

구성된 트리거 목록에 이벤트 이름이 포함되고 실행 가능하면 명령을 실행합니다.

매개변수

d	연결 속성을 소유한 객체입니다.
eventName	비교할 이벤트 이름입니다.
eventArgs	명시적 매개변수가 없을 때 명령에 전달할 이벤트 데이터입니다.

예외

ArgumentNullException

d 가 null일 때 발생합니다.

DreamineTextBox.cs 파일의 634 번째 라인에서 정의되었습니다.

        {
            var rawTrigger = GetCommandTriggerName(d);
            if (string.IsNullOrEmpty(rawTrigger))
                return;
 
            var triggerList = rawTrigger.Split(',')
                .Select(x => x.Trim())
                .Where(x => !string.IsNullOrEmpty(x));
 
            if (!triggerList.Contains(eventName, StringComparer.OrdinalIgnoreCase))
                return;
 
            var command = GetCommand(d);
            var parameter = GetCommandParameter(d) ?? eventArgs;
 
            if (command?.CanExecute(parameter) == true)
                command.Execute(parameter);
        }

다음을 참조함 : GetCommand(), GetCommandParameter(), GetCommandTriggerName().

다음에 의해서 참조됨 : OnCommandChanged().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

멤버 데이터 문서화

_previousFocusedElement

IInputElement? Dreamine.UI.Wpf.Controls.DreamineTextBox._previousFocusedElement

private

Enter 키를 누를 때 복귀할 이전 키보드 포커스 요소입니다.

DreamineTextBox.cs 파일의 34 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : OnGotKeyboardFocus_StorePreviousFocus(), OnPreviewKeyDown().

CommandParameterProperty

readonly DependencyProperty Dreamine.UI.Wpf.Controls.DreamineTextBox.CommandParameterProperty

static

초기값:

                                                               =
DependencyProperty.RegisterAttached(
    "CommandParameter",
    typeof(object),
    typeof(DreamineTextBox),
    new PropertyMetadata(null))

연결 명령에 전달할 선택적 매개변수를 식별합니다.

DreamineTextBox.cs 파일의 285 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : GetCommandParameter(), SetCommandParameter().

CommandProperty

readonly DependencyProperty Dreamine.UI.Wpf.Controls.DreamineTextBox.CommandProperty

static

초기값:

                                                      =
DependencyProperty.RegisterAttached(
    "Command",
    typeof(ICommand),
    typeof(DreamineTextBox),
    new PropertyMetadata(null, OnCommandChanged))

이벤트가 일치할 때 실행할 연결 명령을 식별합니다.

DreamineTextBox.cs 파일의 270 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : GetCommand(), SetCommand().

CommandTriggerNameProperty

readonly DependencyProperty Dreamine.UI.Wpf.Controls.DreamineTextBox.CommandTriggerNameProperty

static

초기값:

                                                                 =
DependencyProperty.RegisterAttached(
    "CommandTriggerName",
    typeof(string),
    typeof(DreamineTextBox),
    new PropertyMetadata(null))

명령을 실행할 쉼표 구분 이벤트 이름 목록을 식별합니다.

DreamineTextBox.cs 파일의 300 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : GetCommandTriggerName(), SetCommandTriggerName().

ErrorProperty

readonly DependencyProperty Dreamine.UI.Wpf.Controls.DreamineTextBox.ErrorProperty

static

초기값:

                                                    =
DependencyProperty.Register(nameof(Error), typeof(string), typeof(DreamineTextBox), new PropertyMetadata(string.Empty))

템플릿에 표시할 오류 문자열 종속성 속성을 식별합니다.

DreamineTextBox.cs 파일의 691 번째 라인에서 정의되었습니다.

HintProperty

readonly DependencyProperty Dreamine.UI.Wpf.Controls.DreamineTextBox.HintProperty

static

초기값:

                                                   =
DependencyProperty.Register(nameof(Hint), typeof(string), typeof(DreamineTextBox), new PropertyMetadata(string.Empty))

자리표시자 문자열 종속성 속성을 식별합니다.

DreamineTextBox.cs 파일의 666 번째 라인에서 정의되었습니다.

속성 문서화

Error

string Dreamine.UI.Wpf.Controls.DreamineTextBox.Error

getset

템플릿에 표시할 오류 문자열을 가져오거나 설정합니다.

DreamineTextBox.cs 파일의 702 번째 라인에서 정의되었습니다.

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

Hint

string Dreamine.UI.Wpf.Controls.DreamineTextBox.Hint

getset

입력 안내용 자리표시자 문자열을 가져오거나 설정합니다.

DreamineTextBox.cs 파일의 677 번째 라인에서 정의되었습니다.

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

---

이 클래스에 대한 문서화 페이지는 다음의 파일로부터 생성되었습니다.:

• DreamineTextBox.cs