syncfusion-winforms-calculator

Syncfusion Windows Forms 電卓の実装

Syncfusion 電卓コントロールは、Windows Forms アプリケーション向けの多機能な電卓です。標準レイアウトと金融レイアウトの両方に対応し、キーボード操作やメモリ機能を備え、ポップアップコントロールとして埋め込むこともできます。

このスキルを使用する場合

次の機能がアプリケーションに必要な場合は、電卓コントロールを使用します。

• 標準または関数電卓の機能
• キーボードとマウスによる入力への対応
• メモリ操作（MS、MR、M+、MC）
• 入力フィールドに関連付けられたポップアップ電卓
• 計算結果と中間値の表示
• C# と VB.NET の両方への対応

コンポーネントの概要

CalculatorControl — レイアウトモード、キーボードへの対応、値の計算イベントを備えたメインの電卓コンポーネント

PopupCalculator — CalculatorControl をボタンやその他のコントロールに関連付けられたポップアップとして表示するラッパークラス

主な特徴

• 2 つのレイアウトモード：標準（既定）と金融
• 標準的な電卓ショートカットを含む、完全なキーボード対応
• メモリ管理（MS、MR、M+、MC 操作）
• 配置とフォントをカスタマイズできる表示用 TextBox
• イベント駆動型アーキテクチャ（ValueCalculated、Closing イベント）
• カルチャに応じた値の書式設定
• 軽量で埋め込み可能なコンポーネント

ドキュメントとナビゲーションガイド

はじめに

📄 参照： references/getting-started.md

• アセンブリの依存関係と NuGet によるインストール
• Calculator を使った Windows Forms プロジェクトの作成
• デザイナーまたは手動のコードによるコントロールの追加
• 必要な名前空間と基本的なインスタンス化

レイアウトと外観

📄 参照： references/layout-and-appearance.md

• 標準レイアウトと金融レイアウトの切り替え
• 背景色と画像
• 枠線のスタイル
• ボタンの間隔とスタイル
• 表示テキストの配置

表示と値の処理

📄 参照： references/display-and-value-handling.md

• 表示用 TextBox のプロパティと表示設定
• 数値の管理（String と Double）
• カルチャ固有の書式設定
• フォントのカスタマイズ

キーボードと実行時の機能

📄 参照： references/keyboard-and-runtime-features.md

• キーボードショートカットの完全な一覧
• メモリ操作（MS、MR、M+、MC）
• 数値操作と計算
• 特殊な関数（sqrt、逆数、パーセンテージ）

イベントと操作

📄 参照： 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	表示用 TextBox の表示／非表示を切り替える	既定値は True
DoubleValue	倍精度浮動小数点数として数値を取得／設定する	計算に使用します
Value	現在の値を取得する	CalculatorValue オブジェクトを返します
Culture	数値の書式設定に使用するカルチャを設定する	小数点の区切り文字に影響します
DisplayTextAlign	表示テキストを配置する（左／中央／右）	既定値は右
FlatStyle	ボタンの外観（フラット／ポップアップ／標準）	ボタンの描画方法を変更します

一般的なユースケース

1. 金融計算機 — 金融アプリケーション向けに、メモリ操作を備えた金融レイアウトモードを使用します
2. すばやく計算できるポップアップ — PopupCalculator を TextBox に関連付け、値をすばやく入力できるようにします
3. 複数入力フォーム — ユーザーが値を入力する前に計算できるよう、フォームに計算機を配置します
4. キーボードのみでの入力 — キーボード操作中心のアプリで、キーボードショートカットから計算機を利用できるようにします
5. 値の検証 — 「=」を押した後、計算結果を TextBox に表示します

---

次のステップ

• はじめにから始めて、コントロールをプロジェクトに追加します
• レイアウトと外観を確認し、UI をカスタマイズします
• イベントと操作を確認し、ユーザー操作を処理します