WPF

Code Examples Upgrade Guide User Guide Demos Support Forums Download
  • Code Examples
  • Upgrade Guide
  • User Guide
  • Demos
  • Support
  • Forums
  • Download
Class PercentTextBox

    Show / Hide Table of Contents

    Class PercentTextBox

    PercentTextBox

    Inheritance
    System.Object
    EditorBase
    PercentTextBox
    Implements
    System.IDisposable
    Inherited Members
    EditorBase.ReadOnlyProperty
    EditorBase.CornerRadiusProperty
    EditorBase.ShowSpinButtonProperty
    EditorBase.EnableTouchProperty
    EditorBase.EnableRangeAdornerProperty
    EditorBase.EnableExtendedScrollingProperty
    EditorBase.RangeAdornerBackgroundProperty
    EditorBase.FocusedBorderBrushProperty
    EditorBase.ReadOnlyBackgroundProperty
    EditorBase.SelectionForegroundProperty
    EditorBase.EnableFocusColorsProperty
    EditorBase.PasteModeProperty
    EditorBase.PositiveForegroundProperty
    EditorBase.EditorForegroundProperty
    EditorBase.NegativeForegroundProperty
    EditorBase.ApplyNegativeForegroundProperty
    EditorBase.IsNegativeProperty
    EditorBase.IsZeroProperty
    EditorBase.MaxValidationProperty
    EditorBase.MinValidationProperty
    EditorBase.MaxValueOnExceedMaxDigitProperty
    EditorBase.MinValueOnExceedMinDigitProperty
    EditorBase.IsNullProperty
    EditorBase.UseNullOptionProperty
    EditorBase.CultureProperty
    EditorBase.ZeroColorProperty
    EditorBase.ApplyZeroColorProperty
    EditorBase.NumberFormatProperty
    EditorBase.IsUndoEnabledProperty
    EditorBase.MaskedTextProperty
    EditorBase.WatermarkTemplateProperty
    EditorBase.WatermarkTextProperty
    EditorBase.WatermarkVisibilityProperty
    EditorBase.ContentElementVisibilityProperty
    EditorBase.WatermarkTextForegroundProperty
    EditorBase.WatermarkBackgroundProperty
    EditorBase.WatermarkOpacityProperty
    EditorBase.WatermarkTextIsVisibleProperty
    EditorBase.IsScrollingOnCircleProperty
    EditorBase.EnterToMoveNextProperty
    EditorBase.TextSelectionOnFocusProperty
    EditorBase.IsCaretAnimationEnabledProperty
    EditorBase.OnDrop(DragEventArgs)
    EditorBase.OnCornerRadiusChanged(DependencyObject, DependencyPropertyChangedEventArgs)
    EditorBase.OnEnableTouchChanged(DependencyObject, DependencyPropertyChangedEventArgs)
    EditorBase.OnEnableExtendedScrollingChanged(DependencyObject, DependencyPropertyChangedEventArgs)
    EditorBase.OnFocusedBackgroundChanged(DependencyObject, DependencyPropertyChangedEventArgs)
    EditorBase.OnFocusedForegroundChanged(DependencyObject, DependencyPropertyChangedEventArgs)
    EditorBase.OnFocusedBorderBrushChanged(DependencyObject, DependencyPropertyChangedEventArgs)
    EditorBase.OnReadOnlyBackgroundChanged(DependencyObject, DependencyPropertyChangedEventArgs)
    EditorBase.OnPositiveForegroundChanged(DependencyObject, DependencyPropertyChangedEventArgs)
    EditorBase.OnPositiveForegroundChanged(DependencyPropertyChangedEventArgs)
    EditorBase.OnApplyNegativeForegroundChanged(DependencyObject, DependencyPropertyChangedEventArgs)
    EditorBase.OnApplyNegativeForegroundChanged(DependencyPropertyChangedEventArgs)
    EditorBase.OnMinValidationChanged(DependencyObject, DependencyPropertyChangedEventArgs)
    EditorBase.OnZeroNegativeColorChanged(DependencyObject, DependencyPropertyChangedEventArgs)
    EditorBase.OnZeroNegativeColorChanged(DependencyPropertyChangedEventArgs)
    EditorBase.OnApplyZeroColorChanged(DependencyObject, DependencyPropertyChangedEventArgs)
    EditorBase.OnApplyZeroColorChanged(DependencyPropertyChangedEventArgs)
    EditorBase.OnWaterMarkTemplateChanged(DependencyObject, DependencyPropertyChangedEventArgs)
    EditorBase.OnWaterMarkTemplateChanged(DependencyPropertyChangedEventArgs)
    EditorBase.OnWaterMarkTextChanged(DependencyObject, DependencyPropertyChangedEventArgs)
    EditorBase.OnWaterMarkTextChanged(DependencyPropertyChangedEventArgs)
    EditorBase.OnWatermarkVisibilityPropertyChanged(DependencyObject, DependencyPropertyChangedEventArgs)
    EditorBase.OnWatermarkVisibilityPropertyChanged(DependencyPropertyChangedEventArgs)
    EditorBase.OnPreviewMouseLeftButtonDown(MouseButtonEventArgs)
    EditorBase.OnIsUndoEnabledChanged(DependencyObject, DependencyPropertyChangedEventArgs)
    EditorBase.OnIsUndoEnabledChanged(DependencyPropertyChangedEventArgs)
    EditorBase.OnNegativeForegroundChanged(DependencyObject, DependencyPropertyChangedEventArgs)
    EditorBase.OnNegativeForegroundChanged(DependencyPropertyChangedEventArgs)
    EditorBase.OnEnterToMoveNextChanged(DependencyObject, DependencyPropertyChangedEventArgs)
    EditorBase.OnEnterToMoveNextChanged(DependencyPropertyChangedEventArgs)
    EditorBase.OnForegroundChanged(DependencyObject, DependencyPropertyChangedEventArgs)
    EditorBase.OnForegroundChanged(DependencyPropertyChangedEventArgs)
    EditorBase.OnUseNullOptionChanged(DependencyObject, DependencyPropertyChangedEventArgs)
    EditorBase.OnIsNegativeChanged(DependencyObject, DependencyPropertyChangedEventArgs)
    EditorBase.OnIsNegativeChanged(DependencyPropertyChangedEventArgs)
    EditorBase.OnIsZeroChanged(DependencyObject, DependencyPropertyChangedEventArgs)
    EditorBase.OnIsZeroChanged(DependencyPropertyChangedEventArgs)
    EditorBase.OnIsNullChanged(DependencyObject, DependencyPropertyChangedEventArgs)
    EditorBase.OnIsNullChanged(DependencyPropertyChangedEventArgs)
    EditorBase.OnCultureChanged(DependencyObject, DependencyPropertyChangedEventArgs)
    EditorBase.OnCultureChanged(DependencyPropertyChangedEventArgs)
    EditorBase.OnNumberFormatChanged(DependencyObject, DependencyPropertyChangedEventArgs)
    EditorBase.OnNumberFormatChanged(DependencyPropertyChangedEventArgs)
    EditorBase.OnTextSelectionOnFocusChanged(DependencyObject, DependencyPropertyChangedEventArgs)
    EditorBase.OnTextSelectionOnFocusChanged(DependencyPropertyChangedEventArgs)
    EditorBase.ReadOnly
    EditorBase.CornerRadius
    EditorBase.ShowSpinButton
    EditorBase.EnableTouch
    EditorBase.EnableRangeAdorner
    EditorBase.EnableExtendedScrolling
    EditorBase.RangeAdornerBackground
    EditorBase.FocusedBorderBrush
    EditorBase.ReadOnlyBackground
    EditorBase.SelectionForeground
    EditorBase.EnableFocusColors
    EditorBase.PasteMode
    EditorBase.Culture
    EditorBase.NumberFormat
    EditorBase.EditorForeground
    EditorBase.PositiveForeground
    EditorBase.ApplyNegativeForeground
    EditorBase.IsNegative
    EditorBase.NegativeForeground
    EditorBase.IsZero
    EditorBase.ApplyZeroColor
    EditorBase.ZeroColor
    EditorBase.UseNullOption
    EditorBase.IsNull
    EditorBase.MaxValidation
    EditorBase.MinValidation
    EditorBase.MaxValueOnExceedMaxDigit
    EditorBase.MinValueOnExceedMinDigit
    EditorBase.IsUndoEnabled
    EditorBase.MaskedText
    EditorBase.WatermarkTemplate
    EditorBase.WatermarkText
    EditorBase.WatermarkVisibility
    EditorBase.ContentElementVisibility
    EditorBase.WatermarkTextForeground
    EditorBase.WatermarkBackground
    EditorBase.WatermarkOpacity
    EditorBase.WatermarkTextIsVisible
    EditorBase.IsScrollingOnCircle
    EditorBase.EnterToMoveNext
    EditorBase.TextSelectionOnFocus
    EditorBase.IsCaretAnimationEnabled
    EditorBase.CultureChanged
    EditorBase.NumberFormatChanged
    EditorBase.WaterMarkTemplateChanged
    EditorBase.WaterMarkTextChanged
    EditorBase.IsUndoEnabledChanged
    EditorBase.TextSelectionOnFocusChanged
    EditorBase.NegativeForegroundChanged
    EditorBase.IsValueNegativeChanged
    EditorBase.EnterToMoveNextChanged
    Namespace: Syncfusion.Windows.Shared
    Assembly: Syncfusion.Shared.Wpf.dll
    Syntax
    [SkinType(SkinVisualStyle = Skin.Office2010Silver, Type = typeof(PercentTextBox), XamlResource = "pack://application:,,,/Syncfusion.Shared.Wpf.Classic;component/Controls/Editors/Themes/Office2010SilverStyle.xaml")]
    [SkinType(SkinVisualStyle = Skin.Office2007Blue, Type = typeof(PercentTextBox), XamlResource = "pack://application:,,,/Syncfusion.Shared.Wpf.Classic;component/Controls/Editors/Themes/Office2007BlueStyle.xaml")]
    [SkinType(SkinVisualStyle = Skin.Office2007Silver, Type = typeof(PercentTextBox), XamlResource = "pack://application:,,,/Syncfusion.Shared.Wpf.Classic;component/Controls/Editors/Themes/Office2007SilverStyle.xaml")]
    [SkinType(SkinVisualStyle = Skin.Office2010Blue, Type = typeof(PercentTextBox), XamlResource = "pack://application:,,,/Syncfusion.Shared.Wpf.Classic;component/Controls/Editors/Themes/Office2010BlueStyle.xaml")]
    [SkinType(SkinVisualStyle = Skin.Office2010Black, Type = typeof(PercentTextBox), XamlResource = "pack://application:,,,/Syncfusion.Shared.Wpf.Classic;component/Controls/Editors/Themes/Office2010BlackStyle.xaml")]
    [SkinType(SkinVisualStyle = Skin.Office2003, Type = typeof(PercentTextBox), XamlResource = "pack://application:,,,/Syncfusion.Shared.Wpf.Classic;component/Controls/Editors/Themes/Office2003Style.xaml")]
    [SkinType(SkinVisualStyle = Skin.Blend, Type = typeof(PercentTextBox), XamlResource = "pack://application:,,,/Syncfusion.Shared.Wpf.Classic;component/Controls/Editors/Themes/BlendStyle.xaml")]
    [SkinType(SkinVisualStyle = Skin.SyncOrange, Type = typeof(PercentTextBox), XamlResource = "pack://application:,,,/Syncfusion.Shared.Wpf.Classic;component/Controls/Editors/Themes/SyncOrangeStyle.xaml")]
    [SkinType(SkinVisualStyle = Skin.ShinyRed, Type = typeof(PercentTextBox), XamlResource = "pack://application:,,,/Syncfusion.Shared.Wpf.Classic;component/Controls/Editors/Themes/ShinyRedStyle.xaml")]
    [SkinType(SkinVisualStyle = Skin.ShinyBlue, Type = typeof(PercentTextBox), XamlResource = "pack://application:,,,/Syncfusion.Shared.Wpf.Classic;component/Controls/Editors/Themes/ShinyBlueStyle.xaml")]
    [SkinType(SkinVisualStyle = Skin.Default, Type = typeof(PercentTextBox), XamlResource = "/Syncfusion.Shared.Wpf;component/Controls/Editors/Themes/Generic.xaml")]
    [SkinType(SkinVisualStyle = Skin.VS2010, Type = typeof(PercentTextBox), XamlResource = "pack://application:,,,/Syncfusion.Shared.Wpf.Classic;component/Controls/Editors/Themes/VS2010Style.xaml")]
    [SkinType(SkinVisualStyle = Skin.Metro, Type = typeof(PercentTextBox), XamlResource = "pack://application:,,,/Syncfusion.Shared.Wpf.Classic;component/Controls/Editors/Themes/MetroStyle.xaml")]
    [SkinType(SkinVisualStyle = Skin.Transparent, Type = typeof(PercentTextBox), XamlResource = "pack://application:,,,/Syncfusion.Shared.Wpf.Classic;component/Controls/Editors/Themes/TransparentStyle.xaml")]
    [SkinType(SkinVisualStyle = Skin.Office2013, Type = typeof(PercentTextBox), XamlResource = "pack://application:,,,/Syncfusion.Shared.Wpf.Classic;component/Controls/Editors/Themes/Office2013Style.xaml")]
    [SkinType(SkinVisualStyle = Skin.Office2007Black, Type = typeof(PercentTextBox), XamlResource = "pack://application:,,,/Syncfusion.Shared.Wpf.Classic;component/Controls/Editors/Themes/Office2007BlackStyle.xaml")]
    public class PercentTextBox : EditorBase, IDisposable

    Constructors

    PercentTextBox()

    Initializes a new instance of the PercentTextBox class.

    Declaration
    public PercentTextBox()

    Fields

    AllowMultipleSymbolProperty

    Identifies the AllowMultipleSymbol dependency property.

    Declaration
    public static readonly DependencyProperty AllowMultipleSymbolProperty
    Field Value
    Type Description
    System.Windows.DependencyProperty
    Remarks

    The identifier for the AllowMultipleSymbol dependency property.

    GroupSeperatorEnabledProperty

    Identifies the GroupSeperatorEnabled dependency property.

    Declaration
    public static readonly DependencyProperty GroupSeperatorEnabledProperty
    Field Value
    Type Description
    System.Windows.DependencyProperty
    Remarks

    The identifier for the GroupSeperatorEnabled dependency property.

    InvalidValueBehaviorProperty

    Identifies the InvalidValueBehavior dependency property.

    Declaration
    public static readonly DependencyProperty InvalidValueBehaviorProperty
    Field Value
    Type Description
    System.Windows.DependencyProperty
    Remarks

    The identifier for the InvalidValueBehavior dependency property.

    MaxPercentDecimalDigitsProperty

    Identifies the MaxPercentDecimalDigits dependency property.

    Declaration
    public static readonly DependencyProperty MaxPercentDecimalDigitsProperty
    Field Value
    Type Description
    System.Windows.DependencyProperty
    Remarks

    The identifier for the MaxPercentDecimalDigits dependency property.

    MaxValueProperty

    Identifies the MaxValue dependency property.

    Declaration
    public static readonly DependencyProperty MaxValueProperty
    Field Value
    Type Description
    System.Windows.DependencyProperty
    Remarks

    The identifier for the MaxValue dependency property.

    MinPercentDecimalDigitsProperty

    Identifies the MinPercentDecimalDigits dependency property.

    Declaration
    public static readonly DependencyProperty MinPercentDecimalDigitsProperty
    Field Value
    Type Description
    System.Windows.DependencyProperty
    Remarks

    The identifier for the MinPercentDecimalDigits dependency property.

    MinValueProperty

    Identifies the MinValue dependency property.

    Declaration
    public static readonly DependencyProperty MinValueProperty
    Field Value
    Type Description
    System.Windows.DependencyProperty
    Remarks

    The identifier for the MinValue dependency property.

    NullValueProperty

    Identifies the NullValue dependency property.

    Declaration
    public static readonly DependencyProperty NullValueProperty
    Field Value
    Type Description
    System.Windows.DependencyProperty
    Remarks

    The identifier for the NullValue dependency property.

    PercentageSymbolProperty

    Identifies the PercentageSymbol dependency property.

    Declaration
    public static readonly DependencyProperty PercentageSymbolProperty
    Field Value
    Type Description
    System.Windows.DependencyProperty
    Remarks

    The identifier for the PercentageSymbol dependency property.

    PercentDecimalDigitsProperty

    Identifies the PercentDecimalDigits dependency property.

    Declaration
    public static readonly DependencyProperty PercentDecimalDigitsProperty
    Field Value
    Type Description
    System.Windows.DependencyProperty
    Remarks

    The identifier for the PercentDecimalDigits dependency property.

    PercentDecimalSeparatorProperty

    Identifies the PercentDecimalSeparator dependency property.

    Declaration
    public static readonly DependencyProperty PercentDecimalSeparatorProperty
    Field Value
    Type Description
    System.Windows.DependencyProperty
    Remarks

    The identifier for the PercentDecimalSeparator dependency property.

    PercentEditModeProperty

    Identifies the PercentEditMode dependency property.

    Declaration
    public static readonly DependencyProperty PercentEditModeProperty
    Field Value
    Type Description
    System.Windows.DependencyProperty
    Remarks

    The identifier for the PercentEditMode dependency property.

    PercentGroupSeparatorProperty

    Identifies the PercentGroupSeparator dependency property.

    Declaration
    public static readonly DependencyProperty PercentGroupSeparatorProperty
    Field Value
    Type Description
    System.Windows.DependencyProperty
    Remarks

    The identifier for the PercentGroupSeparator dependency property.

    PercentGroupSizesProperty

    Identifies the PercentGroupSizes dependency property.

    Declaration
    public static readonly DependencyProperty PercentGroupSizesProperty
    Field Value
    Type Description
    System.Windows.DependencyProperty
    Remarks

    The identifier for the PercentGroupSizes dependency property.

    PercentNegativePatternProperty

    Identifies the PercentNegativePattern dependency property.

    Declaration
    public static readonly DependencyProperty PercentNegativePatternProperty
    Field Value
    Type Description
    System.Windows.DependencyProperty
    Remarks

    The identifier for the PercentNegativePattern dependency property.

    PercentPositivePatternProperty

    Identifies the PercentPositivePattern dependency property.

    Declaration
    public static readonly DependencyProperty PercentPositivePatternProperty
    Field Value
    Type Description
    System.Windows.DependencyProperty
    Remarks

    The identifier for the PercentPositivePatternProperty dependency property.

    PercentValueProperty

    Identifies the PercentValue dependency property.

    Declaration
    public static readonly DependencyProperty PercentValueProperty
    Field Value
    Type Description
    System.Windows.DependencyProperty
    Remarks

    The identifier for the PercentValue dependency property.

    ScrollIntervalProperty

    Identifies the ScrollInterval dependency property.

    Declaration
    public static readonly DependencyProperty ScrollIntervalProperty
    Field Value
    Type Description
    System.Windows.DependencyProperty
    Remarks

    The identifier for the ScrollInterval dependency property.

    ValidationCompletedProperty

    Identifies the ValidationCompleted dependency property.

    Declaration
    public static readonly DependencyProperty ValidationCompletedProperty
    Field Value
    Type Description
    System.Windows.DependencyProperty
    Remarks

    The identifier for the ValidationCompleted dependency property.

    ValidationOnLostFocusProperty

    Identifies the ValidationOnLostFocus dependency property.

    Declaration
    public static readonly DependencyProperty ValidationOnLostFocusProperty
    Field Value
    Type Description
    System.Windows.DependencyProperty
    Remarks

    The identifier for the ValidationOnLostFocus dependency property.

    ValidationValueProperty

    Identifies the ValidationValue dependency property.

    Declaration
    public static readonly DependencyProperty ValidationValueProperty
    Field Value
    Type Description
    System.Windows.DependencyProperty
    Remarks

    The identifier for the ValidationValue dependency property.

    ValueValidationProperty

    Identifies the ValueValidation dependency property.

    Declaration
    public static readonly DependencyProperty ValueValidationProperty
    Field Value
    Type Description
    System.Windows.DependencyProperty
    Remarks

    The identifier for the ValueValidation dependency property.

    Properties

    AllowMultipleSymbol

    Gets or sets a value that indicates whether allow multiple separator when PercentDecimalSeparator is set(^^).

    Declaration
    public bool AllowMultipleSymbol { get; set; }
    Property Value
    Type Description
    System.Boolean

    copycommand

    Gets the value that represents the Copy command.

    Declaration
    public ICommand copycommand { get; }
    Property Value
    Type Description
    System.Windows.Input.ICommand

    cutcommand

    Gets the value that represents the Cut command.

    Declaration
    public ICommand cutcommand { get; }
    Property Value
    Type Description
    System.Windows.Input.ICommand

    GroupSeperatorEnabled

    Declaration
    public bool GroupSeperatorEnabled { get; set; }
    Property Value
    Type Description
    System.Boolean

    InvalidValueBehavior

    Gets or sets the way of PercentTextBox reaction on wrong input data.

    Declaration
    public InvalidInputBehavior InvalidValueBehavior { get; set; }
    Property Value
    Type Description
    InvalidInputBehavior

    MaxPercentDecimalDigits

    Gets or sets the maximum number of decimal places to use in percent value.

    Declaration
    public int MaxPercentDecimalDigits { get; set; }
    Property Value
    Type Description
    System.Int32

    The default value is -1.

    Remarks

    When MaxPercentDecimalDigits is 2, PercentTextBox will not show more than 2 decimal digits. When PercentValue does not has any decimal digits, PercentTextBox will not display any decimal digits. If PercentValue has more than 2 decimal places, rounded off value will be displayed. MaxPercentDecimalDigits, MinPercentDecimalDigits can be used at the same time. When MinPercentDecimalDigits, MaxPercentDecimalDigits and PercentDecimalDigits are specified, PercentDecimalDigits property takes higher precedence.

    See Also
    PercentDecimalDigits
    MinPercentDecimalDigits

    MaxValue

    Gets or sets the maximum value of PercentTextBox.

    Declaration
    public double MaxValue { get; set; }
    Property Value
    Type Description
    System.Double

    It returns double value. The default value is double.MaxValue.

    MinPercentDecimalDigits

    Gets or sets the minimum number of decimal places to use in percent value.

    Declaration
    public int MinPercentDecimalDigits { get; set; }
    Property Value
    Type Description
    System.Int32

    The default value is -1.

    Remarks

    When MinPercentDecimalDigits is 2, PercentTextBox will show at least 2 decimal digits. When PercentValue has less than 2 decimal digits, PercentTextBox will display 2 trailing zeros after decimal point. If PercentValue has more than 2 decimal places, all digits will be displayed. MinPercentDecimalDigits, MaxPercentDecimalDigits can be used at the same time. When MinPercentDecimalDigits, MaxPercentDecimalDigits and PercentDecimalDigits are specified, PercentDecimalDigits property takes higher precedence.

    See Also
    PercentDecimalDigits
    MaxPercentDecimalDigits

    MinValue

    Gets or sets the minimum value of PercentTextBox.

    Declaration
    public double MinValue { get; set; }
    Property Value
    Type Description
    System.Double

    It returns percent value. The default value is MinValue.

    NullValue

    Gets or sets the null value of PercentTextBox.

    Declaration
    public double? NullValue { get; set; }
    Property Value
    Type Description
    System.Nullable<System.Double>

    Returns double value. The default value is null.

    pastecommand

    Gets the value that represents the Paste command.

    Declaration
    public ICommand pastecommand { get; }
    Property Value
    Type Description
    System.Windows.Input.ICommand

    PercentageSymbol

    Gets or sets the value indicating the percentage symbol.

    Declaration
    public string PercentageSymbol { get; set; }
    Property Value
    Type Description
    System.String

    PercentDecimalDigits

    Gets or sets the number of decimal places to use in percent value.

    Declaration
    public int PercentDecimalDigits { get; set; }
    Property Value
    Type Description
    System.Int32

    The default value is -1.

    Remarks

    When PercentDecimalDigits is 2, PercentTextBox will display exactly 2 decimal digits. If PercentValue has no decimal digits, PercentTextBox will display 2 trailing zeros after decimal point. If PercentValue has more than 2 decimal places, rounded off value will be displayed. When MinPercentDecimalDigits, MaxPercentDecimalDigits and PercentDecimalDigits are specified, PercentDecimalDigits property takes higher precedence.

    See Also
    MinPercentDecimalDigits
    MaxPercentDecimalDigits

    PercentDecimalSeparator

    Declaration
    public string PercentDecimalSeparator { get; set; }
    Property Value
    Type Description
    System.String

    PercentEditMode

    Gets or sets the percent edit mode of the PercentTextBox control.

    Declaration
    public PercentEditMode PercentEditMode { get; set; }
    Property Value
    Type Description
    PercentEditMode

    PercentGroupSeparator

    Gets or Sets the percent group separator of PercentTextBox text.

    Declaration
    public string PercentGroupSeparator { get; set; }
    Property Value
    Type Description
    System.String

    A string contains the Special characters of PercentTextBox. The default value is string.Empty.

    PercentGroupSizes

    Declaration
    public Int32Collection PercentGroupSizes { get; set; }
    Property Value
    Type Description
    System.Windows.Media.Int32Collection

    PercentNegativePattern

    Gets or sets the value pattern for the negative PercentValue.

    Declaration
    public int PercentNegativePattern { get; set; }
    Property Value
    Type Description
    System.Int32

    PercentPositivePattern

    Gets or sets the value pattern for the positive PercentValue.

    Declaration
    public int PercentPositivePattern { get; set; }
    Property Value
    Type Description
    System.Int32

    PercentValue

    Gets or sets the value of PercentTextBox.

    Declaration
    public double? PercentValue { get; set; }
    Property Value
    Type Description
    System.Nullable<System.Double>

    It returns percent value. The default value is null.

    ScrollInterval

    Gets or sets the scroll interval of PercentTextBox.

    Declaration
    public double ScrollInterval { get; set; }
    Property Value
    Type Description
    System.Double

    Returns double value. The default value is 1.0.

    ValidationCompleted

    Declaration
    public bool ValidationCompleted { get; set; }
    Property Value
    Type Description
    System.Boolean

    ValidationOnLostFocus

    Gets or sets a value that indicates whether validation on the lost focus is enabled.

    Declaration
    public bool ValidationOnLostFocus { get; set; }
    Property Value
    Type Description
    System.Boolean

    ValidationValue

    Gets or Sets the string that the formatted input string is being validated.

    Declaration
    public string ValidationValue { get; set; }
    Property Value
    Type Description
    System.String

    A string containing the text contents of the text box. The default is an String.Empty.

    ValueValidation

    Gets or sets the string validation constraint for the PercentTextBox.

    Declaration
    public StringValidation ValueValidation { get; set; }
    Property Value
    Type Description
    StringValidation

    Returns string validation value. The Default value is StringValidation.OnLostFocus.

    Methods

    Dispose()

    Dispose the PercentTextBox

    Declaration
    public void Dispose()

    OnApplyTemplate()

    Invoked before the UI element displays in an application.

    Declaration
    public override void OnApplyTemplate()

    OnContextMenuOpening(ContextMenuEventArgs)

    Invoked when System.Windows.FrameworkElement.ContextMenuOpening event occurs.

    Declaration
    protected override void OnContextMenuOpening(ContextMenuEventArgs e)
    Parameters
    Type Name Description
    System.Windows.Controls.ContextMenuEventArgs e

    The System.Windows.Controls.ContextMenuEventArgs that contains the event data.

    Overrides
    EditorBase.OnContextMenuOpening(ContextMenuEventArgs)

    OnGotFocus(RoutedEventArgs)

    Invoked before System.Windows.UIElement.GotFocus event occurs.

    Declaration
    protected override void OnGotFocus(RoutedEventArgs e)
    Parameters
    Type Name Description
    System.Windows.RoutedEventArgs e

    The System.Windows.RoutedEventArgs that contains the event data.

    Overrides
    EditorBase.OnGotFocus(RoutedEventArgs)

    OnInvalidValueBehaviorChanged(DependencyObject, DependencyPropertyChangedEventArgs)

    Invoked when InvalidValueBehavior property changed.

    Declaration
    public static void OnInvalidValueBehaviorChanged(DependencyObject obj, DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyObject obj

    The obj contains a PercentTextBox.

    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnInvalidValueBehaviorChanged(DependencyPropertyChangedEventArgs)

    Invoked when InvalidValueBehavior property changed.

    Declaration
    protected void OnInvalidValueBehaviorChanged(DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnKeyDown(KeyEventArgs)

    Invoked when System.Windows.UIElement.KeyDown event occurs.

    Declaration
    protected override void OnKeyDown(KeyEventArgs e)
    Parameters
    Type Name Description
    System.Windows.Input.KeyEventArgs e

    The System.Windows.Input.KeyEventArgs that contains the event data.

    OnLostFocus(RoutedEventArgs)

    Invoked before System.Windows.UIElement.LostFocus event occurs.

    Declaration
    protected override void OnLostFocus(RoutedEventArgs e)
    Parameters
    Type Name Description
    System.Windows.RoutedEventArgs e

    The System.Windows.RoutedEventArgs that contains the event data.

    Overrides
    EditorBase.OnLostFocus(RoutedEventArgs)

    OnMaxValueChanged(DependencyObject, DependencyPropertyChangedEventArgs)

    Invoked when MaxValue property changed.

    Declaration
    public static void OnMaxValueChanged(DependencyObject obj, DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyObject obj
    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnMaxValueChanged(DependencyPropertyChangedEventArgs)

    Invoked when MaxValue property changed.

    Declaration
    protected void OnMaxValueChanged(DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnMinValueChanged(DependencyObject, DependencyPropertyChangedEventArgs)

    Invoked when MinValue property changed.

    Declaration
    public static void OnMinValueChanged(DependencyObject obj, DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyObject obj

    The obj contains a PercentTextBox.

    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnMinValueChanged(DependencyPropertyChangedEventArgs)

    Invoked when MinValue property changed.

    Declaration
    protected void OnMinValueChanged(DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnMouseWheel(MouseWheelEventArgs)

    Invoked when the System.Windows.UIElement.MouseWheel event occurs.

    Declaration
    protected override void OnMouseWheel(MouseWheelEventArgs e)
    Parameters
    Type Name Description
    System.Windows.Input.MouseWheelEventArgs e

    The System.Windows.Input.MouseWheelEventArgs that contains the event data.

    OnNullValueChanged(DependencyObject, DependencyPropertyChangedEventArgs)

    Invoked when NullValue property changed.

    Declaration
    public static void OnNullValueChanged(DependencyObject obj, DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyObject obj

    The obj contains a PercentTextBox.

    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnNullValueChanged(DependencyPropertyChangedEventArgs)

    Invoked when NullValue property changed.

    Declaration
    protected void OnNullValueChanged(DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnPercentageSymbolChanged(DependencyObject, DependencyPropertyChangedEventArgs)

    Invoked when PercentageSymbol property changed.

    Declaration
    public static void OnPercentageSymbolChanged(DependencyObject obj, DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyObject obj

    The obj contains a PercentTextBox.

    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnPercentageSymbolChanged(DependencyPropertyChangedEventArgs)

    Invoked when PercentageSymbol property changed.

    Declaration
    protected void OnPercentageSymbolChanged(DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnPercentDecimalDigitsChanged(DependencyObject, DependencyPropertyChangedEventArgs)

    Invoked when PercentDecimalDigits property changed.

    Declaration
    public static void OnPercentDecimalDigitsChanged(DependencyObject obj, DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyObject obj

    The obj contains a PercentTextBox.

    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnPercentDecimalDigitsChanged(DependencyPropertyChangedEventArgs)

    Invoked when PercentDecimalDigits property changed.

    Declaration
    protected void OnPercentDecimalDigitsChanged(DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnPercentDecimalSeparatorChanged(DependencyObject, DependencyPropertyChangedEventArgs)

    Invoked when PercentDecimalSeparator property changed.

    Declaration
    public static void OnPercentDecimalSeparatorChanged(DependencyObject obj, DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyObject obj

    The obj contains a PercentTextBox.

    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnPercentDecimalSeparatorChanged(DependencyPropertyChangedEventArgs)

    Invoked when PercentDecimalSeparator property changed.

    Declaration
    protected void OnPercentDecimalSeparatorChanged(DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnPercentEditModeChanged(DependencyObject, DependencyPropertyChangedEventArgs)

    Invoked when PercentEditMode property changed.

    Declaration
    public static void OnPercentEditModeChanged(DependencyObject obj, DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyObject obj

    The obj contains a PercentTextBox.

    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnPercentEditModeChanged(DependencyPropertyChangedEventArgs)

    Invoked when PercentEditMode property changed.

    Declaration
    protected void OnPercentEditModeChanged(DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnPercentGroupSeparatorChanged(DependencyObject, DependencyPropertyChangedEventArgs)

    Invoked when PercentGroupSeparator property changed.

    Declaration
    public static void OnPercentGroupSeparatorChanged(DependencyObject obj, DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyObject obj

    The obj contains a PercentTextBox.

    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnPercentGroupSeparatorChanged(DependencyPropertyChangedEventArgs)

    Invoked when PercentGroupSeparator property changed.

    Declaration
    protected void OnPercentGroupSeparatorChanged(DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnPercentGroupSizesChanged(DependencyObject, DependencyPropertyChangedEventArgs)

    Invoked when PercentGroupSizes property changed.

    Declaration
    public static void OnPercentGroupSizesChanged(DependencyObject obj, DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyObject obj

    The obj contains a PercentTextBox.

    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnPercentGroupSizesChanged(DependencyPropertyChangedEventArgs)

    Invoked when PercentGroupSizes property changed.

    Declaration
    protected void OnPercentGroupSizesChanged(DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnPercentNegativePatternChanged(DependencyObject, DependencyPropertyChangedEventArgs)

    Invoked when PercentNegativePattern property changed.

    Declaration
    public static void OnPercentNegativePatternChanged(DependencyObject obj, DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyObject obj

    The obj contains a PercentTextBox.

    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnPercentNegativePatternChanged(DependencyPropertyChangedEventArgs)

    Invoked when PercentNegativePattern property changed.

    Declaration
    protected void OnPercentNegativePatternChanged(DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnPercentPositivePatternChanged(DependencyObject, DependencyPropertyChangedEventArgs)

    Invoked when PercentPositivePattern property changed.

    Declaration
    public static void OnPercentPositivePatternChanged(DependencyObject obj, DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyObject obj

    The obj contains a PercentTextBox.

    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnPercentPositivePatternChanged(DependencyPropertyChangedEventArgs)

    Invoked when PercentPositivePattern property changed.

    Declaration
    protected void OnPercentPositivePatternChanged(DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnPreviewKeyDown(KeyEventArgs)

    Invoked when the System.Windows.Input.Keyboard.PreviewKeyDownEvent attached routed event occurs.

    Declaration
    protected override void OnPreviewKeyDown(KeyEventArgs e)
    Parameters
    Type Name Description
    System.Windows.Input.KeyEventArgs e

    The System.Windows.Input.KeyEventArgs that contains the event data.

    Overrides
    EditorBase.OnPreviewKeyDown(KeyEventArgs)

    OnPreviewLostKeyboardFocus(KeyboardFocusChangedEventArgs)

    Invoked when the keyboard is not focused on this element

    Declaration
    protected override void OnPreviewLostKeyboardFocus(KeyboardFocusChangedEventArgs e)
    Parameters
    Type Name Description
    System.Windows.Input.KeyboardFocusChangedEventArgs e

    The System.Windows.Input.KeyboardFocusChangedEventArgs that contains the event data.

    OnTextInput(TextCompositionEventArgs)

    Invoked before the System.Windows.UIElement.TextInput event occurs.

    Declaration
    protected override void OnTextInput(TextCompositionEventArgs e)
    Parameters
    Type Name Description
    System.Windows.Input.TextCompositionEventArgs e

    The System.Windows.Input.TextCompositionEventArgs that contains the event data.

    OnUseNullOptionChanged(DependencyPropertyChangedEventArgs)

    Invoked when UseNullOption property changed.

    Declaration
    public override void OnUseNullOptionChanged(DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    Overrides
    EditorBase.OnUseNullOptionChanged(DependencyPropertyChangedEventArgs)

    OnValidationCompletedPropertyChanged(DependencyObject, DependencyPropertyChangedEventArgs)

    Invoked when ValidationCompleted property changed.

    Declaration
    public static void OnValidationCompletedPropertyChanged(DependencyObject obj, DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyObject obj

    The obj contains a PercentTextBox.

    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnValidationCompletedPropertyChanged(DependencyPropertyChangedEventArgs)

    Invoked when ValidationCompleted property changed.

    Declaration
    protected void OnValidationCompletedPropertyChanged(DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnValidationOnLostFocusChanged(DependencyPropertyChangedEventArgs)

    Invoked when ValidationOnLostFocus property changed.

    Declaration
    protected virtual void OnValidationOnLostFocusChanged(DependencyPropertyChangedEventArgs e)
    Parameters
    Type Name Description
    System.Windows.DependencyPropertyChangedEventArgs e

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnValidationValueChanged(DependencyObject, DependencyPropertyChangedEventArgs)

    Invoked when ValidationValue property changed.

    Declaration
    public static void OnValidationValueChanged(DependencyObject obj, DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyObject obj

    The obj contains a PercentTextBox.

    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnValidationValueChanged(DependencyPropertyChangedEventArgs)

    Invoked when ValidationValue property changed.

    Declaration
    protected void OnValidationValueChanged(DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnValueChanged(DependencyObject, DependencyPropertyChangedEventArgs)

    Invoked when PercentValue property changed.

    Declaration
    public static void OnValueChanged(DependencyObject obj, DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyObject obj

    The obj contains a PercentTextBox.

    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    OnValueChanged(DependencyPropertyChangedEventArgs)

    Invoked when PercentValue property changed.

    Declaration
    protected void OnValueChanged(DependencyPropertyChangedEventArgs args)
    Parameters
    Type Name Description
    System.Windows.DependencyPropertyChangedEventArgs args

    The System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

    Events

    InvalidValueBehaviorChanged

    Occurs when the InvalidValueBehavior property is changed.

    Declaration
    public event PropertyChangedCallback InvalidValueBehaviorChanged
    Event Type
    Type Description
    System.Windows.PropertyChangedCallback

    MaxValueChanged

    Occurs when the MaxValue property is changed.

    Declaration
    public event PropertyChangedCallback MaxValueChanged
    Event Type
    Type Description
    System.Windows.PropertyChangedCallback

    MinValueChanged

    Occurs when the MinValue property is changed.

    Declaration
    public event PropertyChangedCallback MinValueChanged
    Event Type
    Type Description
    System.Windows.PropertyChangedCallback

    PercentageSymbolChanged

    Occurs when the PercentageSymbol property is changed.

    Declaration
    public event PropertyChangedCallback PercentageSymbolChanged
    Event Type
    Type Description
    System.Windows.PropertyChangedCallback

    PercentDecimalDigitsChanged

    Occurs when the PercentDecimalDigits property is changed.

    Declaration
    public event PropertyChangedCallback PercentDecimalDigitsChanged
    Event Type
    Type Description
    System.Windows.PropertyChangedCallback

    PercentDecimalSeparatorChanged

    Occurs when the PercentDecimalSeparator property is changed.

    Declaration
    public event PropertyChangedCallback PercentDecimalSeparatorChanged
    Event Type
    Type Description
    System.Windows.PropertyChangedCallback

    PercentEditModeChanged

    Occurs when the PercentEditMode property is changed.

    Declaration
    public event PropertyChangedCallback PercentEditModeChanged
    Event Type
    Type Description
    System.Windows.PropertyChangedCallback

    PercentGroupSeparatorChanged

    Occurs when the PercentGroupSeparator property is changed.

    Declaration
    public event PropertyChangedCallback PercentGroupSeparatorChanged
    Event Type
    Type Description
    System.Windows.PropertyChangedCallback

    PercentGroupSizesChanged

    Occurs when the PercentGroupSizes property is changed.

    Declaration
    public event PropertyChangedCallback PercentGroupSizesChanged
    Event Type
    Type Description
    System.Windows.PropertyChangedCallback

    PercentValueChanged

    Occurs when the PercentValue property is changed.

    Declaration
    public event PropertyChangedCallback PercentValueChanged
    Event Type
    Type Description
    System.Windows.PropertyChangedCallback

    Validated

    Occurs after validating the PercentValue.

    Declaration
    public event EventHandler Validated
    Event Type
    Type Description
    System.EventHandler

    Validating

    Occurs when validating the PercentValue.

    Declaration
    public event CancelEventHandler Validating
    Event Type
    Type Description
    System.ComponentModel.CancelEventHandler

    ValidationCompletedChanged

    Occurs when the ValidationCompleted property is changed.

    Declaration
    public event PropertyChangedCallback ValidationCompletedChanged
    Event Type
    Type Description
    System.Windows.PropertyChangedCallback

    ValidationOnLostFocusChanged

    Occurs when the ValidationOnLostFocus property is changed.

    Declaration
    public event PropertyChangedCallback ValidationOnLostFocusChanged
    Event Type
    Type Description
    System.Windows.PropertyChangedCallback

    ValidationValueChanged

    Occurs when the ValidationValue property is changed.

    Declaration
    public event PropertyChangedCallback ValidationValueChanged
    Event Type
    Type Description
    System.Windows.PropertyChangedCallback

    ValueValidationCompleted

    Occurs when PercentValue validation has completed.

    Declaration
    public event StringValidationCompletedEventHandler ValueValidationCompleted
    Event Type
    Type Description
    StringValidationCompletedEventHandler

    Explicit Interface Implementations

    IDisposable.Dispose()

    Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

    Declaration
    void IDisposable.Dispose()

    Implements

    System.IDisposable
    Back to top Generated by DocFX
    Copyright © 2001 - 2023 Syncfusion Inc. All Rights Reserved