mcpField
S
syncfusion-winforms-double-textbox

syncfusion-winforms-double-textbox

github.com/syncfusion開発280 回インストール1 週間前に更新
リポジトリ

syncfusion-winforms-double-textbox について

Windows Forms で数値入力を扱う開発者向けの、Syncfusion DoubleTextBox のガイドです。書式設定、値の範囲制限、値変更イベント、キーボード操作を説明します。

主な機能

  1. 01double 値の検証と書式設定
  2. 02最小値と最大値の制限
  3. 03小数・桁区切り文字の設定
  4. 04値変更イベントの処理
  5. 05キー操作による増減

活用シーン

  1. 01通貨値の入力
  2. 02範囲を指定した割合の入力
  3. 03指定精度での測定値入力
  4. 04アプリケーションの数値設定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/syncfusion/winforms-ui-components-skills --skill syncfusion-winforms-double-textbox

インストール後、Claude Code で/syncfusion-winforms-double-textboxを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
appearance-and-behavior.md
event-handling-and-customization.md
getting-started.md
number-and-format-settings.md

詳細

Syncfusion WinForms DoubleTextBox の実装

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

次のような場合にこのスキルを使用します。

  • Windows Forms アプリケーションで倍精度浮動小数点値を受け取り、表示する
  • 小数桁数や桁区切りをカスタマイズできる数値入力を実装する
  • 数値入力に最小値／最大値の制約を適用する
  • 値変更イベントや、値を増減するキーボードショートカットを処理する
  • カスタム動作のためにコントロールの既定のキー入力処理をオーバーライドする
  • 正、負、ゼロの値に応じて視覚的なスタイルを適用する

コンポーネントの概要

DoubleTextBox は、倍精度データ型の値を処理する、Windows Forms フレームワークを継承した特殊なテキストボックスコントロールです。次の機能を提供します。

  • 倍精度値の自動検証と書式設定
  • 数値表示のカスタマイズ（小数桁数、区切り文字、パターン）
  • 最小値／最大値の制約
  • 値の変更とキーボード入力のイベント処理
  • 値を増減するキーボードショートカットのサポート
  • メソッドのオーバーライドによる拡張性

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

はじめに

📄 参照： references/getting-started.md

  • アセンブリの配置とセットアップ
  • デザイナーからコントロールを追加する
  • C# コードからコントロールを追加する
  • 最大値と最小値を設定する
  • 数値形式をカスタマイズする
数値と書式の設定

📄 参照： references/number-and-format-settings.md

  • 数値書式プロパティの概要
  • 小数桁数と区切り文字
  • 値の範囲の設定（MaxValue/MinValue）
  • バナーテキストのサポート
  • 末尾のゼロを非表示にする
外観と動作

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

  • 境界線のスタイル設定
  • 値の状態に応じた色の設定
  • キーボードサポートの設定
  • オーバーフローインジケーターの表示
  • 無効時のアクティブ動作
イベント処理とカスタマイズ

📄 参照： references/event-handling-and-customization.md

  • DoubleValueChanged イベントの処理
  • 値の増減に関するキーボードイベント
  • コントロールの動作をオーバーライドする
  • HandleSubtractKey のカスタム実装
  • コントロール機能の拡張

クイックスタートの例

C# での基本的なセットアップ：

using Syncfusion.Windows.Forms.Tools;

// Create instance
DoubleTextBox doubleTextBox1 = new DoubleTextBox();
this.Controls.Add(doubleTextBox1);

// Set value constraints
doubleTextBox1.MaxValue = 100;
doubleTextBox1.MinValue = 0;

// Handle value changes
doubleTextBox1.DoubleValueChanged += (s, e) => 
    MessageBox.Show("Value changed");

主なプロパティ：

  • DoubleValue - 倍精度値を取得または設定します
  • MaxValue - 許可される最大値
  • MinValue - 許可される最小値
  • NumberDecimalDigits - 表示する小数桁数
  • NumberDecimalSeparator - 小数点区切り文字として使用する文字
  • NumberGroupSeparator - 桁区切り文字として使用する文字

よくあるパターン

パターン 1：パーセント入力を受け付ける（0～100）
doubleTextBox1.MinValue = 0;
doubleTextBox1.MaxValue = 100;
doubleTextBox1.NumberDecimalDigits = 2;
doubleTextBox1.Text = "50";
パターン 2：通貨値を受け付ける
doubleTextBox1.NumberDecimalDigits = 2;
doubleTextBox1.NumberGroupSeparator = ",";
doubleTextBox1.NumberDecimalSeparator = ".";
doubleTextBox1.Text = "1234.56";
パターン 3：キーボードで値を増減する
doubleTextBox1.KeyDown += (s, e) =>
{
    if (e.KeyCode == Keys.Up)
        doubleTextBox1.DoubleValue++;
    else if (e.KeyCode == Keys.Down)
        doubleTextBox1.DoubleValue--;
};
パターン 4：null／空の値を許可する
doubleTextBox1.AllowNull = true;
doubleTextBox1.NullString = "";
doubleTextBox1.Text = "";

主なプロパティ

プロパティ型用途
DoubleValuedoubleテキストボックスの倍精度値を取得または設定します
MaxValuedouble許可される最大値
MinValuedouble許可される最小値
NumberDecimalDigitsint表示する小数桁数
NumberDecimalSeparatorstring小数点区切り文字
NumberGroupSeparatorstring桁区切り文字
NumberGroupSizesint[]数値グループの桁数
NumberNegativePatternint負の数のパターン
HideTrailingZerosbool表示時に末尾のゼロを非表示にする
AllowNullboolnull／空の値を許可する
NullStringstringnull の文字列表現

一般的なユースケース

  1. 金融アプリケーション - 小数点以下2桁の通貨入力、値の制約
  2. 測定値の入力 - 小数点以下の桁数が変動する科学データ
  3. パーセンテージフィールド - 0～100の範囲に制限し、検証を実施
  4. 設定項目 - アプリケーションの調整に使用する数値パラメーター
  5. データ入力フォーム - 書式設定された検証済みの数値フィールド
  6. 合計の計算 - キーボードショートカットで値を増減

コメント

Markdown 対応