أداة التلميح ToolTip

   الأداة ToolTip : هي أداة تستخدم لعرض  تلميح أو معلوماتٍ أو وصفٍ موجزٍ في مستطيل صغير يظهر بالقرب من المؤشر عندما يقوم المستخدم بتحريك المؤشر أو نقره  فوق أداة معينة أو في مكان معين من النموذج

و تستخدم هذه الأداة كثيرا جدا فعندما تقف بمؤشر الماوس على ملف  أو على مجلد ما على سطح المكتب ترى ظهور مستطيل يحتوي معلومات عن هذا الملف من حيث مكان التخزين و سعة الملف...الخ

وأيضا  تستخدم بصفة مستمرة  داخل برنامج الفيجوال ستوديو فعندما تقف بمؤشر الماوس على أداة ما في صندوق الأدوات يظهرلك مستطيل يحتوي على اسم الأداة و نسختها و معلومات عنها تفيدك كثيرا في التعرف على هذه الأداة ووضيفتها

كما في الشكل الثالي:

اضافتها للنموذج :توجد هذه الأداة في صندوق الأدوات ToolBox  بصفة أساسية قم بالنقر عليها و تمريرها للنموذج فنراها تظهر في شريك سفلي أسفل النموذج form   لا تظهر عليه ...
 أو يمكننك تعريفها كمتغير كما يلي :

  Dim tooltip1 As New ToolTip

ملحوظة : ان لم تجد هذه الأداة في صندوق الأدوات قم بما يلي :

1-في أي مكان على صندوق الأدوات ToolBox اضغط بمؤشر الماوس الأيمن right click سوف تظهر لك قائمة اختر منها choose items

2-سوف يفتح لك مربع حواري يحتوي على أربع تبويبات في الأعلى اختر . net framework components

3- قم بالبحث عن الأداة داخل هذا التبويب و بعد ايجادها ضع أمامها علامة صح ثم اضغط ok

فتراها قد أضيفت لصندوق الأدوات

أهم و أشهر خصائص و وسائل و أحداث  الأداة  ToolTip

مثال	الوصف	اسم الخاصية properties
اذا كان  ToolTip1.Active = False  اذا لاتظهر الأداة عند وقوع الحدث	تأخذ القيمة  true  أو false   و هي تشير  اذا ما كانت الأداة نشطة أم لا	active
اذا كان  ToolTip1.AutomaticDelay = 2000 فتظهر الأداة بعد مرور ثانيتين من وقوع الحدث ((تظهر بعد الضغط على button1 مثلا بثانيتين ))	تحديد الزمن الذي يمر قبل  ظهور الأداة القيمة الافتراضية هي 500 مللي ثانية	AutomaticDelay
اذا كان ToolTip1.AutoPopDelay = 4000 تبقى الأداة ظاهرة بعد وقوع الحدث بأربع ثوان ((عند الضغط على button1 كمثال يستمر مستطيل الأداة ظاهرا لمدة أربع ثوان ثم يختفي ))	تحدد الفترة الزمنية التي يستمر فيها ظهور الأداة عند الوقوف بمؤشر الماوس على عنصر معين قبل اختفائها  أقصى قيمة لها 5000 مللي ثانية = 5 ثوان	AutoPopDelay
اذا كان ToolTip1.InitialDelay = 32000 تمر 32 ثانية قبل أن تظهر الأداة   "روح اشرب شاي و تعالى لحد ما تظهر "	تحدد الفترة الزمنية التي تمر قبل ظهور الأداة أقصى قيمة لها 32767 مللي ثانية	InitialDelay
	تحدد الزمن الذي يستمر فيه ظهور نافذة الأداة بعد تحريك المؤشر ونقله الى عنصر آخر	ReshowDelay
	تحديد لون خلفية الأداة	BackColor
	تحديد لون الكتابة على الأداة	ForeColor
	تأخذ القيمة  true  أو false   و تستخدم في تغيير شكل الأداة من مجرد مستطيل بسيط الى شكل يشبه البالون	IsBalloon
* اذا كان  ToolTip1.StripAmpersands = True فسيتم التعامل مع الرمز "&" كأداة لربك النصوص  فعند كتابة "أحمد&علي" سوف يكون الناتج "أحمدعلي" *أما اذا كان  ToolTip1.StripAmpersands = False فسيتم التعامل مع الرمز "&" كحرف يدخل في تركيب النص فعند كتابة "أحمد&علي" سوف يكون الناتج "أحمد&علي"	تحدد اذا ما كان سيتم التعامل مع الرمز "&"  كأداة لربط النصوص أو كحرف يدخل في تركيب النص	StripAmpersands
اذا كان  ToolTip1.ToolTipIcon = 1 سيتم اظهار الأيقونة info اذا كان  ToolTip1.ToolTipIcon = 2 سيتم اظهار الأيقونة warning اذا كان  ToolTip1.ToolTipIcon = 3 سيتم اظهار الأيقونة error	معرفة نوع و شكل  الايقونة (الرمز ) الذي سيظهر بجوار النص ,ويوجد أربع خيارات : none :لعدم اظهار أي ايقونة ,  info : أيقونة المعلومات عبارة عن بالون بداخله حرف I  للدلالة على أن المعلومات المعروضة فيها افادة للمستخدم warning : أيقونة تعجب عبارة عن  مثلت أصفر فيه علامة تعجب لجذب الانتباه الى أن ما يتم عرضه هو شيء هام و يستحق الانتباه error : أيقونة الموقف الحرج عبارة عن أيقونة دائرية حمراء بها علامة خطألاعلام المشغل  بحدوث خطأ ما أثناء عمل البرنامج	ToolTipIcon
	وضع عنوان لنافذة  للأداة يظهر أعلى النص المكتوب بخط أكبر من خط النص	ToolTipTitle
مدونة خيال مبرمج http://www.mhm3.blogspot.com/

مثال	الوصف	اسم  الوسيلة methods
عند كتابة الكود التالي  في الحدث click لــــbutton1  وتشغيل البرنامج   ToolTip1.SetToolTip(Button1, "welcome ...we are very happy") :code سوف يظهر كما في الصورة :	تحديد النص الذي سوف يظهر في مستطيل الأداة و الأداة التي سوف تظهر عليها في النموذج  ("النص الذي نريد اظهاره", اسم الأداة )ToolTip1.SetToolTip	SetToolTip
ToolTip1.Show("text", Button1, 50, 70, 6000) :code "text" : هو النص الذي نريد اظهاره  *Button1 :اسم الأداة 50 هي المسافة بالبكسل من الطرف الأيسر للنموذج   * 70 هي المسافة بالبكسل من الطرف العلوي  للنموذج *6000:المدة التي يستمر فيها ظهور الأداة قبل اختفائها ملحوظة : الخاصية AutoPopDelay أقصى قيمة لها هي 5 ثوان ثم تختفي الأداة لذلك يفضل استعمال الوسيلة show لتحديد الفترة التي تريدها	نفس عمل الوسلة method  السابقة مع امكانية تحديد موقع نافذة الأداة من النموذج و أيضا تحدد الفترة الزمنية التي يستمر فيها ظهور الأداة قبل اختفائها	Show
	اخفاء نافذة الأداة ToolTip	Hide

و غيرها من الخصائص و الوسائل ....

 العلاقة بين الخصائص  AutoPopDelay  و InitialDelay  و  ReshowDelay و  AutomaticDelay

عند و ضع قيمة للخاصية AutomaticDelay   توضع للخصائص الثلاث الباقية AutoPopDelay  و InitialDelay  و  ReshowDelay   قيم افتراضية كما في الجدول 

القيمة الافتراضية	الخاصية
عشر أضعاف القيمة المخزة في الخاصية Automatic Delay	AutoPopDelay
تأخذ نفس القيمة المخزنة في الخاصية Automatic Delay	Initial Delay
خمس  1\5  القيمة المخزنة في الخاصية Automatic Delay	Reshow Delay

مثـــــــــــــــــــــــــــــــــــــال:

اذا كانت

ToolTip1.AutomaticDelay = 100

فان

 ToolTip1.AutoPopDelay = 1000
ToolTip1.Initial Delay = 100 

ToolTip1.Reshow Delay = 20

 أمثلة على استخدام الأداة ToolTip

Private Sub Form1_Load(sender As Object, e As System.EventArgs)

 Handles MyBase.Load
    Dim toolTip1 As New ToolTip()

   toolTip1.AutoPopDelay = 5000
   toolTip1.InitialDelay = 1000
   toolTip1.ReshowDelay = 500
     toolTip1.ShowAlways = TrueMe.button1, "My button1")
   toolTip1.SetToolTip(Me.checkBox1, "My checkBox1")
End Sub