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

サンプルコード

概要説明 

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

親切機能ですね。

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

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

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

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

 

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

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

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

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

 

サンプルの内容

①上段テキストボックス

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

 

②中段テキストボックス

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

 

③下段テキストボックス

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

 

④ボタン

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

 

使用部品

No項目名Textname部品
1上段(入力欄)textBox1TextBox
2中段(入力欄)textBox2TextBox
3下段(入力欄)textBox3TextBox
4HELP ON/OFFボタンbutton1button1Button

プログラミング

言語: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;
            }
        }
    }
}

実行結果

上段のツールヒントが表示されます。

中段のツールヒントが表示されます。

下段のツールヒントが表示されます。

ボタンのツールヒントが表示されます。

「HELP OFF」をクリックします。

「HELP ON」をクリックするとが表示されます。

「?」が消え、最小化、最大化ボタンが表示されます。

以上です

コメント

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