【入門編】【初心者向け】VB.NETのWPFにおけるToolTipとAdornerの活用:操作ミスを防ぐ親切な入力ガイドとヘルプ表示 – Visual Basic (VB / VB.NET)解析バイブル

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

VBAの「自動化」から、WPFの「体験設計」へ。ユーザーを迷わせないToolTipとAdornerの極意

こんにちは。業務自動化の世界へようこそ。

Excelマクロ(VBA)からステップアップして、VB.NETによるWPF(Windows Presentation Foundation)の開発に足を踏み入れたあなた。今、少しだけ「難しさ」を感じていませんか?

「ボタンを置いて、値を入力して、処理を実行する」

VBAの世界ではこれで十分でした。しかし、業務システムが複雑になればなるほど、ユーザーは必ず「これ、何を入力すればいいんだっけ?」「間違えた時、何がダメだったのか教えてほしい」と、画面の前で立ち止まってしまいます。

プロのエンジニアとは、単にコードを書く人ではありません。ユーザーが迷う隙を与えない「体験」を作る人です。

今日は、WPFの強力な武器である「ToolTip(ツールチップ)」と「Adorner(アドーナ)」を使って、ユーザーの誤入力を未然に防ぎ、優しく導く「親切なUI」の構築術を伝授しましょう。ここをクリアすれば、あなたの作るアプリケーションの格は、一段階上に跳ね上がりますよ。

1. ToolTipの真価:ただの「説明文」で終わらせない

多くの初学者は、ToolTipを「マウスを乗せた時に出る、短いテキスト」だと思っています。確かにそれは正解ですが、それだけでは「プロのUI」とは言えません。

業務システムでは、「入力形式の例」や「注意書きのアイコン」を一緒に見せたい場面が多々あります。WPFの素晴らしい点は、ToolTipの中身に、画像やレイアウト(StackPanelなど)を自由に詰め込めることです。

実践:リッチなToolTipの構築

例えば、「商品コード(例:ABC-12345)」を入力させるTextBoxに、入力ルールを視覚的に伝えるToolTipを付けてみましょう。

# XAMLコード例

<!-- TextBoxにリッチなToolTipを埋め込む例 -->
<TextBox x:Name="txtProductCode" Width="200" Height="30" VerticalContentAlignment="Center">
    <TextBox.ToolTip>
        <StackPanel Orientation="Vertical">
            <!-- 見出し -->
            <TextBlock Text="【入力ルール】" FontWeight="Bold" Foreground="DarkBlue"/>
            <!-- 説明文 -->
            <TextBlock Text="英字3文字 + ハイフン + 数字5桁" TextWrapping="Wrap"/>
            <!-- 例示(ここが親切!) -->
            <TextBlock Text="例: ABC-12345" FontStyle="Italic" Foreground="Gray" Margin="0,5,0,0"/>
        </StackPanel>
    </TextBox.ToolTip>
</TextBox>

【ここがポイント!】
`ToolTip` プロパティの中に `StackPanel` を入れることで、複数の要素を縦に並べています。単なる文字列ではなく、「構造」を持たせることで、ユーザーの理解スピードは劇的に向上します。

2. Adorner(アドーナ)の魔法:要素を汚さずに「注釈」を添える

次に紹介するのは、少し高度ですが、使いこなすと感動される技術「Adorner(アドーナ)」です。

想像してみてください。ユーザーが間違った入力をしたとき、TextBoxの枠を赤くするだけでは不十分なことがあります。「どこが、どう間違っているのか」を、レイアウトを崩さずに、要素の「上」に重ねて表示したい。そんな時に使うのがAdornerです。

Adornerの概念:UIの「重ね着」

WPFの描画構造には「Visual Tree(視覚的ツリー)」という概念があります。Adornerは、通常のコントロールのレイアウト(大きさや位置)には一切干渉せず、その「さらに上のレイヤー」に描画される特殊な要素です。

「ボタンの横に、警告の赤いビックリマークを浮かび上がらせる」といった表現が、レイアウトを一切壊さずに実現できます。

実践:入力エラー時に「警告マーク」を表示するAdorner

それでは、エラー時にTextBoxの右側に「!」マークを表示するカスタムAdornerを作ってみましょう。

# VB.NETコード例(Adornerの定義)

Imports System.Windows.Media
Imports System.Windows.Documents

''' <summary>
''' 入力エラー時にコントロールの右上に「!」を表示するカスタムアドーナ
''' </summary>
Public Class ErrorWarningAdorner
    Inherits Adorner

    Private _adornedElement As UIElement

    Public Sub New(element As UIElement)
        MyBase.New(element)
        _adornedElement = element
    End Sub

    ''' <summary>
    ''' 描画処理:ここがアドーナの心臓部です
    ''' </summary>
    Protected Overrides Sub OnRender(drawingContext As DrawingContext)
        MyBase.OnRender(drawingContext)

        ' 1. 描画する色とフォントの設定
        Dim redBrush As New SolidColorBrush(Colors.Red)
        Dim fontSize As Double = 16

        ' 2. 描画位置の計算(コントロールの右上)
        ' AdornorLayerは、対象要素の座標系を基準にしています
        Dim x As Double = _adornedElement.RenderSize.Width - 20
        Dim y As Double = 0

        ' 3. 描画実行:赤い「!」を描く
        ' 文字列を直接描画する手法(簡易版)
        Dim formattedText As New FormattedText(
            "!",
            System.Globalization.CultureInfo.CurrentCulture,
            FlowDirection.LeftToRight,
            New Typeface("Segoe UI"),
            fontSize,
            redBrush,
            VisualTreeHelper.GetDpi(_adornedElement).PixelsPerDip)

        ' 描画位置へ描画
        drawingContext.DrawText(formattedText, New Point(x, y))
    End Sub
End Class

# VB.NETコード例(呼び出し側:MainWindow.xaml.vb)

Class MainWindow
    ' エラー表示用の管理変数
    Private _warningAdorner As ErrorWarningAdorner

    ''' <summary>
    ''' 入力チェックのロジック
    ''' </summary>
    Private Sub txtProductCode_TextChanged(sender As Object, e As TextChangedEventArgs) Handles txtProductCode.TextChanged
        Dim tb As TextBox = DirectCast(sender, TextBox)
        
        ' 簡易的なバリデーション(例:5文字未満はエラーとする)
        If tb.Text.Length > 0 AndAlso tb.Text.Length < 5 Then
            ShowWarning(tb)
        Else
            HideWarning(tb)
        End If
    End Sub

    ''' <summary>
    ''' アドーナを表示する
    ''' </summary>
    Private Sub ShowWarning(element As UIElement)
        ' すでに表示されている場合は何もしない
        If _warningAdorner IsNot Nothing Then Return

        ' AdornerLayerを取得して、アドーナを追加する
        Dim layer As AdornerLayer = AdornerLayer.GetAdornerLayer(element)
        If layer IsNot Nothing Then
            _warningAdorner = New ErrorWarningAdorner(element)
            layer.Add(_warningAdorner)
        End If
    End Sub

    ''' <summary>
    ''' アドーナを非表示にする
    ''' </summary>
    Private Sub HideWarning(element As UIElement)
        If _warningAdorner IsNot Nothing Then
            Dim layer As AdornerLayer = AdornerLayer.GetAdornerLayer(element)
            layer.Remove(_warningAdorner)
            _warningAdorner = Nothing
        End If
    End Sub
End Class

3. 陥りやすいエラーと、プロの回避策

ここまで学んだあなたに、私が現場で何度も見てきた「落とし穴」を教えておきましょう。

① AdornerLayer が取得できない問題

`AdornerLayer.GetAdornerLayer(element)` を呼び出したとき、戻り値が `Nothing` になることがあります。これは、その要素がまだ Visual Tree に完全に組み込まれていない(Windowが表示される前など) 場合に起こります。

  • 対策: `Loaded` イベント以降で実行するか、要素が確実に表示されていることを確認してから呼び出しましょう。

② パフォーマンスの低下

Adornerは `OnRender` メソッド内で描画を行います。ここで複雑すぎる計算や、重い画像の読み込みを行うと、ユーザーが文字を入力するたびに画面がカクついてしまいます。

  • 対策: `OnRender` は「描画するだけ」に徹してください。計算やデータの準備は、事前に済ませておくのが鉄則です。

まとめ:コードの向こう側にいる「人」を見よう

いかがでしたか?

  • ToolTip は、情報の「密度」と「見せ方」を工夫することで、強力なガイドになる。
  • Adorner は、レイアウトを壊さずに「視覚的な警告」を重ねることができる。

VBAの時代は「正しく動くこと」がゴールでした。しかし、VB.NETとWPFを武器にするこれからのあなたは、「ユーザーがいかに迷わず、心地よく業務を完了できるか」という、設計の視点を持つことができます。

最初は、Adornerの座標計算や描画ロジックに戸惑うかもしれません。でも大丈夫。一つずつコードの意味を紐解いていけば、必ずあなたの意図通りに画面を操れるようになります。

ここをクリアすれば、Visual Basic (VB.NET) の基本はバッチリですよ。
さあ、次はもっと素晴らしいUIを作りにいきましょう!応援しています。

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