「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年後の自分やチームメイトを苦しめることになる。
常に、「変更に強いか?」「拡張に耐えうるか?」を自らに問い続けろ。それが、伝説のアーキテクトへの第一歩だ。
