syncfusion-winforms-domainupdownext

Windows Forms での DomainUpdownExt の実装

DomainUpdownExt は、値を選択するためのスピンボタンを備えた、最新のドロップダウンインターフェイスを提供する高度な Windows Forms コントロールです。インクリメント／デクリメントボタンやキーボード操作を使って、定義済みの項目リストをユーザーが参照する必要がある場面に最適です。

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

次のような場合に、このスキルを使用してください。

• スピンボタンで操作できるドロップダウンコントロールを作成する
• ユーザーが定義済みの値のリストを参照できるようにする
• コントロールの外観（境界線、色、スタイル）をカスタマイズする
• 値の選択に方向キーでの操作を有効にする
• テキストの配置とスピンボタンの向きを設定する
• ユーザー操作とキーボードイベントを処理する
• ユーザー入力に基づいて項目を動的に追加する

コンポーネントの概要

DomainUpdownExt は、スピンボタンと定義済みの項目リストを備えたテキストボックスの機能を組み合わせています。標準の ComboBox とは異なり、現在の項目のみを表示し、方向キーまたはスピンボタンを使ってリスト内を移動できます。

主な機能：

• プログラムから操作できる項目管理
• スピンボタンのカスタマイズ（向き、配置）
• キーボード操作への対応（方向キー、キーボードイベント）
• 外観のカスタマイズ（境界線、色、テキストの配置）
• 状態変更のイベント処理
• テキストと項目の検証

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

はじめに

📄 参照： references/getting-started.md

• アセンブリの依存関係とプロジェクトのセットアップ
• デザイナーを使ったコントロールの追加
• コードからコントロールを手動で追加する方法
• 最初の DomainUpdownExt コントロールの作成
• 基本的な項目管理

テキストと項目の管理

📄 参照： references/text-and-items.md

• コレクションへの項目の追加と削除
• テキストの配置プロパティ
• MaxLength の設定
• 選択した項目のプログラムによる管理
• 項目の検証パターン

スピンボタンの制御

📄 参照： references/spinbutton-control.md

• SpinOrientation プロパティ（水平／垂直）
• UpDownAlign プロパティ（左／右揃え）
• スピンボタンの外観の設定
• ボタンの既定の動作

外観とカスタマイズ

📄 参照： references/appearance-customization.md

• 境界線のスタイルとプロパティ
• 背景色と前景色
• 3D 境界線のスタイル
• コントロールの見た目と操作感のカスタマイズ
• 視覚的な外観のパターン

キーボード操作とインタラクション

📄 参照： references/keyboard-and-interaction.md

• 方向キーへの対応（InterceptArrowKeys プロパティ）
• KeyDown イベントの処理
• UpButton メソッドと DownButton メソッド
• プログラムによる値の参照
• キーボード操作のパターン

高度な使い方とパターン

📄 参照： references/advanced-usage.md

• ユーザー入力に基づいて実行時に項目を追加する
• プログラムによる値の移動
• イベント処理の方法
• 一般的なユースケースとパターン
• インタラクション設計のベストプラクティス

クイックスタートの例

項目とキーボード操作を備えた基本的な DomainUpdownExt コントロールを作成します。

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

public class Form1 : Form
{
    private DomainUpDownExt domainUpDownExt1;

    public Form1()
    {
        // Create control
        domainUpDownExt1 = new DomainUpDownExt();
        
        // Add items
        domainUpDownExt1.Items.Add("Option 1");
        domainUpDownExt1.Items.Add("Option 2");
        domainUpDownExt1.Items.Add("Option 3");
        domainUpDownExt1.Items.Add("Option 4");
        
        // Configure appearance
        domainUpDownExt1.BorderStyle = BorderStyle.FixedSingle;
        domainUpDownExt1.BackColor = System.Drawing.Color.White;
        domainUpDownExt1.SpinOrientation = Orientation.Vertical;
        
        // Enable keyboard navigation
        domainUpDownExt1.InterceptArrowKeys = true;
        
        // Add to form
        this.Controls.Add(domainUpDownExt1);
    }
}

よく使われるパターン

パターン 1：右揃えの垂直スピンボタン

domainUpDownExt1.SpinOrientation = Orientation.Vertical;
domainUpDownExt1.UpDownAlign = LeftRightAlignment.Right;

パターン 2：左揃えの水平スピンボタン

domainUpDownExt1.SpinOrientation = Orientation.Horizontal;
domainUpDownExt1.UpDownAlign = LeftRightAlignment.Left;

パターン 3：色付きの境界線を使った外観のカスタマイズ

domainUpDownExt1.BorderStyle = BorderStyle.FixedSingle;
domainUpDownExt1.BorderColor = System.Drawing.Color.Blue;
domainUpDownExt1.BackColor = System.Drawing.Color.LightGray;

パターン 4：プログラムによる移動

domainUpDownExt1.UpButton();    // Navigate to previous item
domainUpDownExt1.DownButton();  // Navigate to next item

主なプロパティ

プロパティ	型	目的	一般的な値
Items	Collection	項目のコレクションを取得します	項目の追加／削除
SelectedIndex	Int32	選択されている項目のインデックスを取得／設定します	0 to Items.Count - 1
Text	String	現在の表示テキストを取得／設定します	任意の文字列
SpinOrientation	Orientation	スピンボタンの方向を制御します	Vertical, Horizontal
UpDownAlign	LeftRightAlignment	スピンボタンの位置を制御します	Left, Right
InterceptArrowKeys	Boolean	矢印キーによるナビゲーションを有効／無効にします	true, false
BorderStyle	BorderStyle	境界線の外観を設定します	FixedSingle, Fixed3D, None
BorderColor	Color	境界線の色を設定します	任意の System.Drawing.Color
BackColor	Color	背景色を設定します	任意の System.Drawing.Color
TextAlign	HorizontalAlignment	テキストの配置を制御します	Left, Center, Right
MaxLength	Int32	テキストの最大長	0 to 32768

一般的な使用例

1. 数値範囲の選択 - ユーザーがあらかじめ定義された範囲から値を選択できるようにします
2. カテゴリのナビゲーション - あらかじめ定義されたカテゴリやオプションを参照します
3. ステータスの選択 - コンパクトなインターフェースで、個別のステータス値から選択します
4. 構成オプション - あらかじめ定義された構成値のセットから選択します
5. 優先度レベル - 個別の値のセットから優先度を選択します
6. 難易度レベル - スピン操作で難易度／強度のレベルを選択します