C# ヘルプのツールヒントテキストを表示する（HelpProvider）

2020.12.142022.09.23

C# サンプルプログラム一覧

HelpProviderを使うとコントロールに説明（ツールヒント）を設定できます。

親切機能ですね。

ちなみに、この機能は画面の最小化・最大化をOFFにしないと使えません。

最小化と最大化をONにすると「？」は消えます。

これを利用して「？」と最小化・最大化を切り替えるボタンをつけてみました。

このようなサンプルです。

ツールヒントはこんな感じの機能です。　　

画面右上「？」をクリックします。

ヘルプを見たいコントロールまで移動してクリックします。

するとコントロールに設定されたツールヒントが表示されます。

サンプルの内容

①上段テキストボックス

　ツールヒントに「ここには、生年月日を入力して下さい。」を表示します。

②中段テキストボックス

ツールヒントに「ここには、趣味をを入力して下さい。」を表示します。

③下段テキストボックス

ツールヒントに「ここには、好きな食べ物を入力して下さい。」を表示します。

④ボタン

ツールヒントに「このボタンは、HELPボタンの表示/非表示を切り替えます。」を表示します。

使用部品

No	項目名	Text	name	部品
1	上段（入力欄）	空	textBox1	TextBox
2	中段（入力欄）	空	textBox2	TextBox
3	下段（入力欄）	空	textBox3	TextBox
4	HELP ON/OFFボタン	button1	button1	Button

プログラミング

言語：C#

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;

namespace WindowsFormsApp23
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }

        /// <summary>
        /// 画面起動時処理
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void Form1_Load(object sender, EventArgs e)
        {
            HelpProvider helpProvider = new HelpProvider();

            // 最小化、最大化ボタンを無効にする
            button1.Text = "HELP OFF";
            this.MinimizeBox = false;
            this.MaximizeBox = false;

            // ヘルプボタンを表示する
            this.HelpButton = true;

            // textBox1にヘルプのツールヒントを設定する
            helpProvider.SetHelpString(textBox1, "これが、ヘルプのツールヒントテキストです！");

            // textBox2にヘルプのツールヒントを設定する
            helpProvider.SetHelpString(textBox2, "ここには、趣味をを入力して下さい。");

            // textBox3にヘルプのツールヒントを設定する
            helpProvider.SetHelpString(textBox3, "ここには、好きな食べ物を入力して下さい。");

            // button1にヘルプのツールヒントを設定する
            helpProvider.SetHelpString(button1, "このボタンは、HELPボタンの表示/非表示を切り替えます。");

        }

        /// <summary>
        /// HELP ON/OFFボタン
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void button1_Click(object sender, EventArgs e)
        {
            if (this.MinimizeBox)
            {
                // 
                button1.Text = "HELP OFF";
                this.MinimizeBox = false;
                this.MaximizeBox = false;
            }
            else {
                button1.Text = "HELP ON";
                this.MinimizeBox = true;
                this.MaximizeBox = true;
            }
        }
    }
}