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

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

「Enterキーで次へ」を、ただのコピペで終わらせるな。WPFにおける真のフォーカス制御設計論

現場のリーダーとして、多くの「動くけれど、保守が地獄」なツールを見てきた。

業務効率化ツールを作ろうとする初心者が必ずと言っていいほど陥る罠がある。それは、「個別のコントロールにイベントハンドラを貼り付けまくる」という、極めて低次元な実装だ。

「Enterキーを押したら次のテキストボックスにフォーカスを移したい」
その要求自体は正しい。しかし、その実現方法が「各TextBoxのKeyDownイベントに、if文でEnter判定を書いて、TabIndexを操作する」といった実装であれば、君の書いたコードは将来的に技術的負債へと変わるだろう。

コントロールが10個ならいい。だが、業務システムには100個、200個の入力項目が登場する。そのたびにイベントを書き足すのか? 途中に項目を追加したとき、TabIndexの番号をすべて手動で修正するのか?

今日は、プロフェッショナルとして、WPFの機能を最大限に活用した「拡張可能な、堅牢なフォーカス制御」の設計思想を伝授する。

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

まず、やってはいけない「アンチパターン」を明確にしておく。

' --- ❌ アンチパターン:各コントロールに個別のイベントを記述 ---
Private Sub TextBox1_KeyDown(sender As Object, e As KeyEventArgs) Handles TextBox1.KeyDown
    If e.Key = Key.Enter Then
        TextBox2.Focus() ' 次の項目を直接指定している
    End If
End Sub

Private Sub TextBox2_KeyDown(sender As Object, e As KeyEventArgs) Handles TextBox2.KeyDown
    If e.Key = Key.Enter Then
        TextBox3.Focus()
    End If
End Sub

このコードの致命的な欠陥は以下の3点だ。

1. 密結合 (Tight Coupling): `TextBox1` が `TextBox2` の存在を知りすぎている。項目の入れ替えが困難だ。
2. 保守性の欠如: 項目が増えるたびに、コード(ロジック)を書き換えなければならない。
3. DRY原則の違反: 同じロジックを何度も繰り返している。これは「プログラミングにおける罪」だ。

我々が目指すべきは、「XAML(見た目)に『この項目はEnterで次へ移動する』という属性を付与するだけで、ロジックは一切書かずに実現する」という設計だ。

2. 解決策:Attached Property(添付プロパティ)による抽象化

WPFの真骨頂は、Attached Property(添付プロパティ)にある。これは、既存のコントロールに、あたかも新しいプロパティが備わっているかのように、後付けで機能を注入する仕組みだ。

これを使えば、コントロールの挙動を「外側から」制御できる。

プロダクション品質のコード例

以下のクラスは、単なる「次へ移動」の実装ではない。WPFのフォーカス移動の標準的な仕組みである `TraversalRequest` を利用し、コントロールの論理的な順序に基づいた移動を実現している。

Imports System.Windows
Imports System.Windows.Input

''' <summary>
''' フォーカス制御のための拡張機能クラス。
''' プロダクション環境での再利用を想定した設計。
''' </summary>
Public Class FocusBehavior
    ' 添付プロパティの定義
    ' XAMLから「EnterMovesFocus=True」のように指定可能にする
    Public Shared ReadOnly EnterMovesFocusProperty As DependencyProperty =
        DependencyProperty.RegisterAttached(
            "EnterMovesFocus",
            GetType(Boolean),
            GetType(FocusBehavior),
            New PropertyMetadata(False, OnEnterMovesFocusChanged))

    Public Shared Property EnterMovesFocus As Boolean
        Get(ByVal obj As Object)
            Return DirectCast(obj, DependencyObject).GetValue(EnterMovesFocusProperty)
        End Get
        Set(ByVal obj As Object, ByVal value As Boolean)
            DirectCast(obj, DependencyObject).SetValue(EnterMovesFocusProperty, value)
        End Set
    End Property

    ' プロパティの値が変わったときのハンドラ
    Private Shared Sub OnEnterMovesFocusChanged(ByVal d As Object, ByVal e As DependencyPropertyChangedEventArgs)
        Dim control As FrameworkElement = DirectCast(d, FrameworkElement)
        Dim isEnabled As Boolean = DirectCast(e, DependencyPropertyChangedEventArgs).NewValue

        If isEnabled Then
            ' PreviewKeyDownを使用する理由:
            ' 通常のKeyDownでは、コントロール内部でEnterが処理(消費)されてしまうことがあるため、
            // コントロールにイベントが届く前の段階で割り込む必要がある。
            AddHandler control.PreviewKeyDown, AddressOf OnPreviewKeyDown
        Else
            RemoveHandler control.PreviewKeyDown, AddressOf OnPreviewKeyDown
        End If
    End Sub

    ''' <summary>
    ''' キー押下イベントのハンドラ。
    ''' </summary>
    Private Shared Sub OnPreviewKeyDown(ByVal sender As Object, ByVal e As KeyEventArgs)
        ' Enterキーが押されたか判定
        If e.Key = Key.Enter Then
            Dim control As FrameworkElement = DirectCast(sender, FrameworkElement)

            ' 次のコントロールへ移動するためのリクエストを作成
            ' TabIndexに基づいた論理的な移動を行う
            Dim request As New TraversalRequest(FocusNavigationDirection.Next)
            
            ' フォーカス移動を実行
            control.MoveFocus(request)

            ' Enterキーのイベントが、さらに下の階層(TextBox自体など)に伝播して
            ' 余計な動作(改行など)をすることを防ぐ
            e.Handled = True
        End If
    End Sub
End Class

3. XAMLでの実装:スマートな記述

上記のクラスを定義したら、あとはXAMLでそのクラスをインポートし、プロパティをセットするだけだ。見ての通り、VB.NETのコードビハインドには一行も書かない。

<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:YourAppNamespace" 
        Title="Smart Input Form" Height="300" Width="400">
    
    <StackPanel Margin="20">
        <TextBlock Text="氏名:" Margin="0,10,0,0"/>
        <!-- 添付プロパティを適用。これだけでEnter移動が可能になる -->
        <TextBox local:FocusBehavior.EnterMovesFocus="True" Margin="0,5"/>

        <TextBlock Text="メールアドレス:" Margin="0,10,0,0"/>
        <TextBox local:FocusBehavior.EnterMovesFocus="True" Margin="0,5"/>

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

        <Button Content="登録" Margin="0,20,0,0" Width="100" HorizontalAlignment="Left"/>
    </StackPanel>
</Window>

*(※ `YourAppNamespace` は実際のプロジェクトのプロジェクト名に置き換えてください)*

4. 現場で生き残るための「設計の勘所」

コードが書けただけでは、あなたはまだアーキテクトではない。以下の3点を常に意識しろ。

① TabIndexの管理を徹底せよ

`MoveFocus(TraversalRequest(FocusNavigationDirection.Next))` は、WPFが内部で持っている「タブ順序」に従って動く。つまり、`TabIndex` プロパティの設定が、そのままフォーカス移動の設計図になるということだ。
コントロールを配置した順番通りに動かしたいなら、XAMLの配置順を整理するか、明示的に `TabIndex` を割り振れ。

② データバインディングとバリデーションの衝突

Enterキーでフォーカスが移動した瞬間、`LostFocus` イベントが発生する。もし、入力値のバリデーション(検証)を `LostFocus` で行っている場合、Enterキーによる高速な移動がバリデーションの連鎖を引き起こし、パフォーマンスを低下させたり、予期せぬエラーを誘発したりすることがある。
「フォーカス移動」と「データの確定(Commit)」のライフサイクルを切り離して設計することを忘れるな。

③ データベース連携時の注意

入力フォームを高速に操作させる場合、ユーザーは「入力している最中」に次の項目へ移る。もし、フォーカスが移るたびにデータベースへ `UPDATE` をかけるような実装をしていたら、そのシステムはすぐに破綻する。
データ保存は、明示的な「保存ボタン」押下、あるいはフォーカスがフォーム外に出たタイミングなど、適切なタイミングでバッチ的に行う設計にせよ。

まとめ:保守性の高いコードとは何か

優れたエンジニアは、「機能を追加する際に、既存のコードを触らなくて済む方法」を常に考える。

今回紹介した `Attached Property` を使った手法は、新しい入力項目が増えても、XAMLに一行書き足すだけで済む。ロジックを修正する必要はない。これが、真に堅牢で、スケーラブルな設計だ。

「とりあえず動く」コードを書くのは簡単だ。しかし、そのコードが1年後の自分やチームメイトを苦しめることになる。
常に、「変更に強いか?」「拡張に耐えうるか?」を自らに問い続けろ。それが、伝説のアーキテクトへの第一歩だ。

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