【実務・中級編】【初心者向け】VB.NETのWPFアプリにおけるResourcesの活用:App.xamlを使った共通カラーパレットとスタイルの一元管理 – Visual Basic (VB / VB.NET)解析バイブル

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

WPF設計の聖域:App.xamlによる「リソース一元管理」で、保守性の低いスパゲッティUIを撲滅せよ

業務自動化ツールの開発において、多くのエンジニアが陥る「致命的な罠」がある。それは、「見た目の定義を各コントロールに直接書き込む」という行為だ。

「ボタンの色を少し変えたい」「アプリ全体のフォントを統一したい」――そんなクライアントからのささやかな要望に対し、数百のXAMLファイルを一つずつ開き、`Background=”Blue”` を `Background=”Navy”` に書き換える作業を、君はプロの仕事として受け入れられるだろうか?

もしそうなら、君の設計は「動くが、維持できない」欠陥品だ。

本記事では、WPF(Windows Presentation Foundation)における真の設計思想、すなわち`ResourceDictionary`を用いたリソースの一元管理について、VB.NETでの実装例を交えて伝授する。これをマスターすれば、君の作るツールは「変更に強く、美しい」プロフェッショナルなプロダクトへと昇華する。

1. なぜ「直接記述」は悪なのか?:設計思想の転換

WPFにおいて、色(Color)やブラシ(Brush)、スタイル(Style)をXAMLの各要素に直接記述することは、「マジックナンバーをコードに散布する」ことと同義である。

非効率な設計(アンチパターン)

<!-- 各画面のあちこちに、同じような色が散らばっている -->
<Button Background="#007ACC" Foreground="White" FontSize="14" ... />
<TextBox BorderBrush="#007ACC" ... />

この設計では、ブランドカラーが変わった瞬間に、開発コストは指数関数的に増大する。

理想的な設計(プロフェッショナル)

リソースを「定義(Definition)」と「参照(Reference)」に分離せよ。
「何色か」を知っているのはリソースファイルだけであり、各コントロールは「どのリソースを使うか」だけを知っていればよい。これがSingle Source of Truth(信頼できる唯一の情報源)の原則だ。

2. 実践:モジュール化されたResourceDictionaryの構築

すべてのリソースを `App.xaml` に詰め込むのは三流の仕事だ。`App.xaml` は肥大化し、管理不能なモンスターへと化す。
リソースは「役割ごとにファイル分割」し、それを `App.xaml` で結合(Merge)するのが正解である。

ステップ1:カラーパレットの定義 (`Colors.xaml`)

まずは、アプリケーションの「色」だけを定義する辞書を作成する。

<!-- File: Resources/Colors.xaml -->
<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
                    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
    
    <!-- Primary Color Palette -->
    <Color x:Key="PrimaryColor">#007ACC</Color>
    <Color x:Key="SecondaryColor">#2D2D30</Color>
    <Color x:Key="SuccessColor">#28A745</Color>
    <Color x:Key="ErrorColor">#DC3545</Color>

    <!-- Brushes (Colorをそのまま使うのではなく、Brushとして定義するのが定石) -->
    <SolidColorBrush x:Key="PrimaryBrush" Color="{StaticResource PrimaryColor}" />
    <SolidColorBrush x:Key="SecondaryBrush" Color="{StaticResource SecondaryColor}" />
    <SolidColorBrush x:Key="SuccessBrush" Color="{StaticResource SuccessColor}" />
    <SolidColorBrush x:Key="ErrorBrush" Color="{StaticResource ErrorColor}" />
    
    <!-- Text Colors -->
    <SolidColorBrush x:Key="MainTextBrush" Color="White" />
    <SolidColorBrush x:Key="SubTextBrush" Color="#CCCCCC" />
</ResourceDictionary>

ステップ2:共通スタイルの定義 (`Styles.xaml`)

次に、色を用いた「見た目のルール」を定義する。

<!-- File: Resources/Styles.xaml -->
<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
                    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
    
    <!-- Colors.xamlで定義したリソースを参照する -->
    <!-- 注意: ファイルを分ける場合、Styles.xaml内でColors.xamlをMergedDictionariesで読み込む必要がある -->
    <ResourceDictionary.MergedDictionaries>
        <ResourceDictionary Source="Colors.xaml"/>
    </ResourceDictionary.MergedDictionaries>

    <!-- 標準的なボタンのスタイル -->
    <Style x:Key="ModernButtonStyle" TargetType="Button">
        <Setter Property="Background" Value="{StaticResource PrimaryBrush}" />
        <Setter Property="Foreground" Value="{StaticResource MainTextBrush}" />
        <Setter Property="Padding" Value="10,5" />
        <Setter Property="FontSize" Value="14" />
        <Setter Property="BorderThickness" Value="0" />
        <Setter Property="Cursor" Value="Hand" />
    </Style>

    <!-- 入力フィールドのスタイル -->
    <Style x:Key="ModernTextBoxStyle" TargetType="TextBox">
        <Setter Property="BorderBrush" Value="{StaticResource PrimaryBrush}" />
        <Setter Property="BorderThickness" Value="1" />
        <Setter Property="Padding" Value="5" />
    </Style>
</ResourceDictionary>

ステップ3:App.xaml での統合

最後に、これらをアプリケーション全体に適用する。

<!-- File: App.xaml -->
<Application x:Class="Application"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             StartupUri="MainWindow.xaml">
    <Application.Resources>
        <ResourceDictionary>
            <ResourceDictionary.MergedDictionaries>
                <!-- 階層構造を意識してマージする -->
                <ResourceDictionary Source="Resources/Styles.xaml" />
            </ResourceDictionary.MergedDictionaries>
        </ResourceDictionary>
    </Application.Resources>
</Application>

3. StaticResource vs DynamicResource:エンジニアの分かれ道

ここで、極めて重要な技術的判断を迫られる。リソースを参照する際、`{StaticResource}` と `{DynamicResource}` のどちらを使うべきか?

特徴 StaticResource DynamicResource
評価タイミング XAML読み込み時(一度きり) 実行時(必要になるたび)
パフォーマンス 極めて高い やや低い(オーバーヘッドあり)
動的変更 不可能(変更しても反映されない) 可能(実行中に見た目を変えられる)

アーキテクトの助言

  • 基本は `StaticResource` を使え。 アプリケーション起動中に色が変わる必要がないなら、パフォーマンスに優れるこちらを選択するのが鉄則だ。
  • 「ダークモード切り替え」などの要件がある場合のみ `DynamicResource` を使え。 全てを `DynamicResource` にするのは、無駄な計算リソースを消費する素人のやり方だ。

4. VB.NETによる動的なテーマ切り替えの実装

実務では、「ユーザーの設定に応じてライトモードとダークモードを切り替えたい」という要求が必ずと言っていいほど飛んでくる。これを実現する堅牢なコード例を示す。

テーマ切り替えのロジック

' File: ThemeManager.vb
Imports System.Windows

Public Module ThemeManager
    ''' <summary>
    ''' アプリケーションのテーマを動的に切り替える
    ''' </summary>
    ''' <param name="isDark">Trueでダークテーマ、Falseでライトテーマ</param>
    Public Sub SetTheme(isDark As Boolean)
        ' App.xamlのMergedDictionariesを取得
        Dim appResources = Application.Current.Resources.MergedDictionaries

        ' 現在適用されているテーマ用辞書を探す(例としてStyles.xamlを対象とする)
        ' 本来は、テーマ専用の辞書を別途管理するのがベストプラクティスだ
        Dim themeDictionary As ResourceDictionary = Nothing

        For Each dict In appResources
            ' ファイル名などで判定するロジック
            If dict.Source.ToString().Contains("Styles.xaml") Then
                themeDictionary = dict
                Exit For
            End If
        Next

        If themeDictionary IsNot Nothing Then
            ' 新しいテーマ辞書をロード(ここでは例としてパスを指定)
            ' 実際にはプロジェクトのビルドアクションを「Resource」に設定すること
            Dim newThemePath As String = If(isDark, "pack://application:,,,/Resources/DarkStyles.xaml", "pack://application:,,,/Resources/LightStyles.xaml")
            
            ' 既存のテーマ辞書を差し替える
            ' 注意: ここでDynamicResourceを使用しているコントロールだけが、即座に見た目を変える
            themeDictionary.MergedDictionaries.Clear()
            themeDictionary.MergedDictionaries.Add(New ResourceDictionary() With {.Source = New Uri(newThemePath)})
        End If
    End Sub
End Module

UI側での呼び出し

<!-- MainWindow.xaml -->
<StackPanel>
    <!-- DynamicResourceを使っているから、プログラムからの変更が反映される -->
    <Button Style="{StaticResource ModernButtonStyle}" 
            Content="テーマ切り替え" 
            Click="Button_Click" />
</StackPanel>
' MainWindow.xaml.vb
Private Sub Button_Click(sender As Object, e As RoutedEventArgs)
    ' ロジックに応じて切り替え
    ThemeManager.SetTheme(True)
End Sub

5. 結びに:堅牢な設計のためのチェックリスト

君が作成したWPFアプリが、真にプロフェッショナルなものであるために、デプロイ前に以下の項目を確認してほしい。

1. ハードコードの排除: `Background=”#FFFFFF”` のような記述がXAMLに残っていないか? すべてリソース経由になっているか?
2. 辞書の分離: `App.xaml` が数千行に及ぶ巨大なファイルになっていないか? 役割ごとに分割されているか?
3. 参照の最適化: 変更不要なリソースに `DynamicResource` を乱用していないか? (パフォーマンス低下の原因だ)
4. パスの整合性: `pack://application:,,,/` 形式のURIを使用し、リソースのロード失敗を防いでいるか?

デザインの変更は、コードの変更であってはならない。デザインの変更は、「データの変更」であるべきだ。この設計思想を脳に刻み込み、保守性の高い、真に価値のあるソフトウェアを構築してほしい。

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