【入門編】【上級者向け】VB.NETによるWPFカスタムコントロールのテンプレートセレクターとControlTemplateの完全自作 – Visual Basic (VB / VB.NET)解析バイブル

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

脱・マクロの先へ。VB.NETとWPFで極める「見た目」と「ロジック」の完全分離術

「Excelマクロは得意になったけれど、業務アプリケーションを作ろうとすると、なんだかデザインが古臭いし、機能拡張も難しい……」

もしあなたがそう感じているなら、おめでとうございます。あなたは今、「ただの自動化担当者」から「真のソフトウェアエンジニア」へと進化する境界線に立っています。

今日、私たちが挑むのは、Visual Basic (VB.NET) と WPF (Windows Presentation Foundation) を使った、極めて高度で美しいUI構築のテクニックです。単にボタンを並べるだけではなく、「状況に応じて、コントロール自身の姿を劇的に変える」という、プロの開発現場でも使われる「カスタムコントロール」の設計思想を伝授します。

ここをクリアすれば、あなたの作るツールは、まるでモダンなWebサービスのような洗練された操作性を手に入れることができるでしょう。さあ、一緒に深淵なるWPFの世界へ踏み出しましょう。

1. 概念の理解:なぜ「テンプレート」が必要なのか?

まず、設計の核心となる「考え方」を整理しましょう。

従来の Windows Forms や VBA の開発では、ボタンの色を変えたり、形を変えたりするには、コードの中で「このボタンの背景色を赤にせよ」といった命令を直接書いていました。これは「ロジック(振る舞い)」と「デザイン(見た目)」が密結合(べったりとくっついている状態)していることを意味します。

これでは、デザインを変更したいときに、プログラムの心臓部まで書き直さなければならず、バグの温床になります。

WPFが提唱する究極の解決策は、「役割の完全分離」です。

  • Control (VB.NET): 「何をするか」を決める脳(ロジック)。
  • ControlTemplate (XAML): 「どう見えるか」を決める皮膚(デザイン)。
  • TemplateSelector (VB.NET): 「今の状況なら、どの皮膚を被るべきか」を判断する意思決定者。

この3つを組み合わせることで、「データが重要度『高』なら、燃えるような赤いデザインにする」「重要度『低』なら、落ち着いたグレーにする」といった動きを、ロジックを汚さずに実現できるのです。

2. 実践:スマート・ステータス・カードの構築

では、具体的なコードを見ていきましょう。
今回は、「データの重要度(Priority)に応じて、見た目がガラリと変わるカスタムコントロール」を自作します。

Step 1: 状態を定義する(Enum)

まずは、コントロールが持つべき「状態」を定義します。

' Priority.vb
Public Enum TaskPriority
    Normal    ' 通常
    Warning   ' 注意
    Critical  ' 緊急
End Enum

Step 2: カスタムコントロールの設計(The Brain)

次に、コントロールの本体を作ります。ここでのポイントは、DependencyProperty(依存関係プロパティ)を使うことです。これを使わないと、XAML側からのデータバインディング(値の連動)ができません。

' PriorityStatusControl.vb
Imports System.Windows
Imports System.Windows.Controls

''' <summary>
''' 重要度に応じて見た目が変わるカスタムコントロール
''' </summary>
Public Class PriorityStatusControl
    Inherits Control

    ' 依存関係プロパティの登録
    ' これにより、XAMLから "Priority" という名前で値を操作できるようになります
    Public Shared ReadOnly PriorityProperty As DependencyProperty =
        DependencyProperty.Register(
            "Priority",
            GetType(TaskPriority),
            GetType(PriorityStatusControl),
            New PropertyMetadata(TaskPriority.Normal))

    ''' <summary>
    ''' 現在の重要度を取得または設定します
    ''' </summary>
    Public Property Priority As TaskPriority
        Get
            Return DirectCast(GetValue(PriorityProperty), TaskPriority)
        End Get
        Set(value As TaskPriority)
            SetValue(PriorityProperty, value)
        End Set
    End Property

    ' コンストラクタ
    Public Sub New()
        ' デフォルトのスタイルを適用するための準備(通常はGeneric.xamlで行う)
        Me.DefaultStyleKey = GetType(PriorityStatusControl)
    End Sub
End Class

Step 3: テンプレートセレクターの実装(The Decision Maker)

ここが今回のハイライトです。`Priority` の値を見て、適用する `ControlTemplate` を切り替える「司令塔」を作ります。

' PriorityTemplateSelector.vb
Imports System.Windows

''' <summary>
''' Priorityの値に基づいて、異なるControlTemplateを選択するクラス
''' </summary>
Public Class PriorityTemplateSelector
    Inherits DataTemplateSelector

    ' XAML側から各テンプレートを注入するためのプロパティ
    Public Property NormalTemplate As DataTemplate
    Public Property WarningTemplate As DataTemplate
    Public Property CriticalTemplate As DataTemplate

    ''' <summary>
    ''' 選択ロジックの本体
    ''' </summary>
    ''' <param name="item">評価対象のオブジェクト</param>
    ''' <param name="container">表示される親要素</param>
    ''' <returns>選ばれたテンプレート</returns>
    Public Overrides Function SelectTemplate(item As Object, container As DependencyObject) As DataTemplate
        ' itemは、PriorityStatusControl自身を指している想定
        Dim control = TryCast(item, PriorityStatusControl)
        
        If control Is Nothing Then Return Nothing

        ' 状態に応じて、用意されたテンプレートを返却する
        Select Case control.Priority
            Case TaskPriority.Warning
                Return WarningTemplate
            Case TaskPriority.Critical
                Return CriticalTemplate
            Case Else
                Return NormalTemplate
        End Select
    End Function
End Class

Step 4: デザインの定義(The Soul)

最後に、XAMLで「見た目」を定義します。ここでは、3つの異なるデザイン(Template)を用意します。

<!-- MainWindow.xaml (一部抜粋) -->
<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="Advanced WPF" Height="350" Width="500">

    <Window.Resources>
        <!-- 1. 通常時のデザイン -->
        <DataTemplate x:Key="NormalTemplate">
            <Border BorderBrush="Gray" BorderThickness="2" CornerRadius="5" Padding="10" Background="White">
                <TextBlock Text="【通常】業務を継続してください" Foreground="Black"/>
            </Border>
        </DataTemplate>

        <!-- 2. 注意時のデザイン -->
        <DataTemplate x:Key="WarningTemplate">
            <Border BorderBrush="Orange" BorderThickness="3" CornerRadius="5" Padding="10" Background="LightYellow">
                <TextBlock Text="【注意】確認が必要です" Foreground="DarkOrange" FontWeight="Bold"/>
            </Border>
        </DataTemplate>

        <!-- 3. 緊急時のデザイン -->
        <DataTemplate x:Key="CriticalTemplate">
            <Border BorderBrush="Red" BorderThickness="4" CornerRadius="5" Padding="10" Background="MistyRose">
                <StackPanel Orientation="Horizontal">
                    <Ellipse Fill="Red" Width="10" Height="10" Margin="0,0,10,0"/>
                    <TextBlock Text="【緊急】即時対応してください!" Foreground="Red" FontWeight="ExtraBold"/>
                </StackPanel>
            </Border>
        </DataTemplate>

        <!-- セレクターのインスタンス化 -->
        <local:PriorityTemplateSelector x:Key="MyPrioritySelector"
            NormalTemplate="{StaticResource NormalTemplate}"
            WarningTemplate="{StaticResource WarningTemplate}"
            CriticalTemplate="{StaticResource CriticalTemplate}"/>
    </Window.Resources>

    <StackPanel Margin="20">
        <!-- カスタムコントロールの利用例 -->
        <TextBlock Text="ステータス表示テスト" FontSize="18" Margin="0,0,0,10"/>
        
        <!-- ContentControlを使い、セレクターを適用して表示 -->
        <ContentControl Content="{Binding ElementName=MyControl, Path=}" 
                        ContentTemplateSelector="{StaticResource MyPrioritySelector}"/>

        <!-- テスト用のスライダー(Priorityを動的に変えるため) -->
        <Slider x:Name="MyControlSlider" Minimum="0" Maximum="2" Margin="0,20,0,0" TickFrequency="1" IsSnapToTickEnabled="True"/>
        
        <!-- 上記スライダーの値と、カスタムコントロールのPriorityを紐付け -->
        <local:PriorityStatusControl x:Name="MyControl" 
                                     Priority="{Binding ElementName=MyControlSlider, Path=Value}"/>
        
        <TextBlock Text="スライダーを動かして見た目の変化を確認してください" Margin="0,10,0,0" Foreground="Gray"/>
    </StackPanel>
</Window>

3. 陥りやすい罠と、プロの回避策

ここまで実装できれば、あなたはもう初心者ではありません。しかし、伝説のエンジニアへの道にはまだ落とし穴が残っています。

① DependencyProperty を忘れるな

もし、`Priority` プロパティをただの `Property` として定義してしまったら、スライダーを動かしても画面はピクリとも動きません。WPFの通知システム(Binding)に乗るためには、必ず `DependencyProperty.Register` を通じて登録する必要があります。これは「データの変化をWPFエンジンに通知するための儀式」だと思ってください。

② メモリリークへの警戒

`TemplateSelector` を複雑にしすぎると、大量のコントロールを表示した際にパフォーマンスが低下することがあります。テンプレートの中で重い画像リソースなどを大量に読み込むのではなく、可能な限りシンプルな形状(Shape)や軽量なリソースを使用するように心がけましょう。

③ ライフサイクルを意識する

カスタムコントロールが生成されるタイミングと、プロパティがセットされるタイミングは必ずしも一致しません。`SelectTemplate` が呼ばれる際、`item` が期待通りの型であるか、必ず `TryCast` で安全にチェックしてください。

結びに:エンジニアとしての第一歩

お疲れ様でした。今日学んだことは、単なる「コードの書き方」ではありません。「変化に強い、柔軟な設計思想」です。

「この機能、デザインが変わったら全部書き直しかな……?」
そんな不安を感じる必要はもうありません。あなたは、ロジックという「魂」と、テンプレートという「衣装」を切り離して管理する方法を手に入れたのです。

最初は難しく感じるかもしれません。でも、この「分離」の感覚を掴んだとき、あなたの作るアプリケーションの品質は、劇的に、そして決定的に変わります。

ここをクリアすれば、Visual Basic (VB.NET) の真の力を引き出す準備はバッチリですよ。次は、もっと複雑なアニメーションや、高度なデータバインディングの世界で会いましょう!

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