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

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

界面の支配:WPFにおける高スループットな入力制御とフォーカス管理の極致

業務アプリケーションの真価は、UIの美しさではなく、「オペレーターの思考を中断させないこと」にある。

熟練した物流倉庫の作業員、あるいは膨大な伝票を捌く事務員にとって、マウスへの持ち替えは「コスト」であり、「ノイズ」だ。彼らが求めるのは、キーボードとバーコードリーダーのみで完結する、流れるような操作感である。

しかし、多くの開発者はWPF(Windows Presentation Foundation)を単なる「見た目を整えるためのツール」と誤解している。`KeyDown` イベントを `Window` に書き殴り、`Focus()` メソッドを場当たり的に呼び出す実装は、コードの保守性を破壊し、予期せぬメモリリークとフォーカス喪失の温床となる。

本稿では、VB.NETを用いたWPF開発において、プロフェッショナルが実践すべき「RoutedCommandによる疎結合なショートカット実装」と、「バーコードリーダー入力を前提とした強固なフォーカス制御」の真髄を解説する。

1. RoutedCommandによるコマンド・デカップリング

初心者は `KeyDown` イベント内で `If e.Key = Keys.F5 Then …` と記述する。これは設計上の敗北である。ロジックがView(コードビハインド)に密結合し、ユニットテストも不可能になるからだ。

アーキテクトは、Command Pattern を用いる。WPFの `RoutedCommand` を活用すれば、キー入力(InputBinding)と実行ロジックを完全に分離し、Visual Treeを介してエレガントに命令を伝搬させることができる。

実装例:検索コマンドの定義とバインド

まず、アプリケーション固有のコマンドを定義する。

' Commands.vb - コマンドの定義
Imports System.Windows.Input

Public Class AppCommands
    ' 検索を実行するためのRoutedCommandを定義
    <RoutedUICommandBinding()>
    Public Shared ReadOnly Search As New RoutedCommand("Search", "SearchCommand")
End Class

次に、XAML側でこのコマンドをキー入力に紐付ける。これにより、Viewは「何が押されたか」ではなく「何を実行したいか」に集中できる。

<!-- 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="High-Performance Terminal" Height="450" Width="800">
    
    <Window.InputBindings>
        <!-- Ctrl + F で検索コマンドを発火させる -->
        <KeyBinding Modifiers="Control" Key="F" Command="{x:Static local:AppCommands.Search}" />
        <!-- F5 で検索コマンドを発火させる(業務特化型) -->
        <KeyBinding Key="F5" Command="{x:Static local:AppCommands.Search}" />
    </Window.InputBindings>

    <Grid>
        <StackPanel Margin="20">
            <TextBlock Text="検索ワード:" />
            <TextBox x:Name="txtSearch" Margin="0,5" />
            <Button Content="実行" Command="{x:Static local:AppCommands.Search}" Margin="0,10" />
        </StackPanel>
    </Grid>
</Window>

そして、コードビハインド(またはCommandBinding)で、そのコマンドが呼ばれた際の挙動を定義する。

' MainWindow.xaml.vb
Class MainWindow
    Public Sub New()
        InitializeComponent()
        
        ' CommandBindingの登録。本来はViewModelへの委譲が望ましいが、
        ' ここでは実装の明示のためにコードビハインドで行う。
        AddHandler Me.CommandBindings.Add(New CommandBinding(AppCommands.Search, AddressOf ExecuteSearch, AddressOf CanExecuteSearch))
    End Sub

    Private Sub CanExecuteSearch(sender As Object, e As CanExecuteRoutedEventArgs)
        ' 検索を実行できる条件(例:テキストボックスが空でないこと)
        e.CanExecute = Not String.IsNullOrWhiteSpace(txtSearch.Text)
    End Sub

    Private Sub ExecuteSearch(sender As Object, e As ExecutedRoutedEventArgs)
        ' 実際の検索ロジック
        MessageBox.Show($"Searching for: {txtSearch.Text}")
    End Sub
End Class

アーキテクトの視点:
`CanExecute` を実装することで、条件を満たさない時にボタンを自動的に無効化(グレーアウト)できる。これはユーザーへの「現在の状態」のフィードバックとして極めて重要だ。

2. バーコードリーダー入力とフォーカス制御の戦い

バーコードリーダーの多くは、HID(Human Interface Device)として動作し、人間がキーボードを叩くのと全く同じ挙動をする。つまり、「高速な文字列入力 + Enterキー」が送り込まれる。

ここで問題となるのが、ユーザーが誤って別のコントロール(ボタン等)をクリックしてフォーカスを失った際、バーコードリーダーの入力がどこへ消えるのか、という点だ。業務アプリにおいて、入力の消失は致命的なエラーである。

フォーカス・トラップの実装戦略

特定の入力フィールド(例:`txtBarcode`)に常にフォーカスを誘導、あるいは入力をキャプチャするためには、`FocusManager.IsFocusScope` を利用するか、低レイヤーのイベント制御が必要になる。

以下に、バーコード入力時に確実にテキストボックスへフォーカスを戻し、かつ高速入力によるUIスレッドのスタックを防ぐための堅牢な実装パターンを示す。

' MainWindow.xaml.vb (追加実装)
Imports System.Windows.Input

Class MainWindow
    ' バーコード入力を受け付ける専用コントロール
    Private Sub txtBarcode_PreviewKeyDown(sender As Object, e As KeyEventArgs) Handles txtBarcode.PreviewKeyDown
        ' Enterキー(バーコードリーダーの末尾)を検知
        If e.Key = Key.Enter Then
            ' 処理を非同期で行い、UIスレッドのブロッキングを防ぐ
            Dim inputData As String = txtBarcode.Text
            ProcessBarcodeAsync(inputData)
            
            ' 入力後、テキストをクリアして次の入力に備える
            txtBarcode.Clear()
            e.Handled = True ' イベントが伝播して他のコントロールに影響するのを防ぐ
        End If
    End Sub

    Private Async Sub ProcessBarcodeAsync(data As String)
        ' 実際の業務ロジック(DBアクセス等)は必ずAsyncで行うこと。
        ' これを行わないと、入力中にUIがフリーズし、次の一手が打てなくなる。
        Await Task.Run(Sub()
                           ' ここで重い処理を実行
                           System.Threading.Thread.Sleep(100) 
                       End Sub)
        
        ' 処理完了後のUI更新はメインスレッドで行う
        Me.Dispatcher.Invoke(Sub()
                                  ' 完了通知などのUI操作
                              End Sub)
    End Sub

    ' フォーカス喪失対策:Window全体でキー入力を監視し、
    ' 特定の条件(バーコード入力モード)なら強制的にテキストボックスへフォーカスを戻す
    Private Sub Window_PreviewKeyDown(sender As Object, e As KeyEventArgs) Handles Me.PreviewKeyDown
        ' もしテキストボックスにフォーカスがない状態で、
        ' 何らかの入力があった場合、強制的にフォーカスを戻すロジック
        If Not txtBarcode.IsKeyboardFocusDirectly Then
            ' 業務要件に基づき、特定のキー入力をトリガーにフォーカスを奪還する
            ' 例: Ctrl + B でバーコードモードへ
            If e.Key = Key.B AndAlso Keyboard.Modifiers = ModifierKeys.Control Then
                txtBarcode.Focus()
                e.Handled = True
            End If
        End If
    End Sub
End Class

3. 極限の知見:メモリリークとWinAPIの介入

WPFは強力な抽象化レイヤーを提供するが、その裏側では膨大なオブジェクトが生成・破棄されている。特に、`CommandBinding` やイベントハンドラを動的に追加・削除する場合、「イベントハンドラの解除忘れ」によるメモリリークは、長期間稼働する業務システムにおける最大の敵だ。

ゾンビ・ウィンドウの回避

ViewModelがViewよりも長いライフサイクルを持つ場合、ViewModelのイベントをViewが購読すると、Viewが閉じられてもGC(Garbage Collector)がViewを回収できなくなる。これは「ゾンビ・ウィンドウ」現象と呼ばれる。

  • 対策1: `WeakEventManager` を使用し、弱参照によるイベント購読を行う。
  • 対策2: `Unloaded` イベント内で、明示的にすべてのイベントハンドラを `-=` で解除する。

Windows APIによる「究極のフォーカス制御」

WPFの `Focus()` メソッドは、論理的なフォーカスを制御するものだ。しかし、WinFormsコントロールをホストしていたり、複雑なInterop(相互運用)が発生している環境では、WPFのフォーカス管理がOSレベルのフォーカスと乖離することがある。

その場合、伝説的なエンジニアは `user32.dll` の `SetFocus` を呼び出す。

' WinAPIの宣言
Imports System.Runtime.InteropServices

Public Module NativeMethods
    <DllImport("user32.dll")>
    Public Function SetFocus(hWnd As IntPtr) As IntPtr
    End Function
End Module

' 使用例
' WPFのコントロールのHandleを取得して強制的にフォーカスを当てる
' (注意: WPFコントロールには直接Handleがないため、HwndSourceを介する必要がある)

※ただし、これは最終手段である。WPFの設計思想を逸脱する行為であり、使用する場合は、その副作用(レンダリングの不整合など)を完全に理解していなければならない。

結論

モダンなWPFアプリケーションにおける「使いやすさ」とは、単なるボタンの配置ではない。それは、「入力デバイスの特性を理解し、コマンドパターンによってロジックを整理し、フォーカス制御によってユーザーの思考を妨げない設計」の集大成である。

`RoutedCommand` で疎結合を実現し、`Async/Await` でUIの応答性を担保し、そしてメモリ管理において厳格であること。これらを守ることで、あなたの構築するシステムは、単なるソフトウェアを超え、オペレーターの身体の一部となるのだ。

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