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

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

脱・マクロの記録!WPFとVB.NETで手に入れる「制御された」モダンUI構築術

こんにちは。プログラミングの世界へようこそ。

Excel VBAのマクロ記録で「動けばいい」というフェーズを卒業し、より高度で、より堅牢な業務アプリケーションを作りたい……そう思ったとき、あなたの前に現れる壁が「UI(ユーザーインターフェース)の制御」です。

「ユーザーに数字以外を入力させたくない」「ボタンが大量にあるのに、コードが同じことの繰り返しで読みづらい」

こうした悩みは、単なるスキルの問題ではなく、「イベント(出来事)の発生タイミング」と「コードの構造化」という、エンジニアとしての本質的な視点が少し足りないだけなのです。

今日は、モダンなWindowsアプリ開発の標準であるWPF (Windows Presentation Foundation) を使い、VB.NETで「実務で使える電卓ツール」を作りながら、その極限のテクニックを伝授しましょう。ここをクリアすれば、Visual Basicの基本はバッチリですよ。

1. WPFの真髄:XAML(見た目)とVB.NET(動き)の分離

まず、従来のVBAやWindows Forms(WinForms)と決定的に違うことを理解しましょう。

WPFでは、「画面のデザイン(XAML)」と「プログラムのロジック(VB.NET)」が完全に分かれています。

  • XAML (ザムル): HTMLのようなもの。ボタンの配置、色、形を定義する「設計図」。
  • VB.NET: 設計図に基づいて「どう動くか」を命じる「脳」。

この分離こそが、メンテナンス性の高いプロフェッショナルなコードを生む鍵となります。

2. 実践:数値入力制限をマスターする

業務ツールで最も多いトラブルの一つが、「数値を入れるべき場所に、ユーザーが誤って文字を入れてしまい、計算エラーでアプリが落ちる」という事態です。

これを防ぐには、入力された「後」にチェックするのではなく、入力される「瞬間」を制圧するのがプロのやり方です。

【XAML】デザインの設計図

まずは、数値を入力するための `TextBox` を用意しましょう。ここでは `PreviewTextInput` というイベントを利用する準備をします。

<!-- 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="極限電卓" Height="350" Width="300">
    <Grid Margin="10">
        <Grid.RowDefinitions>
            <RowDefinition Height="Auto"/>
            <RowDefinition Height="*"/>
        </Grid.RowDefinitions>

        <!-- 入力エリア:PreviewTextInputイベントを紐付けるのがポイント -->
        <TextBox Name="txtDisplay" 
                 FontSize="32" 
                 TextAlignment="Right" 
                 Margin="0,0,0,10"
                 PreviewTextInput="txtDisplay_PreviewTextInput" 
                 VerticalContentAlignment="Center"
                 Height="50"/>

        <!-- ボタンエリア(簡易版) -->
        <UniformGrid Grid.Row="1" Columns="4">
            <Button Content="7" Click="NumberButton_Click" Margin="2"/>
            <Button Content="8" Click="NumberButton_Click" Margin="2"/>
            <Button Content="9" Click="NumberButton_Click" Margin="2"/>
            <Button Content="/" Click="OperatorButton_Click" Margin="2"/>
            <Button Content="4" Click="NumberButton_Click" Margin="2"/>
            <Button Content="5" Click="NumberButton_Click" Margin="2"/>
            <Button Content="6" Click="NumberButton_Click" Margin="2"/>
            <Button Content="*" Click="OperatorButton_Click" Margin="2"/>
            <Button Content="1" Click="NumberButton_Click" Margin="2"/>
            <Button Content="2" Click="NumberButton_Click" Margin="2"/>
            <Button Content="3" Click="NumberButton_Click" Margin="2"/>
            <Button Content="-" Click="OperatorButton_Click" Margin="2"/>
            <Button Content="C" Click="ClearButton_Click" Margin="2"/>
            <Button Content="0" Click="NumberButton_Click" Margin="2"/>
            <Button Content="=" Click="EqualButton_Click" Margin="2"/>
            <Button Content="+" Click="OperatorButton_Click" Margin="2"/>
        </UniformGrid>
    </Grid>
</Window>

【VB.NET】入力制限のロジック

さて、ここからが本番です。`PreviewTextInput` を使って、数字以外の入力を「未然に防ぐ」コードを書きます。

' MainWindow.xaml.vb

Class MainWindow
    ' 入力制限のロジック
    ''' <summary>
    ''' テキストボックスへの入力が確定する前に、文字をチェックします。
    ''' </summary>
    Private Sub txtDisplay_PreviewTextInput(sender As Object, e As Text.TextCompositionEventArgs)
        ' 正規表現を使って、入力された文字が「数字」であるか判定します
        ' [^0-9] は「0から9以外の文字」という意味です
        Dim regex As New System.Text.RegularExpressions.Regex("[^0-9]")
        
        ' もし入力された文字が数字以外なら、イベントを「Handled = True」にして
        ' 入力処理をキャンセル(握りつぶし)します。
        If regex.IsMatch(e.Text) Then
            e.Handled = True ' これが「入力を無効化する」魔法の言葉です
        End If
    End Sub
End Class

💡 ここがプロの視点!
多くの初心者は `TextChanged` イベント(文字が変わった後)で制御しようとしますが、それだと「一瞬だけ文字が入って、消える」という視覚的なチラつきが発生します。`PreviewTextInput` を使うことで、「そもそも文字を入れさせない」という、ユーザーにストレスを与えないスマートな制御が可能になります。

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

次に、ボタンの処理を見てみましょう。電卓には「0〜9」のボタンが大量にあります。これら一つひとつに対して `Sub Button1_Click()`, `Sub Button2_Click()…` と書いていたら、コードはゴミの山になってしまいますよね。

ここで使うのが、「共通のイベントハンドラ」という考え方です。

【VB.NET】スマートなボタン処理

' MainWindow.xaml.vb 内に追記

    ' 数値ボタンが押された時の共通処理
    Private Sub NumberButton_Click(sender As Object, e As RoutedEventArgs)
        ' sender は「実際にクリックされたボタンそのもの」を指します
        ' これを Button 型に変換(キャスト)することで、ボタンの文字(Content)を取得できます
        Dim clickedButton As Button = DirectCast(sender, Button)
        Dim buttonText As String = clickedButton.Content.ToString()

        ' テキストボックスの末尾に数字を追記
        txtDisplay.Text &= buttonText
    End Sub

    ' クリアボタンの処理
    Private Sub ClearButton_Click(sender As Object, e As RoutedEventArgs)
        txtDisplay.Text = ""
    End Sub

    ' --- 計算ロジックはここでは省略(詳細は次のステップへ!) ---

💡 ここがプロの視点!
`DirectCast(sender, Button)`。これこそが、オブジェクト指向の入り口です。「誰がイベントを起こしたのか?」を `sender` で受け取り、それを適切な型に変換して扱う。このテクニックを覚えるだけで、あなたの書くコードの行数は劇的に減り、美しさは格段に上がります。

4. まとめ:エンジニアへの第一歩

今日学んだことを振り返りましょう。

1. WPFの構造: XAML(見た目)とVB.NET(動き)を分けることで、管理しやすい設計にする。
2. 入力制限の極意: `PreviewTextInput` を使い、イベントが発生する前に `e.Handled = True` で制御する。
3. コードの共通化: `sender` を活用して、複数のボタンを一つのメソッドでスマートに扱う。

「なぜこう書くのか?」という理由(Why)を理解してコードを書くこと。それが、単なる「マクロ使い」から「ソフトウェアエンジニア」へと進化するための唯一の道です。

最初は難しく感じるかもしれません。でも、一つ一つのイベントがどう流れているかを観察していけば、必ず感覚が掴めてきますよ。

次は、実際に計算ロジックを組み込んで、さらに複雑な計算ができるツールへと進化させてみましょう。応援していますよ!

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