Dreamine.UI.Wpf.Behaviors.NumericRangeBehavior 클래스 참조

더 자세히 ...

정적 Public 멤버 함수
static void	SetIsEnabled (DependencyObject d, bool value)
static bool	GetIsEnabled (DependencyObject d)
static void	SetMin (DependencyObject d, double? value)
static ? double	GetMin (DependencyObject d)
static void	SetMax (DependencyObject d, double? value)
static ? double	GetMax (DependencyObject d)
static void	SetMode (DependencyObject d, NumericRangeMode value)
static NumericRangeMode	GetMode (DependencyObject d)

정적 Public 속성
static readonly DependencyProperty	IsEnabledProperty
static readonly DependencyProperty	MinProperty
static readonly DependencyProperty	MaxProperty
static readonly DependencyProperty	ModeProperty

정적 Private 멤버 함수
static void	SetLastValidText (DependencyObject d, string value)
static string	GetLastValidText (DependencyObject d)
static void	OnIsEnabledChanged (DependencyObject d, DependencyPropertyChangedEventArgs e)
static void	Tb_Loaded (object sender, RoutedEventArgs e)
static void	OnPasting (object sender, DataObjectPastingEventArgs e)
static void	Tb_TextChanged (object sender, TextChangedEventArgs e)
static void	Tb_LostFocus (object sender, RoutedEventArgs e)
static string	GetFutureText (TextBox tb, string insert)
static bool	TryValidate (TextBox tb, string text, out string corrected)

정적 Private 속성
static readonly DependencyProperty	LastValidTextProperty

상세한 설명

TextBox에 숫자 최소값과 최대값을 강제하는 연결 동작을 제공합니다.

ViewModel이나 모델을 수정하지 않고 입력 단계에서 값을 보정하거나 거부합니다.

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

멤버 함수 문서화

GetFutureText()

string Dreamine.UI.Wpf.Behaviors.NumericRangeBehavior.GetFutureText ( TextBox tb, string insert )

inlinestaticprivate

현재 선택 영역을 대체하여 문자열을 삽입했을 때 만들어질 텍스트를 계산합니다.

매개변수

tb	현재 텍스트와 선택 영역을 제공하는 텍스트 상자입니다.
insert	삽입할 문자열입니다.

반환값

삽입 이후의 예상 텍스트입니다.

예외

ArgumentOutOfRangeException

텍스트 상자의 선택 위치가 현재 문자열 범위를 벗어나면 발생할 수 있습니다.

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

        {
            var text = tb.Text ?? string.Empty;
            var selStart = tb.SelectionStart;
            var selLen = tb.SelectionLength;
            if (selLen > 0) text = text.Remove(selStart, selLen);
            return text.Insert(selStart, insert);
        }

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

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

GetIsEnabled()

bool Dreamine.UI.Wpf.Behaviors.NumericRangeBehavior.GetIsEnabled ( DependencyObject d )

inlinestatic

대상 개체의 숫자 범위 동작 활성화 여부를 가져옵니다.

매개변수

d	값을 읽을 종속성 개체입니다.

반환값

활성화되어 있으면 true입니다.

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

=> (bool)d.GetValue(IsEnabledProperty);

다음을 참조함 : IsEnabledProperty.

GetLastValidText()

string Dreamine.UI.Wpf.Behaviors.NumericRangeBehavior.GetLastValidText ( DependencyObject d )

inlinestaticprivate

대상 개체에 저장된 마지막 유효 텍스트를 가져옵니다.

매개변수

d	텍스트를 읽을 종속성 개체입니다.

반환값

마지막 유효 텍스트입니다.

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

=> (string)d.GetValue(LastValidTextProperty);

다음을 참조함 : LastValidTextProperty.

다음에 의해서 참조됨 : OnPasting(), Tb_LostFocus().

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

GetMax()

? double Dreamine.UI.Wpf.Behaviors.NumericRangeBehavior.GetMax ( DependencyObject d )

inlinestatic

대상 개체의 최대 허용값을 가져옵니다.

매개변수

d	값을 읽을 종속성 개체입니다.

반환값

최대값이며, 제한이 없으면 null입니다.

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

=> (double?)d.GetValue(MaxProperty);

다음을 참조함 : MaxProperty.

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

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

GetMin()

? double Dreamine.UI.Wpf.Behaviors.NumericRangeBehavior.GetMin ( DependencyObject d )

inlinestatic

대상 개체의 최소 허용값을 가져옵니다.

매개변수

d	값을 읽을 종속성 개체입니다.

반환값

최소값이며, 제한이 없으면 null입니다.

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

=> (double?)d.GetValue(MinProperty);

다음을 참조함 : MinProperty.

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

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

GetMode()

NumericRangeMode Dreamine.UI.Wpf.Behaviors.NumericRangeBehavior.GetMode ( DependencyObject d )

inlinestatic

대상 개체의 범위 위반 처리 방식을 가져옵니다.

매개변수

d	값을 읽을 종속성 개체입니다.

반환값

구성된 처리 방식입니다.

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

=> (NumericRangeMode)d.GetValue(ModeProperty);

다음을 참조함 : ModeProperty.

다음에 의해서 참조됨 : OnPasting(), Tb_LostFocus(), Tb_TextChanged().

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

OnIsEnabledChanged()

void Dreamine.UI.Wpf.Behaviors.NumericRangeBehavior.OnIsEnabledChanged ( DependencyObject d, DependencyPropertyChangedEventArgs e )

inlinestaticprivate

활성화 값 변경을 처리하여 텍스트 상자의 검증 이벤트를 연결하거나 해제합니다.

매개변수

d	값이 변경된 종속성 개체입니다.
e	종속성 속성 변경 데이터입니다.

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

        {
            if (d is not TextBox tb) return;
 
            if ((bool)e.NewValue)
            {
                tb.Loaded += Tb_Loaded;
                tb.TextChanged += Tb_TextChanged;
                tb.LostFocus += Tb_LostFocus;
                DataObject.AddPastingHandler(tb, OnPasting);
            }
            else
            {
                tb.Loaded -= Tb_Loaded;
                tb.TextChanged -= Tb_TextChanged;
                tb.LostFocus -= Tb_LostFocus;
                DataObject.RemovePastingHandler(tb, OnPasting);
            }
        }

다음을 참조함 : OnPasting(), Tb_Loaded(), Tb_LostFocus(), Tb_TextChanged().

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

OnPasting()

void Dreamine.UI.Wpf.Behaviors.NumericRangeBehavior.OnPasting ( object sender, DataObjectPastingEventArgs e )

inlinestaticprivate

붙여넣을 텍스트를 미리 검증하고 구성된 방식에 따라 거부하거나 보정합니다.

매개변수

sender	붙여넣기 대상 텍스트 상자입니다.
e	붙여넣기 데이터와 취소 기능을 제공하는 이벤트 데이터입니다.

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

        {
            if (sender is not TextBox tb) return;
 
            if (e.DataObject.GetDataPresent(DataFormats.UnicodeText))
            {
                var pasteText = e.DataObject.GetData(DataFormats.UnicodeText) as string ?? string.Empty;
                var future = GetFutureText(tb, pasteText);
                if (!TryValidate(tb, future, out var corrected))
                {
                    if (GetMode(tb) == NumericRangeMode.Reject)
                    {
                        e.CancelCommand();
                        tb.Text = GetLastValidText(tb) ?? string.Empty;
                        tb.CaretIndex = tb.Text.Length;
                        return;
                    }
                    e.CancelCommand(); // Clamp
                    tb.Text = corrected;
                    tb.CaretIndex = tb.Text.Length;
                }
            }
        }

다음을 참조함 : GetFutureText(), GetLastValidText(), GetMode(), TryValidate().

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

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

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

SetIsEnabled()

void Dreamine.UI.Wpf.Behaviors.NumericRangeBehavior.SetIsEnabled ( DependencyObject d, bool value )

inlinestatic

대상 개체의 숫자 범위 동작 활성화 여부를 설정합니다.

매개변수

d	값을 설정할 종속성 개체입니다.
value	활성화 여부입니다.

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

=> d.SetValue(IsEnabledProperty, value);

다음을 참조함 : IsEnabledProperty.

SetLastValidText()

void Dreamine.UI.Wpf.Behaviors.NumericRangeBehavior.SetLastValidText ( DependencyObject d, string value )

inlinestaticprivate

대상 개체에 마지막 유효 텍스트를 저장합니다.

매개변수

d	텍스트를 저장할 종속성 개체입니다.
value	저장할 유효 텍스트입니다.

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

=> d.SetValue(LastValidTextProperty, value);

다음을 참조함 : LastValidTextProperty.

다음에 의해서 참조됨 : Tb_Loaded(), Tb_LostFocus(), Tb_TextChanged().

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

SetMax()

void Dreamine.UI.Wpf.Behaviors.NumericRangeBehavior.SetMax ( DependencyObject d, double? value )

inlinestatic

대상 개체의 최대 허용값을 설정합니다.

매개변수

d	값을 설정할 종속성 개체입니다.
value	최대값이며, 제한하지 않으려면 null입니다.

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

=> d.SetValue(MaxProperty, value);

다음을 참조함 : MaxProperty.

SetMin()

void Dreamine.UI.Wpf.Behaviors.NumericRangeBehavior.SetMin ( DependencyObject d, double? value )

inlinestatic

대상 개체의 최소 허용값을 설정합니다.

매개변수

d	값을 설정할 종속성 개체입니다.
value	최소값이며, 제한하지 않으려면 null입니다.

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

=> d.SetValue(MinProperty, value);

다음을 참조함 : MinProperty.

SetMode()

void Dreamine.UI.Wpf.Behaviors.NumericRangeBehavior.SetMode ( DependencyObject d, NumericRangeMode value )

inlinestatic

대상 개체의 범위 위반 처리 방식을 설정합니다.

매개변수

d	값을 설정할 종속성 개체입니다.
value	적용할 처리 방식입니다.

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

=> d.SetValue(ModeProperty, value);

다음을 참조함 : ModeProperty.

Tb_Loaded()

void Dreamine.UI.Wpf.Behaviors.NumericRangeBehavior.Tb_Loaded ( object sender, RoutedEventArgs e )

inlinestaticprivate

텍스트 상자가 로드될 때 현재 텍스트를 마지막 유효값으로 저장합니다.

매개변수

sender	로드된 텍스트 상자입니다.
e	라우트 이벤트 데이터입니다.

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

        {
            if (sender is TextBox tb)
                SetLastValidText(tb, tb.Text);
        }

다음을 참조함 : SetLastValidText().

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

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

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

Tb_LostFocus()

void Dreamine.UI.Wpf.Behaviors.NumericRangeBehavior.Tb_LostFocus ( object sender, RoutedEventArgs e )

inlinestaticprivate

포커스를 잃을 때 최종 값을 검증하고 보정 또는 복원한 뒤 바인딩 원본을 갱신합니다.

매개변수

sender	포커스를 잃은 텍스트 상자입니다.
e	라우트 이벤트 데이터입니다.

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

        {
            if (sender is not TextBox tb) return;
 
            var mode = GetMode(tb);
            if (!TryValidate(tb, tb.Text, out var corrected))
            {
                tb.Text = (mode == NumericRangeMode.Reject)
                    ? (GetLastValidText(tb) ?? corrected)
                    : corrected;
            }
            SetLastValidText(tb, tb.Text);
 
            // 바인딩 원본 반영
            var expr = tb.GetBindingExpression(TextBox.TextProperty);
            expr?.UpdateSource();
        }

다음을 참조함 : GetLastValidText(), GetMode(), SetLastValidText(), TryValidate().

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

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

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

Tb_TextChanged()

void Dreamine.UI.Wpf.Behaviors.NumericRangeBehavior.Tb_TextChanged ( object sender, TextChangedEventArgs e )

inlinestaticprivate

텍스트 변경을 처리하고 보정 모드에서 범위를 벗어난 값을 즉시 보정합니다.

매개변수

sender	텍스트가 변경된 텍스트 상자입니다.
e	텍스트 변경 이벤트 데이터입니다.

거부 모드의 복원은 자연스러운 입력을 위해 포커스를 잃을 때 수행됩니다.

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

        {
            if (sender is not TextBox tb) return;
 
            if (GetMode(tb) == NumericRangeMode.Clamp)
            {
                if (!TryValidate(tb, tb.Text, out var corrected))
                {
                    tb.TextChanged -= Tb_TextChanged;
                    tb.Text = corrected;
                    tb.CaretIndex = tb.Text.Length;
                    tb.TextChanged += Tb_TextChanged;
                }
                else
                {
                    SetLastValidText(tb, tb.Text);
                }
            }
        }

다음을 참조함 : GetMode(), SetLastValidText(), Tb_TextChanged(), TryValidate().

다음에 의해서 참조됨 : OnIsEnabledChanged(), Tb_TextChanged().

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

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

TryValidate()

bool Dreamine.UI.Wpf.Behaviors.NumericRangeBehavior.TryValidate ( TextBox tb, string text, out string corrected )

inlinestaticprivate

텍스트를 실수로 해석하여 최소·최대 범위를 검사하고 필요한 보정 문자열을 계산합니다.

매개변수

tb	범위 설정을 읽을 텍스트 상자입니다.
text	검증할 텍스트입니다.
corrected	원본 텍스트 또는 가장 가까운 경계값 문자열을 반환합니다.

반환값

텍스트가 비어 있거나 유효한 범위 안의 숫자이면 true이고, 그렇지 않으면 false입니다.

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

        {
            corrected = text ?? string.Empty;
            if (string.IsNullOrWhiteSpace(text))
                return true; // 빈값 허용 여부는 별도 정책에서 결정
 
            var style = NumberStyles.Float | NumberStyles.AllowThousands;
            var culture = CultureInfo.CurrentCulture;
 
            if (!double.TryParse(text, style, culture, out var value))
            {
                return false; // 숫자 아님
            }
 
            var min = GetMin(tb);
            var max = GetMax(tb);
 
            if (min.HasValue && value < min.Value)
            {
                corrected = min.Value.ToString(culture);
                return false;
            }
            if (max.HasValue && value > max.Value)
            {
                corrected = max.Value.ToString(culture);
                return false;
            }
 
            return true;
        }

다음을 참조함 : GetMax(), GetMin().

다음에 의해서 참조됨 : OnPasting(), Tb_LostFocus(), Tb_TextChanged().

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

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

멤버 데이터 문서화

IsEnabledProperty

readonly DependencyProperty Dreamine.UI.Wpf.Behaviors.NumericRangeBehavior.IsEnabledProperty

static

초기값:

                                                =
DependencyProperty.RegisterAttached(
    "IsEnabled",
    typeof(bool),
    typeof(NumericRangeBehavior),
    new PropertyMetadata(false, OnIsEnabledChanged))

숫자 범위 동작의 활성화 여부를 저장하는 연결 속성입니다.

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

다음에 의해서 참조됨 : GetIsEnabled(), SetIsEnabled().

LastValidTextProperty

readonly DependencyProperty Dreamine.UI.Wpf.Behaviors.NumericRangeBehavior.LastValidTextProperty

staticprivate

초기값:

                                                     =
DependencyProperty.RegisterAttached(
    "LastValidText",
    typeof(string),
    typeof(NumericRangeBehavior),
    new PropertyMetadata(null))

마지막 유효 텍스트를 내부적으로 저장하는 연결 속성입니다.

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

다음에 의해서 참조됨 : GetLastValidText(), SetLastValidText().

MaxProperty

readonly DependencyProperty Dreamine.UI.Wpf.Behaviors.NumericRangeBehavior.MaxProperty

static

초기값:

                                          =
DependencyProperty.RegisterAttached(
    "Max",
    typeof(double?),
    typeof(NumericRangeBehavior),
    new PropertyMetadata(null))

선택적인 최대 허용값을 저장하는 연결 속성입니다.

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

다음에 의해서 참조됨 : GetMax(), SetMax().

MinProperty

readonly DependencyProperty Dreamine.UI.Wpf.Behaviors.NumericRangeBehavior.MinProperty

static

초기값:

                                          =
DependencyProperty.RegisterAttached(
    "Min",
    typeof(double?),
    typeof(NumericRangeBehavior),
    new PropertyMetadata(null))

선택적인 최소 허용값을 저장하는 연결 속성입니다.

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

다음에 의해서 참조됨 : GetMin(), SetMin().

ModeProperty

readonly DependencyProperty Dreamine.UI.Wpf.Behaviors.NumericRangeBehavior.ModeProperty

static

초기값:

                                           =
DependencyProperty.RegisterAttached(
    "Mode",
    typeof(NumericRangeMode),
    typeof(NumericRangeBehavior),
    new PropertyMetadata(NumericRangeMode.Clamp))

범위를 벗어난 입력의 처리 방식을 저장하는 연결 속성입니다.

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

다음에 의해서 참조됨 : GetMode(), SetMode().

---

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

• NumericRangeBehavior.cs