デザイナ任せのUIは去れ。DataGridViewの動的コンテキストメニューで「鉄壁のオペレーション」を構築する
現場のエンジニア諸君、今日もUIの「誤操作」と格闘しているか？
Visual Basic (VB.NET)を用いたWinForms開発において、最も軽視されがちなのが「コンテキストメニュー（右クリックメニュー）の品格」だ。静的なメニューを貼り付けて満足しているなら、それはプロとは呼べない。
真のシステムアーキテクトは、右クリックされたその瞬間に、対象データのステータス、ユーザーの権限、そして前後の業務トランザクションの整合性を一瞬で計算し、メニューを「再構築」する。今回は、DataGridViewにおける極限のUI制御術を伝授する。
—
1. デザイナ依存からの脱却：なぜ動的構築なのか
多くの開発者は `ContextMenuStrip` をデザイナで配置し、プロパティで固定する。しかし、これでは「特定の行では実行不可だが、別行なら実行可能」といった複雑な排他制御が、クリック後のイベントハンドラで「警告ダイアログを出す」という場当たり的な実装になりがちだ。
我々が目指すのは「メニューを見せない、あるいは無効化することで誤操作を物理的に封じる」設計だ。 `CellMouseClick` イベントをフックし、メニューが描画される直前にその行の属性を評価する。これが最も軽量かつ堅牢なアプローチである。
—
2. 核心の実装：CellMouseClickによる動的インターセプション
以下のコードは、単なるメニュー表示ではない。対象行のデータバインドされたオブジェクトを特定し、その権限に応じてメニュー項目を再編するロジックだ。
”’
”’
Private Sub dgvMain_CellMouseClick(sender As Object, e As DataGridViewCellMouseEventArgs) Handles dgvMain.CellMouseClick
‘ 右クリック以外の挙動は無視し、ヘッダークリックも除外
If e.Button <> MouseButtons.Right OrElse e.RowIndex < 0 Then Return
' 右クリックした行を選択状態にする（UXの基本）
dgvMain.Rows(e.RowIndex).Selected = True
' コンテキストメニューのインスタンスをクリア（メモリリーク防止のため再利用ではなく再生成を推奨）
Dim menu As New ContextMenuStrip()
' バインドされているデータオブジェクトを取得
Dim rowData As MyBusinessEntity = DirectCast(dgvMain.Rows(e.RowIndex).DataBoundItem, MyBusinessEntity)
' 権限とステータスによる動的制御
' 例：承認済みデータは編集不可とする
Dim editItem As New ToolStripMenuItem("編集")
editItem.Enabled = (rowData.Status <> Status.Approved)
AddHandler editItem.Click, AddressOf OnEditClicked
menu.Items.Add(editItem)
‘ 削除権限のチェック
Dim deleteItem As New ToolStripMenuItem(“削除”)
deleteItem.Enabled = MyUserContext.HasPermission(Permission.Delete)
AddHandler deleteItem.Click, AddressOf OnDeleteClicked
menu.Items.Add(deleteItem)
‘ メニューを表示
menu.Show(dgvMain, Cursor.Position)
End Sub
この設計が優れている理由
1. 状態の強制同期: メニューが表示された瞬間が、そのデータの「最新の状態」であると保証される。
2. メモリの適正管理: `ContextMenuStrip` をフィールド変数として保持し続けると、肥大化や予期せぬ状態保持のリスクがある。ローカル変数としてスコープを閉じ、不要になった瞬間にGC（ガベージコレクタ）に委ねるのが、長期稼働するレガシー・システムでの生存戦略だ。
—
3. シニアエンジニアの視点：パフォーマンスとリソース管理
VB.NETにおけるWinForms開発の罠は、イベントハンドラの多重登録によるメモリリークだ。上記のコードでは、`AddHandler` を使用しているが、これはメニューが破棄される際に適切に処理されなければならない。
もし、メニューの生成頻度が極めて高い場合は、インスタンスを使い回すのではなく、`Dispose()` を明示的に呼ぶ実装を検討せよ。
‘ メニューが閉じた瞬間に明示的なリソース解放を行う
AddHandler menu.Closed, Sub(s, args)
Dim m = DirectCast(s, ContextMenuStrip)
m.Items.Clear()
m.Dispose()
End Sub
—
4. 結び：コードは「対話」である
UIはユーザーとの対話の窓口だ。メニュー項目がグレーアウトしていることは、ユーザーに対し「このシステムはあなたの操作を理解し、ルールに基づいて拒絶している」という明確なフィードバックを与える。
エラーメッセージをポップアップさせるのは、設計の怠慢だ。正しいUIは、ユーザーを迷わせない。
レガシーなVB.NET環境であっても、現代的な設計思想を適用する余地は十分にある。動的なメニュー生成は、その第一歩に過ぎない。諸君のシステムが、より堅牢で、かつ洗練されたものになることを期待している。
――以上。現場からは以上だ。
