syncfusion-winforms-button-edit

Syncfusion WinForms ButtonEdit の実装

ButtonEdit コントロールは、カスタマイズ可能な子ボタンを備えたテキストボックスを埋め込み、ファイルブラウザー、ドロップダウンコントロール、特殊な入力コントロールなどのインターフェイスを作成します。テキスト入力機能と操作可能なボタンを組み合わせています。

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

• ファイル／フォルダーのブラウザー UI： ブラウズボタンを備えたダイアログを作成する
• カスタムドロップダウン入力： ドロップダウンまたは選択コントロールを構築する
• 日付／時刻ピッカー： カレンダーボタン付きの日付ピッカーを実装する
• 複数ボタン付きテキストフィールド： 複数の操作ボタン（クリア、計算、検索など）を備えた入力欄を作成する
• 特殊なデータ入力： 操作ボタン付きの通貨、パーセンテージ、または検証済みテキスト入力
• 動的なボタン配置： テキストボックスの左側または右側にボタンを配置する

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

はじめに

📄 参照： references/getting-started.md

• アセンブリの配置と NuGet の設定
• Visual Studio デザイナーで ButtonEdit を作成する
• ButtonEdit をプログラムで追加する
• カスタムテキストボックスの種類を埋め込む
• コレクションに子ボタンを追加する

外観とスタイル設定

📄 参照： references/appearance-styling.md

• ビジュアルスタイルとボタンスタイル（Office2007、Office2016、Metro など）
• カスタムカラーと Office カラースキーム
• 境界線のスタイルとカスタマイズ
• サイズ制約（MinimumSize、MaximumSize）
• フォントと前景色
• テキストの大文字／小文字の設定

子ボタンのカスタマイズ

📄 参照： references/child-button-customization.md

• ボタンの種類と境界線のスタイル
• ボタンの配置（左／右）
• 画像とテキストの設定
• フラットスタイルの設定
• フォーカスとタブ移動
• 実行時にボタンを非表示にする

イベントと操作

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

• ButtonClicked イベントの処理
• 境界線プロパティの変更イベント
• 子ボタンのクリックイベント
• マウスイベント（MouseDown、MouseUp、MouseEnter、MouseLeave、MouseHover）
• カレンダーピッカーの完全な例

クイックスタート

// Add ButtonEdit through code
using Syncfusion.Windows.Forms.Tools;

public Form1()
{
    InitializeComponent();
    
    // Create ButtonEdit control
    ButtonEdit buttonEdit = new ButtonEdit();
    buttonEdit.Location = new Point(50, 50);
    buttonEdit.Size = new Size(250, 21);
    buttonEdit.Name = "buttonEdit1";
    this.Controls.Add(buttonEdit);
    
    // Add child button
    ButtonEditChildButton childButton = new ButtonEditChildButton();
    childButton.Text = "Browse";
    childButton.ButtonAlign = ButtonAlignment.Right;
    buttonEdit.Buttons.Add(childButton);
    
    // Handle button click
    buttonEdit.ButtonClicked += (s, e) => 
    {
        MessageBox.Show("Button clicked!");
    };
}

よく使われるパターン

ファイルブラウザーのパターン

FolderBrowserDialog を開くブラウズボタン付きの ButtonEdit を使用して、ファイルブラウザーを作成します。

ButtonEdit folderEdit = new ButtonEdit();
ButtonEditChildButton browseBtn = new ButtonEditChildButton();
browseBtn.Text = "...";
folderEdit.Buttons.Add(browseBtn);

folderEdit.ButtonClicked += (s, e) => 
{
    FolderBrowserDialog dialog = new FolderBrowserDialog();
    if (dialog.ShowDialog() == DialogResult.OK)
    {
        folderEdit.TextBox.Text = dialog.SelectedPath;
    }
};

複数ボタン入力のパターン

同じコントロールに異なる操作を行う複数のボタンを配置します。

ButtonEdit inputEdit = new ButtonEdit();

// Clear button (left)
ButtonEditChildButton clearBtn = new ButtonEditChildButton();
clearBtn.Text = "C";
clearBtn.ButtonAlign = ButtonAlignment.Left;
inputEdit.Buttons.Add(clearBtn);

// Calculate button (right)
ButtonEditChildButton calcBtn = new ButtonEditChildButton();
calcBtn.Text = "=";
calcBtn.ButtonAlign = ButtonAlignment.Right;
inputEdit.Buttons.Add(calcBtn);

inputEdit.ButtonClicked += (s, e) => 
{
    if (e.ClickedButton == clearBtn)
        inputEdit.TextBox.Text = string.Empty;
    else if (e.ClickedButton == calcBtn)
        inputEdit.TextBox.Text = "Calculate...";
};

カスタムテキストボックスの統合

既定のテキストボックスを特殊なテキストボックスに置き換えます。

ButtonEdit buttonEdit = new ButtonEdit();

// Use specialized textbox
PercentTextBox percentBox = new PercentTextBox();
buttonEdit.TextBox = percentBox;
buttonEdit.Controls.Add(percentBox);

ButtonEditChildButton btn = new ButtonEditChildButton();
btn.Text = "%";
buttonEdit.Buttons.Add(btn);

主なプロパティと設定

プロパティ	用途
TextBox	埋め込みテキストボックスコントロール（カスタムテキストボックスに置き換え可能）
Buttons	ButtonEditChildButton コントロールのコレクション
ButtonStyle	ビジュアルスタイル（Office2007、Office2016、Metro など）
UseVisualStyle	ビジュアルスタイルの描画を有効にする
Border3DStyle	境界線の外観（Raised、Sunken、Flat など）
ShowTextBox	埋め込みテキストボックスの表示／非表示
MinimumSize / MaximumSize	サイズ制約
CharacterCasing	テキストの大文字／小文字の設定（Upper、Lower、Normal）

---

次のステップ： 実装する内容に応じて上記のリファレンスを選択するか、セットアップ手順について「はじめに」から始めてください。