【テクニカル・上級編】【初心者向け】VB.NETとWPFで実現する入力フォームのフォーカス移動制御:Enterキーでのスムーズな次項目移動 – Visual Basic (VB / VB.NET)解析バイブル

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

入力スループットを最大化せよ:WPFにおけるEnterキーによるフォーカス制御の設計思想

データ入力が生命線となる業務アプリケーションにおいて、ユーザーの「指の動き」を止めさせることは、システムの敗北を意味する。

多くの開発者は、入力フォームの構築において「Enterキーで次の項目へ移動させる」という要件に対し、各コントロールの`KeyDown`イベントに個別のハンドラを記述するという、極めて保守性の低い、稚拙な実装を選択しがちだ。しかし、それはアーキテクチャの観点から言えば、技術的負債を自ら積み上げているに等しい。

本稿では、WPF(Windows Presentation Foundation)のイベントルーティングと、Attached Property(添付プロパティ)という強力な武器を用い、拡張性と保守性を極限まで高めた「フォーカス制御」の設計手法を伝授する。これは単なる「初心者向け」のテクニックではない。レガシーなWinFormsやVBAの呪縛から脱却し、モダンなUIフレームワークを真に掌握するための儀式である。

1. なぜ「イベントの個別実装」は悪なのか

まず、避けるべきアンチパターンを明確にしておく。

1. コードの冗長性: 100個のテキストボックスがあれば、100個のイベントハンドラを書くのか?
2. 保守性の欠如: 「Enterキーの挙動を少し変えたい」と思った時、すべてのコントロールを修正しなければならない。
3. イベントの競合: コントロールが自身のイベントを `Handled = True` で消費してしまった場合、制御が効かなくなる。

プロフェッショナルは、コントロール個別の挙動をいじるのではない。「振る舞い(Behavior)」をメタデータとして定義し、UIツリー全体に一貫したルールを適用するのだ。

2. 解決策:Attached Property による「振る舞い」の注入

WPFの真骨頂は、既存のコントロールの機能を、継承することなく拡張できる点にある。これを利用し、`EnterMovesNext` という添付プロパティを定義する。これにより、XAML上で `local:FocusExtensions.EnterMovesNext=”True”` と記述するだけで、そのコントロールに「Enterで次へ移動する」という能力を付与できる。

実装コード:FocusExtensions.vb

ここでは、イベントの「トンネリング(PreviewKeyDown)」を利用する。これは、要素に到達する前に親要素からイベントを検知する仕組みであり、コントロールがイベントを消費してしまうリスクを回避するために不可欠な判断だ。

Imports System.Windows
Imports System.Windows.Controls
Imports System.Windows.Input

''' <summary>
''' フォーカス制御のための拡張機能を提供するクラス。
''' 継承ではなく、Attached Propertyを用いることで、既存のコントロールへ動的に振る舞いを注入する。
''' </summary>
Public Class FocusExtensions
    Inherits DependencyObject

    ' 添付プロパティの登録
    Public Shared ReadOnly EnterMovesNextProperty As DependencyProperty =
        DependencyProperty.RegisterAttached(
            "EnterMovesNext",
            GetType(Boolean),
            GetType(FocusExtensions),
            New PropertyMetadata(False, OnEnterMovesNextChanged))

    Public Shared Sub SetEnterMovesNext(element As DependencyObject, value As Boolean)
        element.SetValue(EnterMovesNextProperty, value)
    End Sub

    Public Shared Function GetEnterMovesNext(element As DependencyObject) As Boolean
        Return DirectCast(element.GetValue(EnterMovesNextProperty), Boolean)
    End Sub

    ''' <summary>
    ''' プロパティの値が変更された際のコールバック。
    ''' ここでイベントハンドラの登録・解除を制御し、メモリリークを防止する。
    ''' </summary>
    Private Shared Sub OnEnterMovesNextChanged(d As DependencyObject, e As DependencyPropertyChangedEventArgs)
        ' 対象がUIElement(コントロール)であることを確認
        Dim element As UIElement = TryCast(d, UIElement)
        If element Is Nothing Then Return

        Dim isEnabled As Boolean = DirectCast(e.NewValue, Boolean)

        If isEnabled Then
            ' PreviewKeyDownを使用することで、コントロールにイベントが到達する前に捕捉する(Tunneling)
            element.PreviewKeyDown += AddressOf OnPreviewKeyDown
        Else
            element.PreviewKeyDown -= AddressOf OnPreviewKeyDown
        End If
    End Sub

    ''' <summary>
    ''' Enterキー押下を検知し、フォーカスを論理的な次の要素へ移動させる。
    ''' </summary>
    Private Shared Sub OnPreviewKeyDown(sender As Object, e As KeyEventArgs)
        ' Enterキーのみを対象とする
        If e.Key = Key.Enter Then
            Dim element As UIElement = TryCast(sender, UIElement)
            If element Is Nothing Then Return

            ' マルチラインのTextBox(メモ帳的な入力)では、Enterは改行として扱うべきである。
            ' これを忘れると、ユーザーの意図しない挙動を生む。
            If TypeOf element Is TextBox Then
                Dim tb = DirectCast(element, TextBox)
                If tb.AcceptsReturn Then
                    ' AcceptsReturnがTrueなら、このイベントはそのままコントロールに流す
                    Return
                End If
            End If

            ' フォーカス移動の実行
            ' FocusManager.MoveFocus を使用することで、WPFの論理的なフォーカス移動ルール(Tab順序)に従う。
            ' SendKeysのような不確実なWindows API呼び出しは、スレッドの安定性を損なうため避けるべきだ。
            element.MoveFocus(New TraversalRequest(FocusNavigationDirection.Next))

            ' イベントが他の処理に流れないよう、処理済みとしてマークする
            e.Handled = True
        End If
    End Sub
End Class

3. XAMLでの適用:宣言的なUI設計

実装したプロパティは、XAML上で極めて簡潔に利用できる。エンジニアは「何をするか」ではなく「どうあるべきか」を宣言するだけで済む。

<Window x:Class="MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:local="clr-namespace:YourProjectNamespace"
        Title="High-Speed Input Form" Height="300" Width="400">
    
    <StackPanel Margin="20">
        <TextBlock Text="氏名:" Margin="0,5"/>
        <!-- 添付プロパティを適用。Enterで次のTextBoxへ -->
        <TextBox local:FocusExtensions.EnterMovesNext="True" Margin="0,0,0,10"/>

        <TextBlock Text="電話番号:" Margin="0,5"/>
        <TextBox local:FocusExtensions.EnterMovesNext="True" Margin="0,0,0,10"/>

        <TextBlock Text="備考 (Enterは改行):" Margin="0,5"/>
        <!-- AcceptsReturnがTrueのものは、Enterによるフォーカス移動の対象外となるよう設計済み -->
        <TextBox local:FocusExtensions.EnterMovesNext="True" 
                 AcceptsReturn="True" Height="60" TextWrapping="Wrap" Margin="0,0,0,10"/>

        <Button Content="登録" Width="100" HorizontalAlignment="Right"/>
    </StackPanel>
</Window>

4. アーキテクトの視点:深淵なる知見

この実装において、私が何に拘ったのか。シニアエンジニアなら、以下の3点にその意図を読み取れるはずだ。

I. トンネリング(PreviewKeyDown)の選択

WPFのイベントは「トンネリング(親から子へ)」と「バブリング(子から親へ)」の2段階で流れる。通常の `KeyDown` はバブリングだが、コントロールが内部的にイベントを `Handled = True` にしてしまうと、親要素での検知は不可能になる。`PreviewKeyDown` を採用することで、コントロールの挙動に左右されない、強固な制御を実現している。

II. 責務の分離と例外処理

`AcceptsReturn` プロパティを持つ `TextBox` に対する配慮を忘れてはならない。マルチライン入力において、Enterキーによるフォーカス移動は「機能の破壊」である。コード内でこの条件分岐を組み込むことで、汎用的なユーティリティとしての完成度を高めている。

III. メモリ管理とライフサイクル

`OnEnterMovesNextChanged` において、プロパティが `False` になった際に適切にイベントハンドラを解除(`-=`)している。これは、動的にコントロールが生成・破棄される大規模なアプリケーションにおいて、不要な参照を保持し、ガベージコレクション(GC)を阻害する事態を防ぐための鉄則である。

結論

優れたシステムとは、ユーザーが「システムを使っている」と感じさせないシステムである。
キーボード操作の淀みを排除し、思考のスピードでデータ入力が行える環境を構築すること。そのための武器として、Attached Propertyによる振る舞いの注入をマスターせよ。

技術は、使いこなして初めて価値を持つ。以上だ。

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