境界線上の設計:WPFにおけるカスタムコンバーターの極致と、MVVMの純粋性を守るためのアーキテクチャ
業務アプリケーションの規模が拡大し、複雑なビジネスロジックがUIの状態管理に侵食し始めるとき、多くのエンジニアは「ViewModelの肥大化」という泥沼に足を踏み入れる。
「ボタンを表示するかどうか」という単純なUI制御のために、ViewModelに `IsSubmitButtonVisible` といった、本来のビジネスロジックとは無関係なプロパティを量産していないだろうか? もしそうなら、君の設計は既に破綻の兆しを見せている。
真のアーキテクトは、ViewModelを「純粋な状態」の保持に留め、その状態を「いかにUIに解釈させるか」という変換の責務を、Viewのレイヤーである `IValueConverter` に委ねる。
本稿では、標準の `BooleanToVisibilityConverter` では到底太刀打ちできない、実務における複雑な表示制御を、VB.NETを用いた高度なカスタムコンバーターによって実装する手法を詳解する。
1. 逆転の論理:Invertible Converter の実装
実務において、「フラグが `False` の時に要素を表示する」という要件は、驚くほど頻繁に発生する。標準の `BooleanToVisibilityConverter` には「反転(Invert)」の機能が存在しない。ここで安易に ViewModel 側に `IsNotLoading` のような逆転プロパティを追加するのは、プロパティの爆発を招く悪手だ。
まずは、論理値を反転させ、かつ型安全に `Visibility` へ変換する、再利用性の高いコンバーターを実装する。
Imports System.Windows
Imports System.Windows.Data
''' <summary>
''' Boolean値を反転させてVisibilityへ変換する、極めて汎用性の高いコンバーター。
''' </summary>
Public Class InvertBooleanToVisibilityConverter
Implements IValueConverter
''' <summary>
''' 変換ロジック。TrueならHidden/Collapsed、FalseならVisibleを返す。
''' </summary>
''' <param name="value">変換対象のBoolean値</param>
''' <param name="targetType">ターゲットとなる型(Visibility)</param>
''' <param name="parameter">反転の有無を制御するためのオプション引数</param>
Public Function Convert(value As Object, targetType As Type, parameter As Object, culture As Globalization.CultureInfo) As Object Implements IValueConverter
' 型安全性を確保するためのTryCast。パフォーマンスと堅牢性のバランスを考慮。
Dim boolValue As Boolean = False
If Not TypeOf value Is Boolean Then
Return Visibility.Collapsed
End If
boolValue = DirectCast(value, Boolean)
' Parameterに "Invert" という文字列が渡された場合、論理を反転させる
Dim isInverted As Boolean = False
If parameter IsNot Nothing AndAlso parameter.ToString() = "Invert" Then
isInverted = True
End If
Dim result As Boolean = If(isInverted, Not boolValue, boolValue)
' 戻り値の決定。UIのレイアウト崩れを防ぐため、基本はCollapsedを選択。
Return If(result, Visibility.Visible, Visibility.Collapsed)
End Function
' OneWayToSourceは本コンバーターの責務ではないため、実装のみ行う。
Public Function ConvertBack(value As Object, targetType As Type, parameter As Object, culture As Globalization.CultureInfo) As Object Implements IValueConverter
Throw New NotSupportedException("このコンバーターは単方向(OneWay)専用である。")
End Function
End Class
XAMLでの適用
`StaticResource` として定義することで、インスタンスの生成コストを最小限に抑えるのが鉄則だ。
<Window.Resources>
<local:InvertBooleanToVisibilityConverter x:Key="InvertVisibilityConverter" />
</Window.Resources>
<!-- IsLoadingがTrueのとき、ProgressRingを「非表示」にする -->
<ProgressBar IsIndeterminate="True"
Visibility="{Binding IsLoading, Converter={StaticResource InvertVisibilityConverter}, ConverterParameter=Invert}" />
2. 複合条件の統合:MultiValueConverter による論理ゲートの構築
実務の要件は常に単一のフラグでは完結しない。「ユーザーが管理者であり、かつ、データがロード済みで、かつ、システムがメンテナンスモードでない場合のみ、編集ボタンを表示する」といった、多変数の論理演算が求められる。
これを ViewModel で実装すれば、ViewModel は UI の表示条件という「関心事」に汚染される。これを回避するために、`IMultiValueConverter` を用いて、View 側で論理ゲート(AND/OR/XOR)を構築する。
Imports System.Windows
Imports System.Windows.Data
''' <summary>
''' 複数の値を受け取り、それらの論理和(OR)または論理積(AND)を評価してVisibilityを返す。
''' </summary>
Public Class MultiConditionVisibilityConverter
Implements IMultiValueConverter
Public Function ConvertMulti(values As Object(), targetType As Type, parameter As Object, culture As Globalization.CultureInfo) As Object Implements IMultiValueConverter.Convert
' parameter に "AND" または "OR" を指定することで挙動を切り替える。
Dim mode As String = If(parameter IsNot Nothing, parameter.ToString().ToUpper(), "AND")
Dim results As New List(Of Boolean)()
For Each val In values
If TypeOf val Is Boolean Then
results.Add(DirectCast(val, Boolean))
Else
' 非Booleanが混入した場合は、安全のためにFalseとして扱う
results.Add(False)
End If
Next
If results.Count = 0 Then Return Visibility.Collapsed
Dim finalResult As Boolean = False
If mode = "OR" Then
' いずれかがTrueならTrue
finalResult = results.Any(Function(b) b = True)
Else
' すべてがTrueならTrue
finalResult = results.All(Function(b) b = True)
End If
Return If(finalResult, Visibility.Visible, Visibility.Collapsed)
End Function
Public Function ConvertBack(value As Object, targetType As Type, parameter As Object, culture As Globalization.CultureInfo) As Object Implements IMultiValueConverter.ConvertBack
Throw New NotSupportedException()
End Function
End Class
XAMLでの適用
複数のプロパティを一つの `MultiBinding` で束縛する。これにより、ViewModel は個々のプロパティを公開するだけで済み、表示ロジックは XAML 上に宣言的に記述される。
<Button Content="高度な編集実行">
<Button.Visibility>
<MultiBinding Converter="{StaticResource MultiConditionVisibilityConverter}" ConverterParameter="AND">
<Binding Path="IsAdmin" />
<Binding Path="IsDataLoaded" />
<Binding Path="IsNotMaintenanceMode" />
</MultiBinding>
</Button.Visibility>
</Button>
3. アーキテクトの視点:メモリ最適化とライフサイクル管理
ここで、シニアエンジニアが注視すべき、パフォーマンスとメモリに関する極限の知見を共有する。
インスタンス化のコスト
WPF の `Binding` は強力だが、その裏では膨大なオブジェクトの生成と監視が行われている。
特に `DataTemplate` 内でコンバーターを直接記述(`
鉄則:コンバーターは必ず `StaticResource` として定義し、シングルトン的に再利用せよ。
例外処理の設計
コンバーター内での例外は、UIスレッドを停止させ、最悪の場合、アプリケーション全体のクラッシュを招く。
`DirectCast` を多用するのではなく、`TryCast` や `TypeOf` による厳格な型チェックを徹底すること。また、コンバーターは「値の変換」に徹し、コンバーター内で Windows API を直接呼び出したり、外部リソースにアクセスしたりしてはならない。それは「副作用」であり、テスト不能なコードを生む原因となる。
レガシー環境との共存
VBA や古い WinForms から移行してきたシステムでは、データ型が `Object` や `Variant` に近い挙動を示すことがある。VB.NET の `Option Strict On` を有効にした状態で、これらのコンバーターを実装することで、実行時の型不一致によるランタイムエラーを、コンパイル時の静的解析によって防ぐことができる。
結言
コンバーターを使いこなすということは、単にコードを書くことではない。「何がデータであり、何が表現であるか」という境界線を、設計によって明確に引くことを意味する。
ViewModel を純粋に保ち、View の表現力をコンバーターに集約させる。この規律を守ることこそが、保守不能なレガシーシステムへと転落するのを防ぐ、唯一の道である。
