【入門編】【中級者・実務】VB.NETのWPFで実現する複数画面(マルチウィンドウ)管理:親画面と子画面間のデータ授受とライフサイクル制御 – Visual Basic (VB / VB.NET)解析バイブル

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

WPFの迷宮を抜けて:VB.NETで実現する「美しい」マルチウィンドウ管理術

こんにちは。プログラミングの旅を楽しんでいますか?

マクロや簡単なスクリプトから一歩踏み出し、WPF(Windows Presentation Foundation)を使って「ちゃんとした業務アプリケーション」を作ろうとすると、必ずと言っていいほど直面する壁があります。

それが、「画面(ウィンドウ)の管理」です。

「設定画面を開いて、入力された値をメイン画面に返したい」
「サブツールを、メイン画面とは別に自由に動かせるようにしたい」

これらを、なんとなく「動けばいいや」という書き方で実装してしまうと、すぐにコードはスパゲッティのように絡まり、メモリリーク(メモリの無駄遣い)や、予期せぬエラーの温床となってしまいます。

今日は、伝説的なアーキテクトの視点から、「安全で、メンテナンスしやすく、プロフェッショナルな」複数画面の管理手法を伝授しましょう。ここをクリアすれば、あなたのVB.NETスキルは「ツール作成者」から「アプリケーションエンジニア」へと進化しますよ。

1. そもそも「ウィンドウの制御」には2つの型がある

WPFの世界には、大きく分けて2つのウィンドウ表示スタイルがあります。この違いを理解することが、設計の第一歩です。

スタイル メソッド 特徴 主な用途
モーダル (Modal) `ShowDialog()` 開いている間、親画面の操作をブロックする。 設定画面、確認ダイアログ
モードレス (Modeless) `Show()` 親画面を操作しながら、同時に使える。 ツールパレット、ログ表示窓

これらを「どうやってデータをやり取りするか」という観点で見ていきましょう。

2. 【モーダル設計】イベント駆動で「スマートに」値を返す

設定画面などのモーダルウィンドウでは、よく「子画面のテキストボックスの値を、親画面の変数に直接代入する」という書き方をしてしまいがちです。

これは、やってはいけません。

なぜなら、親画面が子画面の内部構造(どのテキストボックスに何が入っているか)を知りすぎているからです。これでは、子画面のデザインを変えただけで親画面まで壊れてしまいます。

これを解決するのが「イベント(Event)」という仕組みです。

実装例:設定画面から設定値を親に伝える

# 【子画面】SettingWindow.xaml.vb

子画面は「自分が何をしたか」を叫ぶ(RaiseEvent)だけで、相手が誰かは気にしません。

Public Class SettingWindow
    ' 1. データを親に伝えるための「イベント」を定義します
    ' これが「私は準備ができました!」という合図になります
    Public Event SettingsConfirmed(ByVal newName As String)

    ''' <summary>
    ''' OKボタンが押された時の処理
    ''' </summary>
    Private Sub BtnOk_Click(sender As Object, e As RoutedEventArgs) Handles BtnOk.Click
        ' 2. 入力された値をイベントに乗せて、外の世界(親)へ放り投げます
        ' 直接親の変数に書き込むのではなく、イベントを発生させるのがコツです
        Dim resultValue As String = txtInput.Text
        RaiseEvent SettingsConfirmed(resultValue)

        ' 3. ウィンドウを閉じます
        Me.DialogResult = True ' DialogResultをTrueにすると、ShowDialog()の戻り値がTrueになります
        Me.Close()
    End Sub

    Private Sub BtnCancel_Click(sender As Object, e As RoutedEventArgs) Handles BtnCancel.Click
        ' キャンセル時はFalseを返して終了
        Me.DialogResult = False
        Me.Close()
    End Sub
End Class

# 【親画面】MainWindow.xaml.vb

親画面は、子画面の「叫び(イベント)」を待ち構えておくだけです。

Public Class MainWindow
    Private Sub BtnOpenSetting_Click(sender As Object, e As RoutedEventArgs) Handles BtnOpenSetting.Click
        ' 4. 子画面のインスタンスを作成
        Dim subWindow As New SettingWindow()

        ' 5. 【重要】イベントハンドラを接続します
        ' 「subWindowでSettingsConfirmedが発生したら、MyHandlerメソッドを実行せよ」という約束です
        AddHandler subWindow.SettingsConfirmed, AddressOf MySettingsHandler

        ' 6. モーダル表示
        ' ShowDialogは、ウィンドウが閉じられるまでここで処理を止めます
        Dim result As Boolean = subWindow.ShowDialog()

        ' 7. 後片付け
        ' AddHandlerした場合は、念のためRemoveHandlerしておくと安全です
        RemoveHandler subWindow.SettingsConfirmed, AddressOf MySettingsHandler

        If result = True Then
            lblStatus.Content = "設定が更新されました。"
        Else
            lblStatus.Content = "キャンセルされました。"
        End If
    End Sub

    ''' <summary>
    ''' 子画面からイベントが飛んできた時に呼ばれるメソッド
    ''' </summary>
    Private Sub MySettingsHandler(ByVal newName As String)
        ' 子画面から受け取った値を使って、自身のUIを更新する
        txtMainDisplay.Text = newName
    End Sub
End Class

💡 アーキテクトの知恵:
`AddHandler` を使うことで、親と子の結合度(Dependency)を極限まで下げることができます。これにより、子画面を単体テストすることも、別のプロジェクトで再利用することも容易になります。

3. 【モードレス設計】インスタンスの「重複」を防ぐ

モードレス(`Show()`)の場合、ボタンを押すたびに新しいウィンドウが開いてしまう、というミスがよく起こります。

「サブツール」のような画面は、「既に開いていたら、そのウィンドウを最前面に持ってくる」という挙動が理想的です。これを実現するには、インスタンスをクラスレベルで保持(管理)する必要があります。

実装例:シングルトン的な管理

# 【親画面】MainWindow.xaml.vb

Public Class MainWindow
    ' 1. 子画面のインスタンスを保持するための変数を用意します
    ' これにより、同じウィンドウが何度も作られるのを防ぎます
    Private _subToolWindow As SubToolWindow = Nothing

    Private Sub BtnOpenTool_Click(sender As Object, e As RoutedEventArgs) Handles BtnOpenTool.Click
        ' 2. ウィンドウがまだ存在しない(Nothing)、または既に閉じられているかチェック
        If _subToolWindow Is Nothing OrElse Not _subToolWindow.IsLoaded Then
            
            ' インスタンスを新規作成
            _subToolWindow = New SubToolWindow()
            
            ' 子画面が閉じられた時に、変数の中身をNothingに戻すための処理
            AddHandler _subToolWindow.Closed, Sub(s, ev) _subToolWindow = Nothing
            
            ' モードレス表示
            _subToolWindow.Show()
            
        Else
            ' 3. 既に開いている場合は、そのウィンドウをアクティブにする
            _subToolWindow.Activate()
            _subToolWindow.Focus()
        End If
    End Sub
End Class

💡 アーキテクトの知恵:
モードレスウィンドウでは、`IsLoaded` プロパティをチェックするのがポイントです。インスタンス自体は残っていても、ユーザーが「×」ボタンで閉じた場合、`IsLoaded` は `False` になります。これを見逃すと、「ウィンドウが表示されないのに、内部ではインスタンスが生き残っている」という幽霊のような状態を招いてしまいます。

4. まとめ:プロの設計思想

今回学んだことを整理しましょう。

1. モーダル(ShowDialog)の鉄則

  • データは「コンストラクタ」で渡し、結果は「イベント」で受け取る。
  • 親は子の内部(コントロール名など)を直接触らない。

2. モードレス(Show)の鉄則

  • インスタンスを親側で保持し、「二重起動」を防ぐ。
  • `Closed` イベントを利用して、インスタンスの状態を適切に管理する。

プログラミングにおいて、最もコストがかかるのは「動かなくなった後の修正」です。
今回のような「オブジェクトのライフサイクル(いつ生まれ、いつ死ぬか)」と「情報の流れ(イベント)」を意識した設計を行えば、あなたの作るアプリケーションは驚くほど堅牢で、美しくなります。

一歩ずつ、確実に。
ここをマスターすれば、Visual Basicでの開発はもっと自由で、もっと楽しいものになりますよ。応援しています!

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