syncfusion-maui-toolkit-numeric-updown

Syncfusion .NET MAUI NumericUpDown

SfNumericUpDown コントロールは、組み込みの検証機能、書式設定オプション、便利な増減ボタンを備え、使いやすい数値入力を実現します。検証済みの数値入力が必要な、プロフェッショナルなフォームの構築に最適です。

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

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

• .NET MAUI アプリケーションで数値入力フィールドを作成する
• 数値を通貨（C2）、パーセント（P2）、または小数（N2）として書式設定する
• 有効な範囲（Minimum／Maximum 値）に入力を制限する
• 上下矢印ボタンやキーボード操作で値をすばやく調整できるようにする
• 空の数値フィールドにプレースホルダーを表示する
• OnKeyFocus モードまたは OnLostFocus モードで検証を自動的に処理する
• ボタン、色、境界線、フォントの外観をカスタマイズする
• 文化圏に応じた数値表示で各地域の書式をサポートする

コンポーネントの概要

SfNumericUpDown（または NumericUpDown）コントロールは、.NET MAUI アプリケーションで数値を入力および編集するための、専用の入力フィールドです。次の 3 つの操作パターンを組み合わせています。

主な機能：

• 直接入力用のテキストフィールドを任意で使用して、数値を入力できます
• 値をすばやく調整するための増減ボタン（上下矢印）を提供します
• キーボード操作（矢印キー、Page Up／Down、Tab、Return）をサポートします
• 設定可能な範囲（Minimum／Maximum）で入力を検証します
• 文化圏、通貨、またはカスタム指定に応じて数値を書式設定します
• 値が設定されていない場合にプレースホルダーテキストを表示します

主な特長：

• スマートな検証： OnKeyFocus（リアルタイム）または OnLostFocus（遅延）の検証モード
• 柔軟な書式設定： 通貨（C2）、パーセント（P2）、小数（N2）、またはカスタム書式
• カスタマイズ可能なボタン： 配置モード（Inline、InlineVertical）、配置（Left、Right、Both）、色、カスタムテンプレート
• 制約のサポート： 最小／最大範囲、null の処理（AllowNull）、テキストのみのモード（IsEditable=false）
• イベント駆動： ValueChanged、Completed、Focused／Unfocused イベントによるフォームとの統合
• アクセシブル： WCAG への準拠、スクリーンリーダー、キーボードのみの操作をサポート

NumericUpDown を選ぶ場面：

• 増減ボタンを組み込みで備えた、プロフェッショナルな数値入力が必要な場合
• カスタムコードを記述せずに、自動検証と書式設定を行いたい場合
• 金融フォーム（価格、割引、パーセント）を作成する場合
• 在庫管理システム（数量、在庫レベル）を作成する場合
• 設定画面や環境設定画面を実装する場合
• 文化圏に応じた数値の書式設定が必要な場合

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

はじめに

📄 参照先： references/getting-started.md

• インストールと NuGet パッケージの設定
• MauiProgram.cs でのハンドラーの登録
• 基本的な NumericUpDown コントロールの追加
• XAML と C# による初期化パターン
• 初回の描画と検証モード

値の管理と制約

📄 参照先： references/value-management.md

• 数値の設定とバインド
• Minimum 値と Maximum 値による制限
• AllowNull プロパティによる null 値の処理
• 既定値と初期設定
• IsEditable による手動のテキスト編集の禁止

書式設定と表示オプション

📄 参照先： references/formatting-display.md

• 数値のカスタム書式（通貨、パーセント、小数）
• プレースホルダーテキストとプレースホルダーの色のカスタマイズ
• 文化圏に応じた数値表示
• 小数部の最大桁数の管理
• パーセントの表示モード（Value と Compute）
• カスタム書式指定子（0、#、C、P、N）

検証とイベント

📄 参照先： references/validation-events.md

• OldValue と NewValue を含む ValueChanged イベント
• 編集完了時の Completed イベント
• Focused イベントと Unfocused イベント
• ValueChangeMode（OnKeyFocus と OnLostFocus）
• プログラムによるフォーカス管理
• Return キーのコマンド

上下ボタンの制御

📄 参照： references/buttons-updown.md

• SmallChange と LargeChange の増分
• キーボードショートカット（矢印キー、Page Up／Down）
• マウスのスクロールホイールのサポート
• 上下ボタンの配置モード（Inline、InlineVertical）
• ボタンの配置（左、右、両側）
• ボタンの色のカスタマイズ
• カスタムボタンテンプレート
• 自動反転動作

カスタマイズと UI 機能

📄 参照： references/customization.md

• 枠線の表示とストロークの色
• テキストの色と配置のカスタマイズ
• フォントファミリー、サイズ、属性
• クリアボタンの表示とカスタマイズ
• カーソル位置とテキスト選択
• Return キーの種類とキーボードの動作
• 高度なスタイル設定のパターン
• よくある注意点とトラブルシューティング