آموزش برنامه نویسی

کنترل HelpProvider

از کنترل HelpProvider، برای نمایش راهنمای آنلاین استفاده می‌شود. اگر کاربر دکمه F1 را بفشارد، این کنترل، اطلاعات فایل راهنما را نشان می‌دهد. این کنترل دارای خاصیتی به نام HelpNameSpace می‌باشد. این خاصیت نام فایلی را مشخص می‌کند که باید با زدن دکمه F1 نمایش داده شود. فرض کنید که یک فایل با نام help.html و محتویات زیر در درایو E قرار داده‌ایم و این فایل همان فایل راهنمای ما است :

<h1>HelpProvider</h1>

<p>HelpProvider control provides popup or online help for a control.</p>

برای استفاده از این فایل ابتدا یک کنترل HelpProvider بر روی برنامه قرار دهید :

سپس با زدن دکمه F7 کد زیر را در سازنده کلاس برنامه‌تان بنویسید :

using System.Windows.Forms;

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

            helpProvider1.HelpNamespace = @"E:\help.html";
            helpProvider1.SetShowHelp(this, true);        
        }
    }
}

حال برنامه را اجرا کرده و دکمه F1 را بزنید :

همانطور که در شکل بالا مشاهده می‌کنید، با زدن دکمه F1 مرورگر باز شده و محتویات فایلی help.html را، نمایش می‌دهد. گاهی اوقات ممکن است که بخواهید برای یک کنترل نیز یک متن توضیحی قرار دهید که نشان دهنده عملکرد آن باشد. برای این کار از متد ()SetHelpString استفاده می‌شود. برای کار با این متد باید دکمه Help فعال باشد. برای فعال کردن دکمه Help هم باید دکمه‌های Maximize و Minimaize غیر فعال شوند. یک کنترل textBox بر روی فرم قرار داده و تغییرات زیر را اعمال کنید :

سپس کد زیر را در ادامه کدهای بالا بنویسید :

helpProvider1.SetHelpString(textBox1, "Enter Your FirstName here...");

در کد بالا ما با استفاده از متد ()SetHelpString یک توضیح برای کنترل textBox نوشته‌ایم. برای نمایش این توضیح، ابتدا باید بر روی دکمه Help و سپس بر روی کنترل مورد نظر کلیک نمایید :

این کنترل دارای خاصیت‌ها و متدهای دیگری هم هست که در این درس به مهم‌ترین آن‌ها اشاره شد.