WPFにおける「真の」UI部品設計：CustomControlによるロジックとデザインの完全分離
多くの開発者が、WPF（Windows Presentation Foundation）におけるUI構築において、致命的な設計ミスを犯している。
彼らは、新しいUI部品が必要になると、安易に `UserControl` を選択する。しかし、これは「部品の再利用」という観点から見れば、極めて不完全なアプローチだ。`UserControl` はロジックとビジュアルが密結合（Tight Coupling）されており、デザインの変更やスタイルの適用に対して極めて脆弱である。
プロフェッショナルが求めるのは、Custom Control（カスタムコントロール） である。
本稿では、ロジックとデザインを完全に分離する「Lookless Control」の設計思想に基づき、VB.NETを用いた高度なカスタムコントロールの実装手法を詳解する。これは、単なるUI制作のテクニックではない。大規模システムにおける保守性と、メモリ効率を極限まで高めるためのアーキテクチャ設計の講義である。
1. UserControl と Custom Control の決定的な境界線
まず、設計思想の整理から始めよう。なぜ `UserControl` ではいけないのか。
- UserControl: 既存のコントロールを組み合わせて「一つの塊」を作る。ビジュアル（XAML）とロジック（Code-behind）が一体化しているため、外部から「見た目だけを変える」ことが困難である。
- Custom Control: コントロールの「振る舞い（Behavior）」のみを定義し、見た目は `Generic.xaml` という外部のテンプレートに委ねる。これにより、同一のロジックを持ちながら、アプリケーションのテーマに応じて全く異なる外見を持つことが可能になる。
大規模なエンタープライズ・システムにおいて、ブランド変更やダークモード対応、あるいはデバイスごとのUI最適化を要求された際、`UserControl` ベースの設計は破綻する。一方で、`Custom Control` はテンプレートを差し替えるだけで、ロジックを一切汚染することなく対応できる。
2. 実装フェーズ：ロジックの定義（VB.NET）
ここでは、特定のステータス（例：稼働中、警告、停止）に応じて色や挙動が変わる、`StatusIndicator` というカスタムコントロールを設計する。
重要なのは、Dependency Property（依存関係プロパティ） の適切な実装である。これにより、WPFの強力なデータバインディングとアニメーションの恩恵を享受できる。
Imports System.Windows
Imports System.Windows.Controls
''' <summary>
''' ステータスを表示するためのカスタムコントロール。
''' ロジックのみを定義し、見た目はテンプレートに依存する。
''' </summary>
Public Class StatusIndicator
Inherits Control
' DependencyProperty の登録。
' これにより、XAMLからのバインディングやアニメーションが可能になる。
Public Shared ReadOnly StatusColorProperty As DependencyProperty =
DependencyProperty.Register(
"StatusColor",
GetType(Brush),
GetType(StatusIndicator),
New PropertyMetadata(Brushes.Gray))
''' <summary>
''' ステータスに応じて変化する色。
''' </summary>
Public Property StatusColor As Brush
Get
Return DirectCast(GetValue(StatusColorProperty), Brush)
End Get
Set(value As Brush)
SetValue(StatusColorProperty, value)
End Set
End Property
' コンストラクタ
Public Sub New()
MyBase.New()
' 極めて重要：このコントロールのデフォルトスタイルが
' Generic.xaml にあることをWPFのエンジンに通知する。
SetStyleKey(GetType(StatusIndicator))
End Sub
''' <summary>
''' コントロールのライフサイクルにおけるメモリ管理。
''' 複雑なリソースを使用する場合、Unloadedイベント等で明示的な解放を行う。
''' </summary>
Protected Overrides Sub OnUnloaded(e As RoutedEventArgs)
MyBase.OnUnloaded(e)
' ここで、外部へのイベント購読解除や、
' Win32 APIで確保したハンドル等のクリーンアップを行う。
End Sub
End Classアーキテクトの視点：`SetStyleKey` の意味
`SetStyleKey(GetType(StatusIndicator))` を呼び出すことは、このコントロールに「魂（ロジック）」を与えつつ、「肉体（ビジュアル）」を `Generic.xaml` に探しに行かせるための宣言である。これを忘れると、コントロールは画面上に存在しても、何も描画されない「幽霊」となる。
3. デザインフェーズ：テンプレートの分離（XAML）
次に、デザインを定義する。カスタムコントロールのビジュアルは、プロジェクト内の `Themes/Generic.xaml` に配置しなければならない。これはWPFの規約である。
<ResourceDictionary
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local="clr-namespace:YourNamespace.Controls">
<!-- StatusIndicator のデフォルトスタイル定義 -->
<Style TargetType="{x:Type local:StatusIndicator}">
<Setter Property="Template">
<Setter.Value>
<ControlTemplate TargetType="{x:Type local:StatusIndicator}">
<!--
TemplateBinding を使用することで、
VB.NET側で定義した DependencyProperty と
XAMLのビジュアル要素を高速に、かつ低メモリ負荷で結合する。
-->
<Grid>
<Ellipse x:Name="PART_IndicatorCircle"
Fill="{TemplateBinding StatusColor}"
Width="20" Height="20"
Stroke="Black" StrokeThickness="1" />
<ContentPresenter HorizontalAlignment="Center"
VerticalAlignment="Center"
Margin="25,0,0,0" />
</Grid>
</ControlTemplate>
</Setter.Value>
</Setter>
</Style>
</ResourceDictionary>パフォーマンスの極意：`TemplateBinding`
ここで `Binding` ではなく `TemplateBinding` を使用している点に注目せよ。`TemplateBinding` は、通常の `Binding` よりも軽量な評価メカニズムを持つ。カスタムコントロールの内部で大量のプロパティをバインドする場合、この微細な差が、描画スレッドの負荷軽減、ひいてはアプリケーションの応答性に直結する。
4. 極限の知見：Windows API との融合とメモリ最適化
実務において、カスタムコントロールは単なる描画部品に留まらない。レガシーなWin32システムと連携する場合、コントロール内で P/Invoke（Windows APIの呼び出し） が必要になることがある。
例えば、コントロールが特定のウィンドウハンドル（HWND）のフォーカス状態を監視する必要がある場合、以下の点に細心の注意を払わなければならない。
メモリリークの回避：Managed/Unmanaged の境界
Win32 APIを使用してハンドルを取得したり、フックをかけたりする場合、WPFのガベージコレクタ（GC）は、そのアンマネージド・リソースの生存期間を把握できない。
' Win32 APIの宣言例
<System.Runtime.InteropServices.DllImport("user32.dll")>
Private Shared Function GetForegroundWindow() As IntPtr
End Function
' カスタムコントロール内での実装イメージ
Protected Overrides Sub OnApplyTemplate()
MyBase.OnApplyTemplate()
' テンプレート適用時に、Win32 APIに関連するリソースを初期化
' 例: ウィンドウの通知受信などの設定
End Sub
Protected Overrides Sub OnDetachedFromVisualTree(e As DependencyPropertyChangedEventArgs)
' 視覚ツリーから切り離された際、必ずアンマネージド・リソースを解放する。
' これを怠ると、コントロールを閉じるたびにメモリがリークし、
' 長時間稼働する監視システムでは致命的なクラッシュを招く。
ReleaseUnmanagedResources()
MyBase.OnDetachedFromVisualTree(e)
End Subシステム間連携における「重み」
カスタムコントロール内で `HwndSource` を介して `HWND` を操作する場合、そのコントロールのライフサイクル（`OnLoaded` / `OnUnloaded`）と、Win32のメッセージループの同期を完璧に制御せよ。不適切なタイミングでの API 呼び出しは、デッドロックや、WPFのレンダリングスレッドを停止させる原因となる。
結論：エンジニアリングとしてのUI構築
カスタムコントロールの自作は、単に「見た目を凝る」ための手段ではない。それは、「変化に対して強固な、疎結合なアーキテクチャを構築する」 という設計思想の体現である。
1. ロジック（VB.NET） は、データと振る舞いに専念する。
2. デザイン（XAML） は、表現に専念する。
3. リソース管理（Lifecycle） は、システムの安定性に専念する。
この三原則を遵守することで、君が構築するシステムは、数年後の保守フェーズにおいても、レガシーな呪縛に陥ることなく、洗練された品質を保ち続けることができるだろう。
技術の真髄は、コードの量ではなく、その設計の「密度」にある。
