【実務・中級編】NumericUpDownとTextBoxのシームレスな切り替え:フォーカス喪失時に自動でカンマ編集を行うカスタムコントロールの自社開発 – Visual Basic (VB / VB.NET)解析バイブル

スポンサーリンク

なぜ「TextBox」のままでは業務アプリの現場は崩壊するのか

業務アプリケーションにおいて、数値入力は最も頻繁に発生する操作だ。しかし、多くの開発者が標準の `TextBox` に `TextChanged` イベントで無理やりカンマを入れようとして、カーソル位置の跳ね返りや入力速度の低下という「負の遺産」を抱え込んでいる。

いいか、「入力中の操作性」と「確定後の可読性」は分離して設計せよ。 ユーザーが数値を打っている最中にカンマが割り込んでくると、入力フォーカスは迷子になる。我々が作るべきは、フォーカス取得時に「生の数値」を、喪失時に「フォーマッティング済みの文字列」を提示する、真にシームレスなカスタムコントロールだ。

今回は、`UserControl` ではなく、あえて `TextBox` を継承する手法を伝授する。これが最もメモリ負荷が低く、既存の業務ロジックを破壊しない「正解」の道筋だからだ。

—

堅牢な設計:継承とステート管理の極意

`TextBox` を継承し、内部で `Decimal` 型の値を保持する。この際、最も注意すべきは「編集モード」と「表示モード」の切り替えタイミングだ。

  • GotFocus: カンマを取り除き、純粋な数値形式(Raw Data)に戻す。
  • LostFocus: 入力値をバリデーションし、通貨記号と3桁カンマ(Formatted String)を適用する。

この設計なら、データベースへ保存する際は `.Value` プロパティを参照するだけで済む。画面上の表示形式に左右されないデータ層の分離こそが、バグを防ぐ鍵だ。

プロダクションコード:CurrencyTextBox.vb

Imports System.ComponentModel
Imports System.Globalization

”’

”’ フォーカス喪失時に自動的に通貨書式を適用する堅牢なカスタムTextBox
”’

Public Class CurrencyTextBox
Inherits TextBox

‘ バッキングフィールド:生の数値データを保持
Private _value As Decimal = 0D


Public Property Value As Decimal
Get
Return _value
End Get
Set(value As Decimal)
_value = value
UpdateDisplay()
End Set
End Property

Protected Overrides Sub OnGotFocus(e As EventArgs)
‘ フォーカス時は生の数値のみを表示
MyBase.Text = _value.ToString(“G”)
MyBase.OnGotFocus(e)
End Sub

Protected Overrides Sub OnLostFocus(e As EventArgs)
‘ フォーカス喪失時に入力値を解析し、書式を適用
If Decimal.TryParse(MyBase.Text, _value) Then
UpdateDisplay()
Else
‘ 不正な入力はゼロクリアまたは直前の値に復帰させる安全策を
_value = 0D
UpdateDisplay()
End If
MyBase.OnLostFocus(e)
End Sub

Private Sub UpdateDisplay()
‘ カンマ区切りと通貨記号の適用
‘ #,

0 形式で3桁カンマを強制

MyBase.Text = _value.ToString(“C0”, CultureInfo.CurrentCulture)
End Sub

‘ ユーザーによる直接編集を許可するためのコンストラクタ設定
Public Sub New()
Me.TextAlign = HorizontalAlignment.Right
End Sub
End Class

—

現場で死なないための注意点

1. データバインディングとの共存

このコントロールを `BindingSource` に繋ぐ場合、`DataBindings.Add` のタイミングで `DataSourceUpdateMode.OnPropertyChanged` を指定してはならない。値の変換が走るたびにカーソルが飛ぶからだ。必ず `OnValidation` 時に同期させる設定を徹底すること。

2. データベース連携(DB Null対策)

データベースの `NULL` は、VB.NETの `Decimal` 型では扱えない。データ取得時に `If IsDBNull(row(“Amount”)) Then Value = 0` といったガード節を必ず設けること。このコントロール自体に「Nullable」な状態を持たせる実装も可能だが、現場の保守性を考えると「0」をデフォルト値として扱う運用が最も事故が少ない。

3. CultureInfoの固定

`”C0″`(通貨書式)は、OSの地域設定に依存する。もし海外拠点とやり取りするアプリなら、`CultureInfo.CreateSpecificCulture(“ja-JP”)` を明示的に指定することを忘れるな。これが漏れると、特定のPCだけでカンマの代わりにドットが表示されるといった怪奇現象に見舞われることになる。

—

結びに:エンジニアの美学

単に「動くコード」を書くことは誰にでもできる。しかし、「なぜ標準コントロールを使わず、わざわざ継承してまでこの挙動にしたのか」という背景を言語化し、コードで証明できる人間だけが、真のエンジニアだ。

この `CurrencyTextBox` は、君のアプリケーションのUIレベルを一段引き上げる。次に作る画面から、ぜひ導入してみてほしい。不自然な入力補正に悩まされる時代は、今日で終わりだ。

次は、このコントロールをさらに発展させ、`KeyPress` イベントで「全角数字を自動で半角に変換する」フィルターを組み込む実装について解説しよう。準備はいいか?

タイトルとURLをコピーしました