【実務・中級編】【初心者向け】VB.NETとWPFで作る実務用電卓・簡易計算ツール:イベント処理とTextBoxの数値入力制限テクニック – Visual Basic (VB / VB.NET)解析バイブル

スポンサーリンク
スポンサーリンク

業務ツールを「玩具」から「道具」へ昇華させる:WPFによる堅牢な数値入力制御とイベント設計の極意

業務自動化の現場において、ツール作成の依頼は絶えない。しかし、多くの開発者が陥る罠がある。それは、「動けばいい」という思考でコードを書き、メンテナンス不能なスパゲッティコードを生み出してしまうことだ。

特に、数値入力を伴う計算ツールにおいて、ユーザーの予期せぬ操作(文字入力や貼り付け)を考慮していない設計は、バグの温床となり、業務の信頼性を損なう。

本記事では、VB.NETとWPFを用い、単なる「動く電卓」ではなく、「プロフェッショナルが現場で使える、堅牢で保守性の高い計算ツール」を構築するためのアーキテクチャを伝授する。

1. なぜ WinForms ではなく WPF なのか?

「今まで WinForms で作ってきたから」という理由で WPF を避けるのは、エンジニアとして極めて損失が大きい。

WinForms はイベント駆動型モデルに強く依存しており、ロジックとUIが密結合になりやすい。対して WPF は XAML による宣言的なUI記述と、強力なデータバインディングを備えている。

業務ツールにおいて重要なのは、UIの見た目ではない。「入力データの整合性をいかに担保し、ロジックをUIから分離できるか」である。WPFはこの設計思想(MVVMパターンへの発展性)を前提として設計されており、将来的な機能拡張やテスト容易性を確保する上で、圧倒的なアドバンテージを持つ。

2. 徹底的な入力制御:TextBoxを「数値専用」に封じ込める

初心者が真っ先に書くコードは、`TextChanged` イベントの中で `Try…Catch` を使い、数値以外が入ったらエラーを出すというものだ。

これは、極めて非効率で「遅い」設計である。

エラーが発生してから対処する(Reactive)のではなく、不正な値が入ることを未然に防ぐ(Proactive)のがプロの設計だ。WPFでは、入力がテキストプロパティに反映される前の段階、すなわち `PreviewTextInput` イベントを捕捉することで、スマートに制御できる。

さらに、盲点となるのが 「右クリックからの貼り付け(Paste)」 だ。`PreviewTextInput` だけでは、クリップボードからの文字列流入を防げない。この両面をカバーするのが、プロの仕事である。

実装例:堅牢な数値入力TextBox

以下に、コピペで即戦力として使える、数値(および小数点)のみを許可する制御ロジックを示す。

''' <summary>
''' 数値入力に特化した制御ロジックを含むクラス
''' </summary>
Public Class NumericInputValidator

    ''' <summary>
    ''' テキスト入力イベントをハンドルし、数値以外を遮断する
    ''' </summary>
    ''' <param name="e">イベント引数</param>
    ''' <param name="currentText">現在のTextBoxのテキスト</param>
    Public Shared Sub HandlePreviewTextInput(sender As Object, e As TextCompositionEventArgs, currentText As String)
        ' 正規表現で「数字」または「小数点」のみを許可
        ' [0-9] は数字、\. は小数点。これ以外は入力を無効化する。
        Dim regex As New System.Text.RegularExpressions.Regex("[^0-9\.]")
        e.Handled := regex.IsMatch(e.Text)
    End Sub

    ''' <summary>
    ''' ペースト操作をハンドルし、不正な文字列を遮断する
    ''' </summary>
    ''' <param name="sender As Object"></param>
    ''' <param name="e As DataObjectPastingEventArgs"></param>
    Public Shared Sub HandleDataObjectPasting(sender As Object, e As DataObjectPastingEventArgs)
        ' クリップボードの中身がテキストでない場合は無視
        If e.DataObject.GetDataPresent(GetType(String)) Then
            Dim text As String = DirectCast(e.DataObject.GetData(GetType(String)), String)
            ' 貼り付けようとしている文字列が数値として妥当かチェック
            Dim regex As New System.Text.RegularExpressions.Regex("[^0-9\.]")
            If regex.IsMatch(text) Then
                e.CancelCommand() ' 不正な場合は貼り付けをキャンセル
            End If
        Else
            e.CancelCommand()
        End If
    End Sub
End Class

3. イベントハンドリングの効率化:Handlesキーワードの真価

電卓のようなツールでは、0から9までのボタンが並ぶ。これら一つひとつに対して `Button_Click` メソッドを個別に作成するのは、時間の無駄であり、保守性を著しく低下させる。

VB.NET の `Handles` 句は、複数のイベントソースを単一のメソッドに集約できる強力な武器だ。

効率的なボタン群の集約

' XAML側で Button0, Button1... と命名されている前提

''' <summary>
''' 数字ボタンが押された際の共通処理
''' </summary>
''' <param name="sender">押されたボタンオブジェクト</param>
''' <param name="e">イベント引数</param>
Private Sub NumberButton_Click(sender As Object, e As RoutedEventArgs) Handles _
    Button0_Click, Button1_Click, Button2_Click, Button3_Click, Button4_Click,
    Button5_Click, Button6_Click, Button7_Click, Button8_Click, Button9_Click

    ' senderをButtonとしてキャストし、そのContent(表示されている数字)を取得
    Dim btn As Button = DirectCast(sender, Button)
    Dim inputChar As String = btn.Content.ToString()

    ' 表示用TextBoxに文字を追加
    txtDisplay.Text &= inputChar
End Sub

このように、「何が起きたか(どのボタンが押されたか)」ではなく「何が入力されたか(ボタンの文字は何か)」に注目してロジックを組むことで、コード量は劇的に減り、可読性は向上する。

4. 実践:モダンUI電卓のフルスタック・サンプル

ここまでの知見を統合し、実際に動作するプロトタイプを作成する。

XAML (MainWindow.xaml)

UIの構造を定義する。`Grid` を活用して、レスポンシブな配置を行う。

<Window x:Class="MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="Professional Calculator" Height="350" Width="250">
    <Grid Margin="10">
        <Grid.RowDefinitions>
            <RowDefinition Height="Auto"/>
            <RowDefinition Height="*"/>
        </Grid.RowDefinitions>

        <!-- 入力表示部 -->
        <TextBox Name="txtDisplay" Grid.Row="0" FontSize="24" TextAlignment="Right" 
                 Margin="0,0,0,10" IsReadOnly="True" Background="#F0F0F0"/>

        <!-- ボタン配置部 -->
        <UniformGrid Grid.Row="1" Columns="4">
            <!-- 数字ボタン -->
            <Button Content="7" Click="NumberButton_Click" Name="Button7"/>
            <Button Content="8" Click="NumberButton_Click" Name="Button8"/>
            <Button Content="9" Click="NumberButton_Click" Name="Button9"/>
            <Button Content="/" Click="OperatorButton_Click" Name="ButtonDiv"/>
            
            <Button Content="4" Click="NumberButton_Click" Name="Button4"/>
            <Button Content="5" Click="NumberButton_Click" Name="Button5"/>
            <Button Content="6" Click="NumberButton_Click" Name="Button6"/>
            <Button Content="*" Click="OperatorButton_Click" Name="ButtonMul"/>

            <Button Content="1" Click="NumberButton_Click" Name="Button1"/>
            <Button Content="2" Click="NumberButton_Click" Name="Button2"/>
            <Button Content="3" Click="NumberButton_Click" Name="Button3"/>
            <Button Content="-" Click="OperatorButton_Click" Name="ButtonSub"/>

            <Button Content="C" Click="ClearButton_Click" Name="ButtonClear"/>
            <Button Content="0" Click="NumberButton_Click" Name="Button0"/>
            <Button Content="=" Click="EqualButton_Click" Name="ButtonEqual"/>
            <Button Content="+" Click="OperatorButton_Click" Name="ButtonAdd"/>
        </UniformGrid>
    </Grid>
</Window>

VB.NET (MainWindow.xaml.vb)

ロジック部分。計算には精度を担保するため `Double` ではなく `Decimal` を使用するのが実務上の鉄則だ。

Class MainWindow
    ' 計算状態を管理する変数
    Private _currentValue As Decimal = 0
    Private _pendingOperator As String = ""
    Private _isNewEntry As Boolean = True

    ''' <summary>
    ''' 数字ボタンのイベント(HandlesはXAMLのClickと紐付け)
    ''' </summary>
    Private Sub NumberButton_Click(sender As Object, e As RoutedEventArgs) Handles _
        Button0_Click, Button1_Click, Button2_Click, Button3_Click, Button4_Click,
        Button5_Click, Button6_Click, Button7_Click, Button8_Click, Button9_Click

        Dim btn As Button = DirectCast(sender, Button)
        Dim val As String = btn.Content.ToString()

        If _isNewEntry Then
            txtDisplay.Text = val
            _isNewEntry = False
        Else
            txtDisplay.Text &= val
        End If
    End Sub

    ''' <summary>
    ''' 演算子ボタンの処理
    ''' </summary>
    Private Sub OperatorButton_Click(sender As Object, e As RoutedEventArgs) Handles _
        ButtonAdd_Click, ButtonSub_Click, ButtonMul_Click, ButtonDiv_Click

        Dim btn As Button = DirectCast(sender, Button)
        _pendingOperator = btn.Content.ToString()
        _currentValue = Decimal.Parse(txtDisplay.Text)
        _isNewEntry = True
    End Sub

    ''' <summary>
    ''' 計算実行
    ''' </summary>
    Private Sub EqualButton_Click(sender As Object, e As RoutedEventArgs) Handles ButtonEqual_Click
        Dim secondValue As Decimal = Decimal.Parse(txtDisplay.Text)
        Dim result As Decimal = 0

        ' 演算子に応じた計算(実務ではここをロジッククラスへ分離すべき)
        Select Case _pendingOperator
            Case "+" : result = _currentValue + secondValue
            Case "-" : result = _currentValue - secondValue
            Case "*" : result = _currentValue * secondValue
            Case "/"
                If secondValue = 0 Then
                    MessageBox.Show("0で割ることはできません。")
                    Return
                End If
                result = _currentValue / secondValue
        End Select

        txtDisplay.Text = result.ToString()
        _isNewEntry = True
    End Sub

    Private Sub ClearButton_Click(sender As Object, e As RoutedEventArgs) Handles ButtonClear_Click
        txtDisplay.Text = "0"
        _currentValue = 0
        _pendingOperator = ""
        _isNewEntry = True
    End Sub
End Class

5. プロダクションレベルへの昇華:設計の注意点

このコードをそのまま業務システムに組み込む前に、以下の3点を必ず考慮せよ。

① 精度の問題:`Double` は使うな

金融系や在庫管理などの業務ツールにおいて、浮動小数点型である `Double` を使用することは「罪」に近い。`0.1 + 0.2` が `0.30000000000000004` になるような計算誤差は、業務上の致命的なミスを招く。必ず `Decimal` 型 を使用せよ。

② データの永続化と非同期処理

計算結果をデータベースやCSVに保存する場合、UIスレッドで同期的に処理を行ってはならない。保存中にUIがフリーズすれば、ユーザーは「壊れた」と判断する。`Async / Await` を活用し、I/O処理は非同期で行うのがモダンな設計だ。

③ エラーハンドリングの階層化

UI層(MainWindow)で全ての例外を `Try…Catch` するのは素人の仕事だ。

  • UI層:ユーザーへの通知(MessageBox等)に専念。
  • ロジック層:ビジネスルールに基づいた例外(`InvalidOperationException` 等)をスロー。
  • データ層:接続エラーなどのインフラ起因の例外をハンドリング。

このように、「誰がそのエラーを解決すべきか」に基づいた責任分解を行え。

結論

WPFによる開発は、単なるUI構築の手段ではない。それは、「堅牢なロジックを、いかに美しく、かつ安全にユーザーに届けるか」という設計思想の実践である。

入力制限、イベントの集約、型の選択。これらの細部に魂を込めることで、あなたの作るツールは「使い捨てのスクリプト」から「信頼される業務基盤」へと進化するのだ。

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