【入門編】【中級者・実務】VB.NETのWPFアプリにおける自作コンバーターとBooleanToVisibilityConverterの高度な拡張 – Visual Basic (VB / VB.NET)解析バイブル

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

【極限の知見】WPFのUI制御を自由自在に操る:カスタムコンバーターによる「表示・非表示」の芸術的制御

こんにちは。現場の設計と実装を支えるチーフアーキテクトです。

Excelマクロ(VBA)の時代から、プログラミングの世界に足を踏み入れている皆さん。もしあなたが「ボタンを非表示にするために、ViewModelの中にわざわざ `IsButtonVisible` というプロパティを、本来のロジックとは無関係に作らされている」と感じているなら、それはあなたが「モダンなUI構築の壁」に突き当たっている証拠です。

VBAでは `CommandButton1.Visible = False` と一行書けば済みました。しかし、WPF(Windows Presentation Foundation)の世界では、UIはデータ(ViewModel)の状態を「映し出す鏡」でなければなりません。

今日は、標準の `BooleanToVisibilityConverter` では太刀打ちできない、「複雑な条件による表示制御」を、VB.NETの力を借りてエレガントに解決する方法を伝授します。ここをマスターすれば、あなたのコードから「UI制御のための無駄なプロパティ」が消え、設計の美しさが劇的に向上しますよ。

1. なぜ標準のコンバーターでは「足りない」のか?

WPFには標準で `BooleanToVisibilityConverter` という、`True` なら `Visible`、`False` なら `Collapsed`(非表示)に変換する便利な道具が用意されています。

しかし、実務ではこんな要望が必ず飛び込んできます。

  • 「逆転させたい」:`IsLoading` が `True` の時に、ボタンを非表示にしたい。
  • 「複数条件を組み合わせたい」:`IsAdmin`(管理者権限)が `True` かつ `IsInitialized`(初期化完了)が `True` の時だけ表示したい。

標準のコンバーターでこれを行おうとすると、ViewModel側に「表示判定用のフラグ」をわざわざ作るハメになります。これは「UIのためのロジック」が「ビジネスロジック」を汚染している状態です。

これを解決するのが、`IValueConverter`(値変換器)の自作です。

2. 【Level 1】逆転の美学:InverseBooleanToVisibilityConverter

まずは、最も需要の高い「真偽値を反転させて表示・非表示を切り替える」コンバーターを作ってみましょう。

実装コード (VB.NET)

このクラスをプロジェクトに追加してください。

Imports System.Windows.Data
Imports System.Windows

''' <summary>
''' Booleanの値を反転させてVisibilityに変換するカスタムコンバーター
''' True -> Collapsed / False -> Visible
''' </summary>
Public Class InverseBooleanToVisibilityConverter
    Implements IValueConverter

    ''' <summary>
    ''' 値を変換するメインロジック
    ''' </summary>
    ''' <param name="value">変換元の値(Booleanを想定)</param>
    ''' <param name="targetType">変換先の型(Visibilityを想定)</param>
    Public Function Convert(value As Object, targetType As Type, parameter As Object, culture As Globalization.CultureInfo) As Object Implements IValueConverter.Convert
        ' 1. 入力値がBooleanかどうかを安全にチェック
        If value IsNot Nothing AndAlso TypeOf value Is Boolean Then
            Dim boolValue As Boolean = DirectCast(value, Boolean)

            ' 2. 値を反転させてVisibilityを返す
            ' True なら Collapsed (非表示)、False なら Visible (表示)
            Return If(boolValue, Visibility.Collapsed, Visibility.Visible)
        End If

        ' 変換できない場合は、デフォルトとして非表示を返す(安全策)
        Return Visibility.Collapsed
    End Function

    ''' <summary>
    ''' 逆方向の変換(BindingのTwoWayの場合に使用)
    ''' 今回のような表示制御では通常使用しないため、何もしない
    ''' </summary>
    Public Function ConvertBack(value As Object, targetType As Type, parameter As Object, culture As Globalization.CultureInfo) As Object Implements IValueConverter.ConvertBack
        Return Binding.DoNothing
    End Function
End Class

XAMLでの使い方

作成したコンバーターは、XAMLの `Resources` セクションに登録して使用します。

<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="Converter Demo" Height="200" Width="300">
    
    <Window.Resources>
        <!-- コンバーターをリソースとして定義 -->
        <local:InverseBooleanToVisibilityConverter x:Key="InverseBoolToVis" />
    </Window.Resources>

    <StackPanel Margin="20">
        <!-- IsProcessingがTrueの時、ボタンは「非表示」になる -->
        <Button Content="処理実行" 
                IsEnabled="{Binding IsProcessing, Converter={StaticResource InverseBoolToVis}}" 
                Visibility="{Binding IsProcessing, Converter={StaticResource InverseBoolToVis}}"/>
        
        <TextBlock Text="処理中..." 
                   Visibility="{Binding IsProcessing, Converter={StaticResource InverseBoolToVis}}" 
                   HorizontalAlignment="Center" Margin="10"/>
    </StackPanel>
</Window>

3. 【Level 2】複合的な判断:MultiValueConverter の極意

次に、実務で最も強力な武器となる「複数の条件を組み合わせた変換」です。
例えば、「ユーザーがログインしており、かつ、管理者権限を持っている時だけ、設定ボタンを表示する」というケースです。

これには `IMultiValueConverter` インターフェースを使用します。

実装コード (VB.NET)

Imports System.Windows.Data
Imports System.Windows

''' <summary>
''' 複数のBoolean値を組み合わせて、一つのVisibilityを決定するコンバーター
''' </summary>
Public Class MultiBooleanToVisibilityConverter
    Implements IMultiValueConverter

    ''' <summary>
    ''' 複数の値を評価する
    ''' </summary>
    ''' <param name="values">Bindingされた複数の値の配列</param>
    Public Function Convert(values As Object(), targetType As Type, parameter As Object, culture As Globalization.CultureInfo) As Object Implements IMultiValueConverter.Convert
        ' 1. 配列の要素数が足りているか、またはNullが含まれていないかチェック
        ' 実務ではここでのNullチェックが「アプリが落ちない」ための生命線です
        If values Is Nothing OrElse values.Length < 2 Then
            Return Visibility.Collapsed
        End If

        ' 2. 各要素をBooleanとして取り出す
        ' TryCastやNothingチェックを丁寧に行うのがプロの流儀
        Dim isLogged As Boolean = If(TypeOf values(0) Is Boolean, DirectCast(values(0), Boolean), False)
        Dim isAdmin As Boolean = If(TypeOf values(1) Is Boolean, DirectCast(values(1), Boolean), False)

        ' 3. 論理演算(AND条件)で判定
        ' ここを AndAlso に変えれば「どちらかがTrueなら表示」にも変更可能
        If isLogged AndAlso isAdmin Then
            Return Visibility.Visible
        Else
            Return Visibility.Collapsed
        End If
    End Function

    Public Function ConvertBack(value As Object, targetType As Type, parameter As Object, culture As Globalization.CultureInfo) As Object Implements IMultiValueConverter.ConvertBack
        Return Binding.DoNothing
    End Function
End Class

XAMLでの使い方

`MultiBinding` を使って、複数のプロパティを一つのコンバーターに流し込みます。

<Window.Resources>
    <local:MultiBooleanToVisibilityConverter x:Key="MultiBoolToVis" />
</Window.Resources>

<!-- 中略 -->

<Button Content="管理者設定" 
        Visibility="{Binding Converter={StaticResource MultiBoolToVis}, 
                    MultiBinding={
                        Binding IsLoggedIn, 
                        Binding IsAdmin
                    }}"/>

4. アーキテクトからの助言:陥りやすい罠と回避策

ここまで実装できたあなたは、もう初心者ではありません。しかし、伝説のエンジニアになるためには、以下の「落とし穴」を知っておく必要があります。

① コンバーター内での「重い処理」は厳禁

コンバーターの `Convert` メソッドは、UIが更新されるたびに、あるいはデータバインディングが再評価されるたびに頻繁に呼び出されます。
ここでデータベースにアクセスしたり、複雑な計算を行ったりすると、UIの描画がガタガタになり(フレームレートの低下)、ユーザー体験を著しく損ないます。
「コンバーターは、あくまで値の『見た目』を整えるだけの軽量なフィルターであるべき」という原則を忘れないでください。

② Nullの恐怖を甘く見ない

バインディングされているデータがまだ初期化されていない場合、`value` には `Nothing` (null) が渡ってきます。
`DirectCast(value, Boolean)` をいきなり使うと、`NullReferenceException` でアプリがクラッシュします。
必ず `TypeOf value Is Boolean` や `value IsNot Nothing` によるガードを入れましょう。

③ 戻り値の型の一致

`Convert` メソッドの戻り値は、XAML側で指定したプロパティ(今回は `Visibility`)と型が一致している必要があります。型が違うと、デバッグ出力に「BindingExpression path error」という警告が溢れかえり、本当のエラーを見逃す原因になります。

まとめ:ここをクリアすれば、VB.NETの基本はバッチリですよ

いかがでしたか?

1. `IValueConverter` は、データと見た目を切り離すための「橋渡し役」。
2. `Inverse`(反転) は、単一の値をひっくり返すだけでUIの柔軟性が増す。
3. `IMultiValueConverter` は、複雑なビジネスルールをViewModelから解放する。

これらを使いこなせるようになると、あなたのViewModelは「純粋なビジネスロジック」だけを記述する美しく、テストしやすいものへと進化します。

プログラミングは、単に動くものを作る作業ではありません。「いかにして、変更に強く、読みやすい構造を作るか」という設計の旅です。

さあ、自信を持って、あなたのプロジェクトにこの「エレガントな制御」を取り入れてみてください。応援していますよ!

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