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

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

【極限の知見】WPFによる堅牢な業務ツールの設計思想:数値入力制限とイベント制御の真髄

「動けばいい」という思考は、プロフェッショナルへの道を閉ざす。

多くの入門書では、電卓アプリの作り方を「ボタンを配置し、クリックイベントで計算式を書く」という、極めて表層的なレベルで解説している。しかし、我々が向き合うのは、数千、数万のトランザクションを捌く業務システムであり、一円の誤差も許されない財務計算ツールである。

入力された「文字」がシステムを破壊しないか? メモリリークによって数日稼働したサーバーが沈黙しないか? 既存のレガシーなCOMコンポーネントと連携する際、スレッドの衝突をどう回避するか?

本記事では、WPF (Windows Presentation Foundation) を用い、VB.NETで実務に耐えうる「計算ツール」を構築するプロセスを通じて、単なるコードの書き方ではなく、「堅牢なソフトウェアを設計するためのアーキテクチャ」を伝授する。

1. UI層の設計:XAMLによる宣言的インターフェースの構築

WPFの真髄は、UI(見た目)とロジック(振る舞い)を分離する「Separation of Concerns」にある。WinFormsの時代のような「コントロールのプロパティをコードビハインドから力技で書き換える」手法は、保守性を著しく低下させる。

まずは、計算機の骨格となるXAMLを定義する。ここでは、数値入力の整合性を保つための重要なプロパティ設定に注目せよ。

<!-- MainWindow.xaml -->
<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="450" Width="350"
        Background="#F0F0F0">
    <Grid Margin="10">
        <Grid.RowDefinitions>
            <RowDefinition Height="Auto"/> <!-- 表示部 -->
            <RowDefinition Height="*"/>    <!-- ボタン群 -->
        </Grid.RowDefinitions>

        <!-- 結果表示用TextBox: 読み取り専用とし、フォーカスを奪わない設計 -->
        <TextBox Name="txtDisplay" 
                 Grid.Row="0" 
                 FontSize="32" 
                 TextAlignment="Right" 
                 IsReadOnly="True" 
                 Background="White" 
                 Margin="0,0,0,10" 
                 Padding="5"
                 Text="0"/>

        <UniformGrid Grid.Row="1" Columns="4">
            <!-- 数字ボタン群 -->
            <Button Content="7" Tag="7" Click="NumberButton_Click" Margin="2"/>
            <Button Content="8" Tag="8" Click="NumberButton_Click" Margin="2"/>
            <Button Content="9" Tag="9" Click="NumberButton_Click" Margin="2"/>
            <Button Content="/" Tag="/" Click="OperatorButton_Click" Margin="2"/>

            <Button Content="4" Tag="4" Click="NumberButton_Click" Margin="2"/>
            <Button Content="5" Tag="5" Click="NumberButton_Click" Margin="2"/>
            <Button Content="6" Tag="6" Click="NumberButton_Click" Margin="2"/>
            <Button Content="*" Tag="*" Click="OperatorButton_Click" Margin="2"/>

            <Button Content="1" Tag="1" Click="NumberButton_Click" Margin="2"/>
            <Button Content="2" Tag="2" Click="NumberButton_Click" Margin="2"/>
            <Button Content="3" Tag="3" Click="NumberButton_Click" Margin="2"/>
            <Button Content="-" Tag="-" Click="OperatorButton_Click" Margin="2"/>

            <Button Content="C" Tag="C" Click="ClearButton_Click" Margin="2"/>
            <Button Content="0" Tag="0" Click="NumberButton_Click" Margin="2"/>
            <Button Content="=" Tag="=" Click="EqualButton_Click" Margin="2"/>
            <Button Content="+" Tag="+" Click="OperatorButton_Click" Margin="2"/>
        </UniformGrid>
    </Grid>
</Window>

アーキテクトの視点:`UniformGrid` と `Tag` プロパティの活用

ボタンのレイアウトには `UniformGrid` を採用し、動的なサイズ変更に対応させている。また、各ボタンの値を `Tag` プロパティに格納することで、個別のイベントハンドラを量産する無駄を省き、単一のハンドラでスマートに制御する設計にしている。これは、コードの複雑性を抑え、メモリフットプリントを最小化するための定石である。

2. ロジック層の制御:堅牢な数値入力制限

実務ツールにおいて、最も忌むべきは「不正なデータによる例外(Exception)」である。TextBoxに誤って文字が入力されたり、クリップボードから文字列が貼り付けられたりすることを、「入力された後にチェックする」のではなく、「入力させない」のがプロの仕事だ。

以下に、VB.NET側での実装を示す。

' MainWindow.xaml.vb
Imports System.Text.RegularExpressions

Class MainWindow
    ' 計算状態を保持するための変数
    ' 業務計算ではDoubleではなく、精度の高いDecimalを使用するのが鉄則
    Private _currentValue As Decimal = 0D
    Private _pendingValue As Decimal = 0D
    Private _operator As String = ""
    Private _isNewEntry As Boolean = True

    ''' <summary>
    ''' 数字ボタンが押された際の共通ハンドラ
    ''' </summary>
    Private Sub NumberButton_Click(sender As Object, e As RoutedEventArgs)
        Dim btn = DirectCast(sender, Button)
        Dim input As String = btn.Tag.ToString()

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

    ''' <summary>
    ''' 演算子ボタンのハンドラ
    ''' </summary>
    Private Sub OperatorButton_Click(sender As Object, e As RoutedEventArgs)
        Dim btn = DirectCast(sender, Button)
        _pendingValue = Decimal.Parse(txtDisplay.Text)
        _operator = btn.Tag.ToString()
        _isNewEntry = True
    End Sub

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

        Select Case _operator
            Case "+" : result = _pendingValue + secondValue
            Case "-" : result = _pendingValue - secondValue
            Case "*" : result = _pendingValue * secondValue
            Case "/"
                If secondValue = 0D Then
                    MessageBox.Show("ゼロ除算は許可されていません。", "システムエラー", MessageBoxButton.OK, MessageBoxIcon.Error)
                    Return
                End If
                result = _pendingValue / secondValue
        End Select

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

    ''' <summary>
    ''' クリア処理
    ''' </summary>
    Private Sub ClearButton_Click(sender As Object, e As RoutedEventArgs)
        txtDisplay.Text = "0"
        _currentValue = 0D
        _pendingValue = 0D
        _operator = ""
        _isNewEntry = True
    End Sub

    ''' <summary>
    ''' 【極限の知見】数値入力制限の真髄
    ''' </summary>
    ''' <remarks>
    ''' 多くの開発者はKeyPressイベントで制限しようとするが、それは不完全だ。
    ''' WPFにおいてはPreviewTextInputとDataObject.Pastingの両方を制御する必要がある。
    ''' </remarks>
    Private Sub ValidateInput(sender As Object, e As TextCompositionEventArgs)
        ' 正規表現を用いて、入力が数字(および小数点)のみであることを検証
        Dim regex As New Regex("[^0-9.]+")
        e.Handled = regex.IsMatch(e.Text)
    End Sub

    ' 注意: XAML側で PreviewTextInput="ValidateInput" を指定する必要がある
End Class

精度へのこだわり:`Double` ではなく `Decimal` を選ぶ理由

ここで、私はあえて `Double` ではなく `Decimal` を選択した。
`Double` は浮動小数点数であり、2進数で表現できない数値(例:0.1)を扱う際に微小な誤差を生じる。金融システムや業務計算ツールにおいて、この「微小な誤差」は致命的な計算ミスへと繋がる。「計算機を作るなら、まずデータ型から疑え」。これがアーキテクトの教えだ。

3. 高度なイベント制御とメモリ管理の最適化

実務において、UI要素が動的に生成される場合、`Handles` キーワードだけでは対応できない。その場合は `AddHandler` を用いるが、これには「イベントの購読解除(RemoveHandler)」という、メモリ管理上の重い責任が伴う。

`Handles` vs `AddHandler`

  • `Handles`: 静的なコントロールに対して使用。宣言的であり、ライフサイクルがコントロールと一致するため、メモリリークのリスクが低い。
  • `AddHandler`: 動的なコントロールに対して使用。強力だが、オブジェクトが破棄される前に `RemoveHandler` を行わないと、GC(ガベージコレクション)がオブジェクトを回収できず、メモリリークを引き起こす。

もし、この電卓の機能を拡張して「履歴ログ」を外部のファイルやデータベースに書き込む機能を実装する場合、その通信処理(I/O)は必ず非同期で行うべきだ。

''' <summary>
''' 外部システムへのログ出力(非同期実装の例)
''' </summary>
Private Async Function LogCalculationAsync(result As Decimal) As Task
    ' UIスレッドをブロックせず、バックグラウンドで処理を行う
    Await Task.Run(Sub()
                       ' ここでファイル出力やAPI呼び出しを行う
                       ' Windows API (kernel32.dll) を介した低レベルなファイル操作も可能だが、
                       ' .NETのAsync/Awaitを活用するのがモダンな作法である
                       System.IO.File.AppendAllText("log.txt", $"{DateTime.Now}: {result}{vbCrLf}")
                   End Sub)
End Function

結論:エンジニアとしての矜持

今回紹介したテクニックは、一見すると「電卓」という単純なツールにおける些細な工夫に見えるかもしれない。しかし、「入力の整合性を守る」「型の精度を担保する」「非同期でUIスレッドを解放する」といった規律こそが、プロフェッショナルとアマチュアを分かつ境界線である。

レガシーなVBA資産の移行や、大規模なWPFアプリケーションの保守に携わる際、常にこの「極限の視点」を忘れないでいただきたい。コードは単に動くだけでは足りない。それは、堅牢で、予測可能で、そして美しい設計に基づいたものでなければならない。

次に君が書くコードが、システムを支える真の礎となることを期待している。

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