syncfusion-winforms-calculator

Q: How do I install syncfusion-winforms-calculator?

Run npx skills add https://github.com/syncfusion/winforms-ui-components-skills --skill syncfusion-winforms-calculator in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/syncfusion-winforms-calculator/ (personal) or .claude/skills/syncfusion-winforms-calculator/ (project).

by syncfusionFrontend & Design

Implement and configure Syncfusion Windows Forms Calculator control for numeric input and calculation interfaces. Use this when creating calculator UIs, handling calculator events, supporting keyboard input, displaying calculation results, or integrating calculator functionality into Windows Forms applications.

Installs: 76
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/syncfusion/winforms-ui-components-skills --skill syncfusion-winforms-calculator

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads syncfusion-winforms-calculator automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Implementing Syncfusion Windows Forms Calculator

The Syncfusion Calculator control is a fully-featured calculator for Windows Forms applications. It supports both standard and financial layouts, keyboard operations, memory functions, and can be embedded as a popup control.

When to Use This Skill

Use the Calculator control when your application needs:

Standard or scientific calculator functionality
Keyboard and mouse input support
Memory operations (MS, MR, M+, MC)
Popup calculator attached to input fields
Display of calculation results and intermediate values
Support for both C# and VB.NET

Component Overview

CalculatorControl — The main calculator component with layout modes, keyboard support, and value calculation events

PopupCalculator — A wrapper class to display CalculatorControl as a popup attached to buttons or other controls

Key Characteristics

Two layout modes: Standard (default) and Financial
Full keyboard support with standard calculator shortcuts
Memory management (MS, MR, M+, MC operations)
Display TextBox with customizable alignment and font
Event-driven architecture (ValueCalculated, Closing events)
Culture-aware value formatting
Lightweight, embeddable component

Documentation and Navigation Guide

Getting Started

📄 Read: references/getting-started.md

Assembly dependencies and NuGet installation
Create Windows Forms project with Calculator
Add control via Designer or manual code
Required namespaces and basic instantiation

Layout and Appearance

📄 Read: references/layout-and-appearance.md

Standard vs Financial layout modes
Background color and images
Border styles
Button spacing and styling
Display text alignment

Display and Value Handling

📄 Read: references/display-and-value-handling.md

Display TextBox properties and visibility
Managing numeric values (String vs Double)
Culture-specific formatting
Font customization

Keyboard and Runtime Features

📄 Read: references/keyboard-and-runtime-features.md

Complete keyboard shortcut reference
Memory operations (MS, MR, M+, MC)
Numeric operations and calculations
Special functions (sqrt, reciprocal, percentage)

Events and Interaction

📄 Read: references/events-and-interaction.md

ValueCalculated event handling
Closing event for PopupCalculator
LastAction property for determining completed operations
Error condition handling

Popup Calculator

📄 Read: references/popup-calculator.md

Creating PopupCalculator instances
ParentControl association
Popup alignment options
Displaying and using popup calculator

Quick Start Example

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}");
            }
        };
    }
}

Common Patterns

Pattern 1: Standard Calculator with Event Handling

Create a calculator that logs all operations and displays final results when "=" is pressed.

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

Pattern 2: Popup Calculator on Button Click

Embed calculator as a popup that displays when button is clicked.

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

Pattern 3: Financial Layout with Custom Styling

Display a financial calculator with custom appearance.

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

Key Properties

Property	Purpose	Notes
`LayoutType`	Switch between Standard and Financial layouts	Default is WindowsStandard
`ShowDisplayArea`	Show/hide the display TextBox	True by default
`DoubleValue`	Get/set numeric value as double	Use for calculations
`Value`	Get current value	Returns CalculatorValue object
`Culture`	Set culture for number formatting	Affects decimal separator
`DisplayTextAlign`	Align display text (Left/Center/Right)	Default is Right
`FlatStyle`	Button appearance (Flat/Popup/Standard)	Changes button rendering

Common Use Cases

Financial Calculator — Use Financial layout mode with memory operations for accounting applications
Quick Calculation Popup — Attach PopupCalculator to TextBox for quick value entry
Multi-Input Form — Place calculator on form for users to compute values before entering
Keyboard-Only Input — Calculator accessible via keyboard shortcuts in keyboard-driven apps
Value Validation — Display calculator result in TextBox after "=" pressed

Next Steps

Start with Getting Started to add the control to your project
Explore Layout and Appearance to customize the UI
Review Events and Interaction to handle user operations

FAQ

What does the syncfusion-winforms-calculator skill do?

How do I install syncfusion-winforms-calculator?

Run npx skills add https://github.com/syncfusion/winforms-ui-components-skills --skill syncfusion-winforms-calculator in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/syncfusion-winforms-calculator/ (personal) or .claude/skills/syncfusion-winforms-calculator/ (project).

Which AI agents can use syncfusion-winforms-calculator?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is syncfusion-winforms-calculator safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains syncfusion-winforms-calculator?

It is published by syncfusion in syncfusion/winforms-ui-components-skills. It has 76 recorded installs.