【実務・中級編】【初心者向け】VB.NETのWPFアプリにおけるTabControlの動的タブ追加と閉じるボタン付きタブの実装手法 – Visual Basic (VB / VB.NET)解析バイブル

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

「ただのタブ」で終わらせるな。VB.NET/WPFにおける動的タブ管理の極意と、破綻しない設計思想

業務自動化ツールの開発において、ユーザーが「複数の業務ドキュメント」や「異なる設定画面」を並行して操作するシーンは多々ある。その際、避けて通れないのがTabControlの実装だ。

しかし、多くの初学者が陥る罠がある。それは、「コードビハインド(MainWindow.xaml.vb)から直接 `TabItem` を生成して追加する」という、極めて保守性の低い実装だ。

このような「UI要素を直接操作する」設計は、小規模なツールなら動くかもしれない。しかし、プロジェクトが拡大し、タブごとに保持すべきデータや、開いているファイルへのアクセス権、データベースのトランザクション管理が必要になった瞬間、そのコードは巨大なスパゲッティと化し、メモリリークの温床となる。

本記事では、プロフェッショナルが実践するMVVM(Model-View-ViewModel)パターンに基づいた、堅牢で拡張性の高い「動的タブ追加・削除機能」の実装手法を伝授する。

1. 根本的な設計思想:UIではなく「データ」を操作せよ

まず、マインドセットを切り替えよう。
WPFにおける真のマスターは、`TabItem` という「箱」を操作しない。「タブが表すべきデータ(ViewModel)」を操作する。

  • NGなアプローチ: `TabControl.Items.Add(New TabItem())` を呼び出す。
  • プロのアプローチ: `ObservableCollection(Of TabViewModel).Add(New TabViewModel())` を実行する。

UI(TabItem)は、データの状態に応じてWPFの強力なデータバインディング機能によって「自動的に」生成されるべきものだ。これが、バグの起きない設計の第一歩である。

2. 実装の設計図

以下の構成で実装を進める。

1. `TabContentViewModel`: 各タブが持つ固有のデータ(タイトルや中身のコンテンツ)を管理する。
2. `MainViewModel`: タブのリスト(`ObservableCollection`)を保持し、追加・削除のロジックを司る。
3. `RelayCommand`: View(ボタン)からの操作をViewModelに伝えるための橋渡し役。
4. `XAML (View)`: `HeaderTemplate` を使い、タブのヘッダー部分に「閉じるボタン」を組み込む。

3. プロダクションコード例

それでは、実際に動作するコードを実装していく。

3.1. コマンドの実装 (RelayCommand.vb)

MVVMにおいて、ボタンクリックなどのイベントをViewModelで受け取るために不可欠なクラスだ。

Imports System.Windows.Input

''' <summary>
''' Viewからの入力をViewModelで処理するための汎用コマンドクラス
''' </summary>
Public Class RelayCommand
    Implements ICommand

    Private ReadOnly _execute As Action(Of Object)
    Private ReadOnly _canExecute As Predicate(Of Object)

    Public Sub New(execute As Action(Of Object), Optional canExecute As Predicate(Of Object) = Nothing)
        _execute = execute
        _canExecute = canExecute
    End Sub

    Public Function CanExecute(parameter As Object) As Boolean Implements ICommand.CanExecute
        Return If(_canExecute, Function(p) True)(parameter)
    End Function

    Public Sub Execute(parameter As Object) Implements ICommand.Execute
        _execute(parameter)
    End Sub

    Public Event CanExecuteChanged Implements ICommand.CanExecuteChanged
        AddHandler(value)
            CommandManager.RequerySuggested += AddHandler
        End Sub
        RemoveHandler(value)
            CommandManager.RequerySuggested -= RemoveHandler
        End Sub
    End Class
End Class

3.2. タブごとのデータ管理 (TabContentViewModel.vb)

ここが重要だ。タブを閉じる際、ここで「リソースの解放」を行う。

Imports System.ComponentModel

''' <summary>
''' 各タブが保持するデータモデル
''' </summary>
Public Class TabContentViewModel
    Implements INotifyPropertyChanged

    Private _title As String
    Public Property Content As Object ' ここに実際の画面(UserControl等)を格納する

    Public Property Title As String
        Get
            Return _title
        End Get
        Set(value As String)
            _title = value
            OnPropertyChanged(NameOf(Title))
        End Set
    End Property

    Public Event PropertyChanged As PropertyChangedEventHandler Implements INotifyPropertyChanged.PropertyChanged

    Protected Sub OnPropertyChanged(propertyName As String)
        RaiseEvent PropertyChanged(propertyName, New PropertyChangedEventArgs(propertyName))
    End Sub

    ''' <summary>
    ''' タブが破棄される際に呼び出すクリーンアップ処理
    ''' </summary>
    Public Sub Dispose()
        ' TODO: ファイルハンドル、DB接続、イベント購読の解除をここで行う
        ' 例: If TypeOf Content Is IDisposable Then DirectCast(Content, IDisposable).Dispose()
        Debug.WriteLine($"Tab '{Title}' has been disposed.")
    End Sub
End Class

3.3. メインロジック (MainViewModel.vb)

Imports System.Collections.ObjectModel
Imports System.Windows.Input

''' <summary>
''' アプリケーション全体の状態を管理するViewModel
''' </summary>
Public Class MainViewModel
    ' タブのリスト。これに要素を追加・削除すると、UIが自動で追従する
    Public Property Tabs As ObservableCollection(Of TabContentViewModel)

    ' タブ追加コマンド
    Public Property AddTabCommand As ICommand
    ' タブ削除コマンド
    Public Property RemoveTabCommand As ICommand

    Public Sub New()
        Tabs = New ObservableCollection(Of TabContentViewModel)()

        ' コマンドの初期化
        AddTabCommand = New RelayCommand(AddressOf ExecuteAddTab)
        RemoveTabCommand = New RelayCommand(AddressOf ExecuteRemoveTab)
    End Sub

    Private Sub ExecuteAddTab(parameter As Object)
        Dim newId As Integer = Tabs.Count + 1
        ' 新しいタブ用のViewModelを作成してリストに追加
        ' 本来はここで、ファイルを開くなどのロジックを挟む
        Tabs.Add(New TabContentViewModel With {
            .Title = $"業務画面 {newId}",
            .Content = New System.Windows.Controls.TextBlock With {.Text = $"これが {newId} 番目のコンテンツです。"}
        })
    End Sub

    Private Sub ExecuteRemoveTab(parameter As Object)
        Dim target = TryCast(parameter, TabContentViewModel)
        If target IsNot Nothing Then
            ' リソースの解放を確実に行う
            target.Dispose()
            ' リストから削除(これだけでUIからも消える)
            Tabs.Remove(target)
        End If
    End Sub
End Class

3.4. UI定義 (MainWindow.xaml)

`HeaderTemplate` を使うのが、プロフェッショナルな見た目を作るコツだ。

<Window x:Class="MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="Modern Tab Management" Height="450" Width="800">
    
    <Grid>
        <Grid.RowDefinitions>
            <RowDefinition Height="Auto"/>
            <RowDefinition Height="*"/>
        </Grid.RowDefinitions>

        <!-- タブ追加ボタン -->
        <Button Content="新規タブを開く" Command="{Binding AddTabCommand}" 
                Margin="10" Padding="10,5" HorizontalAlignment="Left"/>

        <TabControl Grid.Row="1" ItemsSource="{Binding Tabs}">
            <!-- 1. タブのヘッダー部分のカスタマイズ -->
            <TabControl.ItemTemplate>
                <DataTemplate>
                    <StackPanel Orientation="Horizontal">
                        <TextBlock Text="{Binding Title}" VerticalAlignment="Center" Margin="0,0,5,0"/>
                        <!-- 閉じるボタン。CommandParameterに自分自身(このTabContentViewModel)を渡すのが肝 -->
                        <Button Content="×" 
                                Command="{Binding DataContext.RemoveTabCommand, RelativeSource={RelativeSource AncestorType=TabControl}}"
                                CommandParameter="{Binding}"
                                Background="Transparent" BorderThickness="0" Foreground="Red" FontWeight="Bold" Cursor="Hand"/>
                    </StackPanel>
                </DataTemplate>
            </TabControl.ItemTemplate>

            <!-- 2. タブの中身(コンテンツ)の表示方法 -->
            <TabControl.ContentTemplate>
                <DataTemplate>
                    <ContentControl Content="{Binding Content}"/>
                </DataTemplate>
            </TabControl.ContentTemplate>
        </TabControl>
    </Grid>
</Window>

4. 実務における致命的な落とし穴と対策

コードが動いたからといって安心しないでほしい。業務アプリとしてリリースする場合、以下の3点に必ず留意せよ。

① リソースリークの防止(ライフサイクル管理)

タブを閉じたとき、単にUIから消えるだけでは不十分だ。もしそのタブが「Excelファイル」や「SQL Serverへの接続」を保持していた場合、UIを消してもメモリやファイルハンドルは掴んだままになる。
必ず、先ほどの例のように `Dispose` メソッドを設計し、`RemoveTabCommand` 内で明示的にクリーンアップ処理を走らせること。

② 「未保存」状態のハンドリング

ユーザーがデータを編集中のタブを「×」で閉じてしまった場合、データが消失する。
実務的な設計では、`TabContentViewModel` に `IsDirty`(変更あり)フラグを持たせ、`RemoveTabCommand` の `CanExecute` で「変更がある場合は警告ダイアログを出す」というロジックを挟むべきだ。

③ UIスレッドのブロッキング

タブの追加時に、重いDB検索やファイル読み込みを行う場合、そのまま実行するとUIがフリーズする。
`ExecuteAddTab` 内では、`Task.Run` を用いて非同期処理を行い、完了後に `Dispatcher` を介して `ObservableCollection` を更新する設計に昇華させよ。

結論

WPFにおける動的タブの実装は、単なる「UI操作」ではない。それは「データのライフサイクルを制御する設計」そのものだ。

`TabControl.Items.Add` を卒業し、`ObservableCollection` と `DataTemplate` を使いこなすこと。これが、メンテナンスコストを最小限に抑え、ユーザーに信頼されるプロフェッショナルな業務ツールを構築するための、唯一の道である。

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