【入門編】【中級者・実務】VB.NETのWPFアプリにおけるキーボードショートカット(InputBindings)とフォーカス制御の実装 – Visual Basic (VB / VB.NET)解析バイブル

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

マウスを捨て、スピードを掴め。WPFにおける「キーボード操作」と「フォーカス制御」の極意

こんにちは。開発の現場へようこそ。

ここまでVB.NETの基本文法や、WPFでの画面レイアウト(XAML)の作り方を学んできたあなたは、すでに「動くアプリ」を作れるエンジニアへの階段を登っています。素晴らしい進歩ですよ。

しかし、プロの現場で使われる「業務アプリケーション」には、もう一段上の次元が求められます。それは「操作の淀みのなさ」です。

現場のユーザー(特に物流、製造、レジ業務などのスピードが命の現場)は、マウスを動かす時間を極限まで嫌います。彼らが求めているのは、キーボード一つで、あるいはバーコードリーダーを「ピッ」とやるだけで、魔法のように次の操作へ移れるアプリです。

今日は、そんな「プロ仕様の操作感」を実現するための2つの柱、「InputBindingsによるショートカット実装」と「バーコード入力を見据えたフォーカス制御」について、その本質を伝授しましょう。

ここをクリアすれば、あなたの作るアプリは「ただのツール」から「手放せない武器」へと進化しますよ。

1. ショートカットキーの正解:RoutedCommandとInputBindings

「F5キーを押したら更新」「Ctrl + S で保存」といったショートカット。これを実装するとき、初心者はつい `KeyDown` イベントの中で `If e.Key = Keys.F5 Then…` と書きがちです。

しかし、それは「WPFの設計思想」に反する、少し危うい書き方です。なぜなら、特定のコントロールにフォーカスが当たっていると、Windowの `KeyDown` イベントが発火しないことがあるからです。

そこで登場するのが、`RoutedCommand`(ルーテッドコマンド)と`InputBindings`です。

なぜRoutedCommandなのか?

WPFには「イベント・ルーティング」という、イベントが視覚的なツリー(Visual Tree)を伝わっていく仕組みがあります。`RoutedCommand` を使うと、「このコマンドを実行せよ!」という命令を、フォーカスがどこにあろうとも、適切なハンドラ(処理部)まで届けることができるのです。

実装例:F5キーで「データ更新」を実行する

まずは、XAML側で「どのキーが、どのコマンドに対応するか」を定義しましょう。

# 【XAML】InputBindingsの定義

<Window x:Class="MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="Pro Input App" Height="300" Width="400">
    
    <!-- 
        Window全体の入力バインディングを設定します。
        これにより、Window内のどこにフォーカスがあっても、
        指定したキーが押されたらコマンドが発行されます。
    -->
    <Window.InputBindings>
        <!-- F5キーが押されたら、後述する "RefreshCommand" を発行する -->
        <KeyBinding Key="F5" Command="RefreshCommand" />
    </Window.InputBindings>

    <StackPanel Margin="20">
        <TextBlock Text="ここにフォーカスがあってもF5が効きます" Margin="0,0,0,10"/>
        <TextBox x:Name="TargetTextBox" Text="入力エリア" Height="30"/>
        <Button Content="更新ボタン" Margin="0,20,0,0" Click="RefreshButton_Click"/>
        <TextBlock x:Name="StatusText" Text="待機中..." Margin="0,20,0,0" Foreground="Blue"/>
    </StackPanel>
</Window>

# 【VB.NET】コマンドの実装

次に、コードビハインド(MainWindow.xaml.vb)で、コマンドの定義とその中身を記述します。

Imports System.Windows.Input

Class MainWindow
    ' 1. コマンドのインスタンスを作成
    ' RoutedUICommandを使うことで、WPFのイベントルーティングに乗せることができます
    Public Shared ReadOnly RefreshCommand As New RoutedUICommand(
        "Refresh", "Refresh", GetType(MainWindow))

    Public Sub New()
        InitializeComponent()

        ' 2. コマンドと実際の処理(CommandBinding)を紐付けます
        ' これを忘れると、キーを押しても何も起きません
        Dim binding As New CommandBinding(RefreshCommand, AddressOf ExecuteRefresh, AddressOf CanExecuteRefresh)
        Me.CommandBindings.Add(binding)
    End Sub

    ' --- コマンド実行時のロジック ---
    Private Sub ExecuteRefresh(sender As Object, e As ExecutedRoutedEventArgs)
        ' ここに実際の更新処理を書きます
        StatusText.Text = $"[{DateTime.Now:HH:mm:ss}] データを更新しました!"
    End Sub

    ' --- コマンドが実行可能かどうかの判定 ---
    Private Function CanExecuteRefresh(sender As Object, e As CanExecuteRoutedEventArgs) As Boolean
        ' 今回は常に実行可能としていますが、例えば「保存中ならFalseを返す」といった制御が可能です
        Return True
    End Function

    ' ボタンクリック時も同じロジックを呼び出すようにしておくと、二重管理を防げます
    Private Sub RefreshButton_Click(sender As Object, e As RoutedEventArgs)
        ' コマンドを直接実行させる
        ExecuteCommand(RefreshCommand)
    End Sub
End Class

【ここがポイント!】
`InputBindings` を使うことで、「キー操作」と「実際の処理」が分離されました。これにより、将来的に「ボタンのクリック」と「ショートカットキー」の両方から同じ処理を呼び出す際、ロジックが散らばらず、メンテナンス性が劇的に向上します。

2. バーコードリーダーを制する者は、フォーカスを制す

次に、実務で最もトラブルが多い「フォーカス制御」の話をしましょう。

バーコードリーダーの多くは、実は「キーボードの代わり」として動作しています。バーコードをスキャンすると、「文字列 + Enterキー」が猛スピードで入力される仕組みです。

ここでよくある失敗が、「ユーザーが誤って別のテキストボックスをクリックしてしまい、スキャンしたデータが意図しない場所に書き込まれる」という事態です。

これを防ぐには、「常にスキャン用の入力欄にフォーカスを戻す」、あるいは「Enterが押されたら自動的に次の項目へ移動する」という制御が不可欠です。

実装例:スキャン完了後の自動フォーカス制御

# 【XAML】

<StackPanel Margin="20">
    <Label Content="商品スキャン用:"/>
    <!-- KeyDownイベントではなく、PreviewKeyDownを使うのがコツです -->
    <TextBox x:Name="BarcodeTextBox" 
             FontSize="20" 
             PreviewKeyDown="BarcodeTextBox_PreviewKeyDown"/>

    <Label Content="備考欄 (スキャン後に自動移動):" Margin="0,20,0,0"/>
    <TextBox x:Name="NoteTextBox" Height="60" TextWrapping="Wrap"/>
</StackPanel>

# 【VB.NET】

Class MainWindow
    ''' <summary>
    ''' バーコード入力欄でのキー入力を監視
    ''' </summary>
    Private Sub BarcodeTextBox_PreviewKeyDown(sender As Object, e As KeyEventArgs)
        ' バーコードリーダーは最後に「Enter」を入力してくることが多い
        If e.Key = Key.Enter Then
            ' 1. Enterキー自体のイベントが他のコントロールに伝わらないよう、処理済みとする
            e.Handled = True

            ' 2. 入力された値を取得(実務ではここでDB照合などを行う)
            Dim scannedCode As String = BarcodeTextBox.Text
            If String.IsNullOrWhiteSpace(scannedCode) Then Return

            ' 3. 業務ロジックの実行(例:商品検索)
            ProcessBarcode(scannedCode)

            ' 4. 【重要】次の入力項目へフォーカスを強制移動する
            ' これにより、ユーザーがマウスを触る必要がなくなります
            NoteTextBox.Focus()

            ' 5. 次の入力が終わったら、またスキャン用に戻るための準備
            ' (今回はシンプルに、NoteTextBoxでのEnterも制御すると完璧です)
        End If
    End Sub

    Private Sub ProcessBarcode(code As String)
        ' 本来はここでデータベース等と照合します
        Debug.WriteLine($"スキャンされたコード: {code}")
    End Sub

    ''' <summary>
    ''' 備考欄でもEnterを押したら、またスキャン欄に戻るようにする
    ''' </summary>
    Private Sub NoteTextBox_PreviewKeyDown(sender As Object, e As KeyEventArgs)
        If e.Key = Key.Enter Then
            e.Handled = True
            ' スキャン入力欄へフォーカスを戻す
            BarcodeTextBox.Focus()
            ' 入力欄をクリアして次のスキャンに備える
            BarcodeTextBox.Clear()
        End If
    End Sub
End Class

陥りやすい罠:`KeyDown` vs `PreviewKeyDown`

ここで、一つだけ大切な技術的なアドバイスをさせてください。
イベントには「トンネル(Tunneling)」と「バブリング(Bubbling)」という概念があります。

  • `PreviewKeyDown` (トンネル): 親から子へ向かって降りてくるイベント。
  • `KeyDown` (バブリング): 子から親へ向かって上がってくるイベント。

もし、`TextBox` の中で `KeyDown` を使ってしまうと、`TextBox` 自体が「このEnterキーは自分が処理しました!」とイベントを食べてしまい、親の `Window` までイベントが届かなくなることがあります。

「特定のコントロールの挙動を強制的に制御したい(横取りしたい)」ときは、`Preview` と名の付くイベントを使う。 これを覚えておくだけで、デバッグの時間は半分になりますよ。

まとめ:プロへの道

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

1. ショートカットは `InputBindings` と `RoutedCommand` で実装する。

  • これにより、フォーカスに左右されない、堅牢で美しい設計になります。

2. バーコード入力には `PreviewKeyDown` を活用する。

  • `Enter` キーをトリガーに、フォーカスを次の項目へ、あるいはスキャン欄へ自動的に「誘導」します。

これらの実装は、一見すると「細かいこだわり」に見えるかもしれません。しかし、その「細かいこだわり」の積み重ねこそが、現場のユーザーから「このアプリ、使いやすいね!」と信頼されるための、エンジニアとしての真価なのです。

一歩ずつ、着実に。
次はもっと高度なデータバインディングの世界でお会いしましょう。応援していますよ!

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