syncfusion-winforms-calculator

实现 Syncfusion Windows Forms 计算器

Syncfusion 计算器控件是一款功能完备的 Windows Forms 应用程序计算器。它支持标准和财务两种布局、键盘操作、内存功能，并可作为弹出控件嵌入。

何时使用此技能

当应用程序需要以下功能时，请使用计算器控件：

• 标准或科学计算器功能
• 键盘和鼠标输入支持
• 内存操作（MS、MR、M+、MC）
• 附加到输入字段的弹出计算器
• 显示计算结果和中间值
• 同时支持 C# 和 VB.NET

组件概述

CalculatorControl — 主计算器组件，提供布局模式、键盘支持和值计算事件

PopupCalculator — 用于将 CalculatorControl 显示为弹出窗口并附加到按钮或其他控件的包装类

主要特征

• 两种布局模式：标准（默认）和财务
• 全面的键盘支持，包含标准计算器快捷键
• 内存管理（MS、MR、M+、MC 操作）
• 可自定义对齐方式和字体的显示文本框
• 事件驱动架构（ValueCalculated、Closing 事件）
• 支持区域性设置的值格式化
• 轻量、可嵌入的组件

文档和导航指南

入门

📄 阅读： references/getting-started.md

• 程序集依赖项和 NuGet 安装
• 使用计算器创建 Windows Forms 项目
• 通过设计器或手动代码添加控件
• 必需的命名空间和基本实例化

布局和外观

📄 阅读： references/layout-and-appearance.md

• 标准与财务布局模式
• 背景颜色和图像
• 边框样式
• 按钮间距和样式
• 显示文本对齐方式

显示和数值处理

📄 阅读： references/display-and-value-handling.md

• 显示文本框属性和可见性
• 管理数值（String 与 Double）
• 特定区域性的格式化
• 字体自定义

键盘和运行时功能

📄 阅读： references/keyboard-and-runtime-features.md

• 完整的键盘快捷键参考
• 内存操作（MS、MR、M+、MC）
• 数值运算和计算
• 特殊函数（平方根、倒数、百分比）

事件和交互

📄 阅读： references/events-and-interaction.md

• ValueCalculated 事件处理
• PopupCalculator 的 Closing 事件
• 用于确定已完成操作的 LastAction 属性
• 错误情况处理

弹出计算器

📄 阅读： references/popup-calculator.md

• 创建 PopupCalculator 实例
• ParentControl 关联
• 弹出窗口对齐选项
• 显示和使用弹出计算器

快速入门示例

using Syncfusion.Windows.Forms.Tools;
using System.Windows.Forms;

public partial class Form1 : Form
{
    public Form1()
    {
        InitializeComponent();
        
        // Create Calculator control
        CalculatorControl calculatorControl = new CalculatorControl();
        calculatorControl.Size = new System.Drawing.Size(300, 250);
        calculatorControl.LayoutType = CalculatorLayoutTypes.WindowsStandard;
        
        // Add to form
        this.Controls.Add(calculatorControl);
        
        // Handle value changes
        calculatorControl.ValueCalculated += (sender, args) =>
        {
            if (!args.ErrorCondition && args.LastAction == CalcActions.CalcOperatorEquals)
            {
                MessageBox.Show($"Result: {calculatorControl.Value}");
            }
        };
    }
}

常见模式

模式 1：带事件处理的标准计算器

创建一个计算器，记录所有操作，并在按下“=”时显示最终结果。

CalculatorControl calc = new CalculatorControl();
calc.ValueCalculated += (sender, args) =>
{
    if (!args.ErrorCondition && args.LastAction == CalcActions.CalcOperatorEquals)
    {
        // Process final value
        double result = calc.DoubleValue;
    }
};

模式 2：点击按钮时显示弹出计算器

将计算器嵌入为弹出窗口，并在点击按钮时显示。

PopupCalculator popupCalc = new PopupCalculator();
popupCalc.ParentControl = myButton;
popupCalc.PopupCalculatorAlignment = CalculatorPopupAlignment.Right;
popupCalc.Closing += (sender, args) => 
{
    decimal finalValue = args.FinalValue;
};

模式 3：带自定义样式的财务布局

显示外观经过自定义的财务计算器。

CalculatorControl calc = new CalculatorControl();
calc.LayoutType = CalculatorLayoutTypes.Financial;
calc.DisplayTextAlign = System.Windows.Forms.HorizontalAlignment.Right;
calc.UseVerticalAndHorizontalSpacing = true;
calc.HorizontalSpacing = 5;
calc.VerticalSpacing = 5;

关键属性

属性	用途	备注
LayoutType	在标准和财务布局之间切换	默认为 WindowsStandard
ShowDisplayArea	显示/隐藏显示文本框	默认为 True
DoubleValue	获取/设置 double 类型的数值	用于计算
Value	获取当前值	返回 CalculatorValue 对象
Culture	设置数字格式化所用的区域性	会影响小数分隔符
DisplayTextAlign	设置显示文本的对齐方式（左/居中/右）	默认为 Right
FlatStyle	设置按钮外观（Flat/Popup/Standard）	更改按钮的呈现方式

常见用例

1. 财务计算器 — 在会计应用中使用财务布局模式和内存操作
2. 快速计算弹窗 — 将 PopupCalculator 附加到 TextBox，以便快速输入数值
3. 多输入项表单 — 在表单中放置计算器，让用户在输入前计算数值
4. 仅使用键盘输入 — 在以键盘操作为主的应用中，通过键盘快捷键使用计算器
5. 数值验证 — 按下“=”后，在 TextBox 中显示计算结果

---

后续步骤

• 从入门指南开始，将控件添加到项目中
• 探索布局与外观，自定义 UI
• 查看事件与交互，处理用户操作