Back to Details

syncfusion-wpf-percent-textbox

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Implementing Syncfusion WPF PercentTextBox

实现Syncfusion WPF PercentTextBox控件

When to Use This Skill

何时使用本技能

Use this skill when the user needs to:
  • Implement percentage input controls in WPF applications with value restrictions and formatting
  • Configure value validation with minimum/maximum limits and validation timing (OnKeyPress vs OnLostFocus)
  • Apply number formatting with culture-specific separators, decimal digits, and group sizes
  • Customize appearance with different foreground colors for positive, negative, and zero values
  • Enable interactive features like scroll intervals, mouse wheel support, click-and-drag value changes
  • Display visual progress using range adorner to show value relative to min/max range
  • Bind percentage data from ViewModels with property change notifications
  • Handle null values with custom null displays or watermark text
  • Implement international formats with culture-based decimal/group separators and percent symbols
The PercentTextBox control restricts input to double values and displays them as percentages with extensive customization options for data binding, validation, formatting, and appearance.
当用户需要以下功能时，可使用本技能：
  • 在WPF应用中实现带值限制和格式化的百分比输入控件
  • 配置值验证，包括最小/最大值限制和验证时机（OnKeyPress 对比 OnLostFocus）
  • 应用数字格式化，支持区域文化特定的分隔符、小数位数和分组大小
  • 定制外观，为正、负、零值设置不同的前景色
  • 启用交互功能，如滚动间隔、鼠标滚轮支持、点击拖动修改值
  • 使用范围装饰器显示视觉进度，展示当前值相对于最小/最大值范围的位置
  • 从ViewModel绑定百分比数据，支持属性变更通知
  • 处理空值，支持自定义空值显示或水印文本
  • 实现国际格式，支持基于区域文化的小数/分组分隔符和百分比符号
PercentTextBox控件仅允许输入double类型值，并以百分比形式显示，在数据绑定、验证、格式化和外观方面提供了丰富的定制选项。

Component Overview

组件概述

The Syncfusion WPF PercentTextBox is a specialized input control that:
  • Restricts input to double values only (no text allowed)
  • Displays values as percentages with customizable symbols and patterns
  • Supports min/max value validation with configurable validation timing
  • Provides data binding support for MVVM patterns
  • Offers culture-specific formatting with group separators and decimal digits
  • Allows different foreground colors for positive, negative, and zero values
  • Supports interactive value changes via keyboard arrows, mouse wheel, and click-drag
  • Includes range adorner for visual progress indication
  • Handles null values with watermark text support
  • Provides built-in visual styles and themes
Syncfusion WPF PercentTextBox是一款专用输入控件，具备以下特性：
  • 仅允许输入double类型值（不支持文本输入）
  • 以百分比形式显示值，支持自定义符号和格式
  • 支持最小/最大值验证，可配置验证时机
  • 提供数据绑定支持，适配MVVM模式
  • 支持区域文化特定的格式化，包括分组分隔符和小数位数
  • 允许为正、负、零值设置不同的前景色
  • 支持通过键盘箭头、鼠标滚轮和点击拖动交互修改值
  • 包含范围装饰器，用于视觉进度指示
  • 支持空值处理，提供水印文本功能
  • 提供内置视觉样式和主题

Documentation and Navigation Guide

文档与导航指南

Getting Started

快速入门

📄 Read: references/getting-started.md
Use this reference when you need to:
  • Add PercentTextBox to a WPF project (via designer, XAML, or C#)
  • Configure assembly deployment and NuGet packages (Syncfusion.Shared.WPF)
  • Understand basic PercentValue property usage
  • Set up initial control dimensions and placement
  • Learn the basic control declaration patterns
📄 阅读： references/getting-started.md
当你需要以下操作时，可参考此文档：
  • 在WPF项目中添加PercentTextBox控件（通过设计器、XAML或C#代码）
  • 配置程序集部署和NuGet包（Syncfusion.Shared.WPF）
  • 理解PercentValue属性的基本用法
  • 设置控件的初始尺寸和布局
  • 学习控件的基本声明模式

Value Management and Binding

值管理与绑定

📄 Read: references/value-management.md
Use this reference when you need to:
  • Set and change percentage values using PercentValue property
  • Implement data binding (unidirectional or bidirectional) with ViewModels
  • Handle PercentValueChanged events to track value changes
  • Configure null value behavior with NullValue and UseNullOption properties
  • Display watermark text when control is empty or null
  • Customize watermark appearance with foreground colors or templates
  • Control paste behavior with PasteMode property (Default vs Advanced)
  • Add spin buttons for increment/decrement operations
📄 阅读： references/value-management.md
当你需要以下操作时，可参考此文档：
  • 使用PercentValue属性设置和修改百分比值
  • 实现与ViewModel的单向或双向数据绑定
  • 处理PercentValueChanged事件以跟踪值变化
  • 使用NullValue和UseNullOption属性配置空值行为
  • 控件为空或值为空时显示水印文本
  • 自定义水印的前景色或模板
  • 使用PasteMode属性控制粘贴行为（Default 对比 Advanced）
  • 添加旋转按钮用于值的递增/递减

Validation and Restrictions

验证与限制

📄 Read: references/validation-and-restrictions.md
Use this reference when you need to:
  • Restrict values within minimum and maximum limits (MinValue, MaxValue)
  • Configure validation timing (MinValidation, MaxValidation: OnKeyPress vs OnLostFocus)
  • Control behavior when exceeding limits (MaxValueOnExceedMaxDigit, MinValueOnExceedMinDigit)
  • Restrict decimal digit count with MinPercentDecimalDigits and MaxPercentDecimalDigits
  • Understand property precedence for decimal digit settings
  • Enable read-only mode while allowing text selection and caret visibility
  • Prevent invalid input at key press vs validating on focus lost
📄 阅读： references/validation-and-restrictions.md
当你需要以下操作时，可参考此文档：
  • 将值限制在最小和最大值范围内（MinValue、MaxValue）
  • 配置验证时机（MinValidation、MaxValidation：OnKeyPress 或 OnLostFocus）
  • 定义超出限制时的行为（MaxValueOnExceedMaxDigit、MinValueOnExceedMinDigit）
  • 使用MinPercentDecimalDigits和MaxPercentDecimalDigits限制小数位数
  • 理解小数位数设置的属性优先级
  • 启用只读模式，同时允许文本选择和光标可见
  • 选择在按键时阻止无效输入，还是在失去焦点时验证

Number Formatting and Culture

数字格式化与区域文化

📄 Read: references/number-formatting.md
Use this reference when you need to:
  • Apply culture-specific formatting with Culture property
  • Configure NumberFormatInfo for custom number patterns
  • Set group separators (PercentGroupSeparator) and group sizes (PercentGroupSizes)
  • Customize decimal separators and digit counts
  • Change percentage symbol (PercentageSymbol)
  • Enable group separator display with GroupSeperatorEnabled
  • Define positive value patterns (PercentPositivePattern: 4 options)
  • Define negative value patterns (PercentNegativePattern: 12 options)
  • Understand property precedence (dedicated properties vs NumberFormat vs Culture)
📄 阅读： references/number-formatting.md
当你需要以下操作时，可参考此文档：
  • 使用Culture属性应用区域文化特定的格式化
  • 配置NumberFormatInfo以实现自定义数字格式
  • 设置分组分隔符（PercentGroupSeparator）和分组大小（PercentGroupSizes）
  • 自定义小数分隔符和小数位数
  • 修改百分比符号（PercentageSymbol）
  • 启用分组分隔符显示（GroupSeperatorEnabled）
  • 定义正值格式（PercentPositivePattern：4种选项）
  • 定义负值格式（PercentNegativePattern：12种选项）
  • 理解属性优先级（专用属性 对比 NumberFormat 对比 Culture）

Appearance Customization

外观定制

📄 Read: references/appearance-customization.md
Use this reference when you need to:
  • Set different foreground colors for positive values (PositiveForeground)
  • Apply negative foreground with ApplyNegativeForeground and NegativeForeground
  • Display zero values with custom color (ApplyZeroColor, ZeroColor)
  • Customize background brush for the control
  • Apply corner radius for rounded borders
  • Configure selection brush and opacity for highlighted text
  • Align text (Left, Center, Right) using TextAlignment
  • Add tooltips with custom information
📄 阅读： references/appearance-customization.md
当你需要以下操作时，可参考此文档：
  • 为正值设置前景色（PositiveForeground）
  • 通过ApplyNegativeForeground和NegativeForeground应用负值前景色
  • 为零值设置自定义颜色（ApplyZeroColor、ZeroColor）
  • 自定义控件的背景画刷
  • 应用圆角边框（CornerRadius）
  • 配置选中文本的画刷和透明度
  • 使用TextAlignment设置文本对齐方式（左对齐、居中、右对齐）
  • 添加自定义信息的工具提示

Interactive Features

交互功能

📄 Read: references/interactive-features.md
Use this reference when you need to:
  • Configure scroll interval for value increments/decrements
  • Enable keyboard navigation with Up/Down arrow keys
  • Allow mouse wheel scrolling with IsScrollingOnCircle
  • Enable click-and-drag value changes with EnableExtendedScrolling
  • Control text selection behavior on focus (TextSelectionOnFocus)
  • Display spin buttons for manual increment/decrement
  • Enable range adorner for visual progress indication (EnableRangeAdorner)
  • Customize range adorner background color
  • Understand min/max requirements for range adorner display
📄 阅读： references/interactive-features.md
当你需要以下操作时，可参考此文档：
  • 配置值递增/递减的滚动间隔
  • 启用上下箭头键的键盘导航
  • 允许通过鼠标滚轮滚动修改值（IsScrollingOnCircle）
  • 启用点击拖动修改值的功能（EnableExtendedScrolling）
  • 控制获得焦点时的文本选择行为（TextSelectionOnFocus）
  • 显示旋转按钮用于手动递增/递减值
  • 启用范围装饰器以显示视觉进度（EnableRangeAdorner）
  • 自定义范围装饰器的背景色
  • 理解范围装饰器显示的最小/最大值要求

Quick Start Example

快速入门示例

Basic PercentTextBox in XAML

XAML中的基础PercentTextBox

xml
<Window xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:syncfusion="http://schemas.syncfusion.com/wpf">
    <Grid>
        <syncfusion:PercentTextBox x:Name="percentTextBox" 
                                   Width="150" 
                                   Height="30"
                                   PercentValue="75.5"
                                   MinValue="0"
                                   MaxValue="100"/>
    </Grid>
</Window>
xml
<Window xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:syncfusion="http://schemas.syncfusion.com/wpf">
    <Grid>
        <syncfusion:PercentTextBox x:Name="percentTextBox" 
                                   Width="150" 
                                   Height="30"
                                   PercentValue="75.5"
                                   MinValue="0"
                                   MaxValue="100"/>
    </Grid>
</Window>

Basic PercentTextBox in C#

C#中的基础PercentTextBox

csharp
using Syncfusion.Windows.Shared;

// Create instance
PercentTextBox percentTextBox = new PercentTextBox();
percentTextBox.Width = 150;
percentTextBox.Height = 30;

// Set value and limits
percentTextBox.PercentValue = 75.5;
percentTextBox.MinValue = 0;
percentTextBox.MaxValue = 100;

// Add to container
this.Content = percentTextBox;
csharp
using Syncfusion.Windows.Shared;

// 创建实例
PercentTextBox percentTextBox = new PercentTextBox();
percentTextBox.Width = 150;
percentTextBox.Height = 30;

// 设置值和限制
percentTextBox.PercentValue = 75.5;
percentTextBox.MinValue = 0;
percentTextBox.MaxValue = 100;

// 添加到容器
this.Content = percentTextBox;

Data Binding Example

数据绑定示例

xml
<!-- XAML -->
<syncfusion:PercentTextBox PercentValue="{Binding DiscountPercentage, UpdateSourceTrigger=PropertyChanged}"
                           Width="150" Height="30"
                           MinValue="0" MaxValue="100"/>
csharp
// ViewModel.cs
public class ViewModel : INotifyPropertyChanged
{
    private double discountPercentage;
    public double DiscountPercentage
    {
        get { return discountPercentage; }
        set
        {
            discountPercentage = value;
            OnPropertyChanged(nameof(DiscountPercentage));
        }
    }

    public event PropertyChangedEventHandler PropertyChanged;
    protected void OnPropertyChanged(string propertyName)
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }
}
xml
<!-- XAML -->
<syncfusion:PercentTextBox PercentValue="{Binding DiscountPercentage, UpdateSourceTrigger=PropertyChanged}"
                           Width="150" Height="30"
                           MinValue="0" MaxValue="100"/>
csharp
// ViewModel.cs
public class ViewModel : INotifyPropertyChanged
{
    private double discountPercentage;
    public double DiscountPercentage
    {
        get { return discountPercentage; }
        set
        {
            discountPercentage = value;
            OnPropertyChanged(nameof(DiscountPercentage));
        }
    }

    public event PropertyChangedEventHandler PropertyChanged;
    protected void OnPropertyChanged(string propertyName)
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }
}

Common Patterns

常见模式

Pattern 1: Percentage Input with Validation

模式1：带验证的百分比输入

When user needs a percentage input with immediate validation on keypress:
xml
<syncfusion:PercentTextBox PercentValue="50"
                           MinValue="0"
                           MaxValue="100"
                           MinValidation="OnKeyPress"
                           MaxValidation="OnKeyPress"
                           MaxValueOnExceedMaxDigit="True"
                           MinValueOnExceedMinDigit="True"/>
Why this works: OnKeyPress validation prevents invalid input immediately, and the exceed properties reset to limits when boundaries are crossed.
当用户需要一个在按键时立即验证的百分比输入控件时：
xml
<syncfusion:PercentTextBox PercentValue="50"
                           MinValue="0"
                           MaxValue="100"
                           MinValidation="OnKeyPress"
                           MaxValidation="OnKeyPress"
                           MaxValueOnExceedMaxDigit="True"
                           MinValueOnExceedMinDigit="True"/>
为何有效： OnKeyPress验证可立即阻止无效输入，超出限制时的属性会将值重置到边界值。

Pattern 2: Formatted Percentage with Culture

模式2：带区域文化的格式化百分比

When user needs culture-specific percentage formatting:
xml
<syncfusion:PercentTextBox PercentValue="1234.567"
                           Culture="de-DE"
                           GroupSeperatorEnabled="True"
                           PercentDecimalDigits="2"/>
Why this works: German culture uses "." for group separator and "," for decimal separator, automatically formatting the display.
当用户需要区域文化特定的百分比格式化时：
xml
<syncfusion:PercentTextBox PercentValue="1234.567"
                           Culture="de-DE"
                           GroupSeperatorEnabled="True"
                           PercentDecimalDigits="2"/>
为何有效： 德国区域文化使用“.”作为分组分隔符，“,”作为小数分隔符，会自动格式化显示内容。

Pattern 3: Color-Coded Percentage Values

模式3：颜色编码的百分比值

When user needs visual differentiation for positive/negative/zero values:
xml
<syncfusion:PercentTextBox PercentValue="-15"
                           PositiveForeground="Green"
                           NegativeForeground="Red"
                           ApplyNegativeForeground="True"
                           ZeroColor="Gray"
                           ApplyZeroColor="True"/>
Why this works: Different colors help users quickly identify value states without reading the number.
当用户需要通过颜色区分正/负/零值时：
xml
<syncfusion:PercentTextBox PercentValue="-15"
                           PositiveForeground="Green"
                           NegativeForeground="Red"
                           ApplyNegativeForeground="True"
                           ZeroColor="Gray"
                           ApplyZeroColor="True"/>
为何有效： 不同颜色帮助用户无需读取数字即可快速识别值的状态。

Pattern 4: Interactive Percentage with Scroll

模式4：带滚动功能的交互式百分比输入

When user needs quick value adjustments via keyboard/mouse:
xml
<syncfusion:PercentTextBox PercentValue="25"
                           ScrollInterval="5"
                           IsScrollingOnCircle="True"
                           EnableExtendedScrolling="True"
                           ShowSpinButton="True"/>
Why this works: Multiple interaction methods (arrow keys, mouse wheel, spin buttons, click-drag) provide flexibility for user preference.
当用户需要通过键盘/鼠标快速调整值时：
xml
<syncfusion:PercentTextBox PercentValue="25"
                           ScrollInterval="5"
                           IsScrollingOnCircle="True"
                           EnableExtendedScrolling="True"
                           ShowSpinButton="True"/>
为何有效： 多种交互方式（箭头键、鼠标滚轮、旋转按钮、点击拖动）可满足用户的不同偏好。

Pattern 5: Range Adorner for Visual Feedback

模式5：带视觉反馈的范围装饰器

When user needs visual progress indication:
xml
<syncfusion:PercentTextBox PercentValue="65"
                           MinValue="0"
                           MaxValue="100"
                           EnableRangeAdorner="True"
                           RangeAdornerBackground="LightBlue"/>
Why this works: Range adorner fills the control background proportionally, showing progress at a glance like a progress bar.
当用户需要视觉进度指示时：
xml
<syncfusion:PercentTextBox PercentValue="65"
                           MinValue="0"
                           MaxValue="100"
                           EnableRangeAdorner="True"
                           RangeAdornerBackground="LightBlue"/>
为何有效： 范围装饰器会按比例填充控件背景，像进度条一样直观展示进度。

Pattern 6: Null Value with Watermark

模式6：带水印的空值处理

When user needs placeholder text for empty state:
xml
<syncfusion:PercentTextBox UseNullOption="True"
                           NullValue="{x:Null}"
                           WatermarkText="Enter discount %"
                           WatermarkTextIsVisible="True"
                           WatermarkTextForeground="Gray"/>
Why this works: Watermark provides user guidance when control is empty, improving UX.
当用户需要为空状态设置占位文本时：
xml
<syncfusion:PercentTextBox UseNullOption="True"
                           NullValue="{x:Null}"
                           WatermarkText="Enter discount %"
                           WatermarkTextIsVisible="True"
                           WatermarkTextForeground="Gray"/>
为何有效： 水印会在控件为空时为用户提供指引，提升用户体验。

Key Properties Reference

关键属性参考

Value Properties

值相关属性

  • PercentValue - Gets or sets the percentage value (double)
  • MinValue - Minimum allowed value
  • MaxValue - Maximum allowed value
  • NullValue - Value to display when UseNullOption is true and value is null
  • UseNullOption - Enables null value handling
  • PercentValue - 获取或设置百分比值（double类型）
  • MinValue - 允许的最小值
  • MaxValue - 允许的最大值
  • NullValue - 当UseNullOption为true且值为空时显示的内容
  • UseNullOption - 启用空值处理

Validation Properties

验证相关属性

  • MinValidation - Validation timing for minimum (OnKeyPress, OnLostFocus)
  • MaxValidation - Validation timing for maximum (OnKeyPress, OnLostFocus)
  • MinValueOnExceedMinDigit - Reset to MinValue when exceeded (bool)
  • MaxValueOnExceedMaxDigit - Reset to MaxValue when exceeded (bool)
  • MinValidation - 最小值验证时机（OnKeyPress、OnLostFocus）
  • MaxValidation - 最大值验证时机（OnKeyPress、OnLostFocus）
  • MinValueOnExceedMinDigit - 超出最小值时重置为MinValue（布尔值）
  • MaxValueOnExceedMaxDigit - 超出最大值时重置为MaxValue（布尔值）

Formatting Properties

格式化相关属性

  • Culture - Culture for number formatting (CultureInfo)
  • NumberFormat - Custom NumberFormatInfo object
  • PercentGroupSeparator - Character for grouping (e.g., ",")
  • PercentGroupSizes - Array of group sizes (e.g., {3, 2})
  • PercentDecimalSeparator - Decimal point character (e.g., ".")
  • PercentDecimalDigits - Number of decimal places
  • MinPercentDecimalDigits - Minimum decimal digits
  • MaxPercentDecimalDigits - Maximum decimal digits
  • PercentageSymbol - Percent symbol (default "%")
  • GroupSeperatorEnabled - Show/hide group separator (bool)
  • PercentPositivePattern - Format for positive values (0-3)
  • PercentNegativePattern - Format for negative values (0-11)
  • Culture - 用于数字格式化的区域文化（CultureInfo）
  • NumberFormat - 自定义NumberFormatInfo对象
  • PercentGroupSeparator - 分组分隔符（例如“,”）
  • PercentGroupSizes - 分组大小数组（例如{3, 2}）
  • PercentDecimalSeparator - 小数点字符（例如“.”）
  • PercentDecimalDigits - 小数位数
  • MinPercentDecimalDigits - 最小小数位数
  • MaxPercentDecimalDigits - 最大小数位数
  • PercentageSymbol - 百分比符号（默认“%”）
  • GroupSeperatorEnabled - 显示/隐藏分组分隔符（布尔值）
  • PercentPositivePattern - 正值格式（0-3）
  • PercentNegativePattern - 负值格式（0-11）

Appearance Properties

外观相关属性

  • PositiveForeground - Foreground brush for positive values
  • NegativeForeground - Foreground brush for negative values
  • ApplyNegativeForeground - Enable negative foreground (bool)
  • ZeroColor - Foreground brush for zero value
  • ApplyZeroColor - Enable zero color (bool)
  • Background - Control background brush
  • CornerRadius - Border corner radius
  • SelectionBrush - Selected text background
  • SelectionOpacity - Selected text opacity (0-1)
  • TextAlignment - Text alignment (Left, Center, Right)
  • PositiveForeground - 正值的前景画刷
  • NegativeForeground - 负值的前景画刷
  • ApplyNegativeForeground - 启用负值前景色（布尔值）
  • ZeroColor - 零值的前景画刷
  • ApplyZeroColor - 启用零值颜色（布尔值）
  • Background - 控件背景画刷
  • CornerRadius - 边框圆角半径
  • SelectionBrush - 选中文本的背景画刷
  • SelectionOpacity - 选中文本的透明度（0-1）
  • TextAlignment - 文本对齐方式（左对齐、居中、右对齐）

Interactive Properties

交互相关属性

  • ScrollInterval - Increment/decrement step value
  • IsScrollingOnCircle - Enable mouse wheel scrolling (bool)
  • EnableExtendedScrolling - Enable click-drag scrolling (bool)
  • ShowSpinButton - Display up/down buttons (bool)
  • TextSelectionOnFocus - Auto-select text on focus (bool)
  • EnableRangeAdorner - Show range adorner (bool)
  • RangeAdornerBackground - Range adorner fill brush
  • ScrollInterval - 递增/递减的步长值
  • IsScrollingOnCircle - 启用鼠标滚轮滚动（布尔值）
  • EnableExtendedScrolling - 启用点击拖动滚动（布尔值）
  • ShowSpinButton - 显示上下按钮（布尔值）
  • TextSelectionOnFocus - 获得焦点时自动选中文本（布尔值）
  • EnableRangeAdorner - 显示范围装饰器（布尔值）
  • RangeAdornerBackground - 范围装饰器的填充画刷

Watermark Properties

水印相关属性

  • WatermarkText - Placeholder text string
  • WatermarkTextIsVisible - Show watermark (bool)
  • WatermarkTextForeground - Watermark text color
  • WatermarkTemplate - Custom DataTemplate for watermark
  • WatermarkText - 占位文本字符串
  • WatermarkTextIsVisible - 显示水印（布尔值）
  • WatermarkTextForeground - 水印文本颜色
  • WatermarkTemplate - 自定义水印的DataTemplate

Other Properties

其他属性

  • IsReadOnly - Prevent user editing (bool)
  • IsReadOnlyCaretVisible - Show caret in read-only mode (bool)
  • PasteMode - Paste behavior (Default, Advanced)
  • ToolTip - Tooltip text or object
  • IsReadOnly - 阻止用户编辑（布尔值）
  • IsReadOnlyCaretVisible - 只读模式下显示光标（布尔值）
  • PasteMode - 粘贴行为（Default、Advanced）
  • ToolTip - 工具提示文本或对象

Common Use Cases

常见使用场景

1. Discount/Tax Calculator

1. 折扣/税费计算器

Use PercentTextBox for discount or tax percentage inputs with 0-100% range, 2 decimal places, and immediate validation.
使用PercentTextBox作为折扣或税费百分比输入控件，限制范围0-100%，保留2位小数，并启用即时验证。

2. Progress/Completion Tracker

2. 进度/完成追踪器

Display project completion percentages with range adorner for visual feedback, restricted to 0-100%.
显示项目完成百分比，使用范围装饰器提供视觉反馈，限制范围0-100%。

3. Financial Calculations

3. 财务计算

Handle interest rates, ROI percentages, or growth rates with culture-specific formatting and multiple decimal places.
处理利率、投资回报率百分比或增长率，支持区域文化特定的格式化和多位小数。

4. Survey/Rating Systems

4. 调查/评分系统

Collect percentage-based ratings with color-coded foregrounds (green for high, red for low).
收集百分比形式的评分，使用颜色编码的前景色（高分绿色，低分红色）。

5. Resource Allocation

5. 资源分配

Input percentage allocations (e.g., budget distribution) with validation ensuring total doesn't exceed 100%.
输入百分比分配（例如预算分配），通过验证确保总和不超过100%。

6. Configuration Settings

6. 配置设置

Set performance thresholds, cache sizes, or buffer percentages with scroll intervals for quick adjustments.
设置性能阈值、缓存大小或缓冲区百分比，使用滚动间隔快速调整值。

7. Data Analysis Forms

7. 数据分析表单

Collect statistical percentages with group separators for large numbers and culture-specific formatting.
收集统计百分比，为大数字添加分组分隔符，并支持区域文化特定的格式化。

8. Dashboard Controls

8. 仪表板控件

Display KPI percentages with range adorners showing progress toward targets, bound to live data.
Next Steps:
  1. Read the appropriate reference file based on your specific implementation need
  2. Use the quick start example as a foundation
  3. Apply common patterns that match your use case
  4. Refer to key properties for fine-tuning behavior and appearance
显示KPI百分比，使用范围装饰器展示目标进度，并绑定到实时数据。
下一步操作：
  1. 根据你的具体实现需求，阅读对应的参考文档
  2. 以快速入门示例为基础进行开发
  3. 应用符合你使用场景的常见模式
  4. 参考关键属性来微调控件的行为和外观