الأداة ToolTip ...شرح مفصل لها و لأشهر خصائصها

كاتب الموضوع : مبتدئ عاشق التصميم

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

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

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

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

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

[INDENT]

كود :

Dim tooltip1 As New ToolTip

[/INDENT]

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

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

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

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

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

سوف يتم المتابعة بعد موافقة الادارة ....

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

[SIZE=4]active[/SIZE]
تأخذ القيمة true أو falseو هي تشير اذا ما كانت الأداة نشطة أم لا

فاذا كان

كود :

ToolTip1.Active = False

اذا لاتظهر الأداة عند وقوع الحدث

AutomaticDelay
تحديد الزمن الذي يمر قبل ظهور الأداة

فاذا كان

كود :

ToolTip1.AutomaticDelay = 2000

فتظهر الأداة بعد مرور
ثانيتين من وقوع الحدث ((تظهر بعد الضغط على button1
مثلا بثانيتين ))

القيمة الافتراضية هي 500 مللي ثانية
[SIZE=4]
[/SIZE]AutoPopDelay
تحدد الفترة الزمنية التي يستمر فيها ظهور الأداة عندالوقوف بمؤشر الماوس على عنصر معين قبل اختفائها

فاذا كان

كود :

ToolTip1.AutoPopDelay = 4000

تبقى الأداة ظاهرة بعد وقوع
الحدث بأربع ثوان ((عند الضغط على button1 كمثال يستمر مستطيل الأداة ظاهرا لمدة أربع ثوان ثم يختفي ))
أقصى قيمة لها 5000 مللي ثانية = 5 ثوان

InitialDelay

تحدد الفترة الزمنية التي تمر قبل ظهور الأداة ,أقصى قيمة لها 32767 مللي ثانية
اذا كان

كود :

ToolTip1.InitialDelay = 32000

تمر 32 ثانية قبل أن تظهر
الأداة "روح اشرب شاي و تعالى لحد ما تظهر "

BackColor
تحديد لون خلفية الأداة

ForeColor
تحديد لون الكتابة على الأداة

IsBalloon
تأخذ القيمة true أو false و تستخدم في تغيير شكل الأداة من مجرد مستطيل بسيط الى شكل يشبه البالون

StripAmpersands

تحدد اذا ما كان سيتم التعامل مع الرمز "&" كأداة لربط النصوص أو كحرف يدخل في تركيب النص

* اذا كان

كود :

ToolTip1.StripAmpersands = True

فسيتم التعامل مع الرمز "&" كأداة لربك النصوص فعند كتابة

"أحمد&علي" سوف يكون الناتج "أحمدعلي"
*أما اذا كان =

كود :

ToolTip1.StripAmpersands

false

فسيتم التعامل مع الرمز "&" كحرف يدخل في تركيب النص
فعند كتابة "أحمد&علي" سوف يكون الناتج "أحمد&علي"

ToolTipIcon

معرفة نوع و شكل الايقونة (الرمز ) الذي سيظهر بجوار النص ,ويوجد أربع خيارات :

none :لعدم اظهار أي ايقونة
info :أيقونة المعلومات عبارة عن بالون بداخله حرف I للدلالة على أن المعلومات المعروضة فيها افادة للمستخدم

warning :أيقونة تعجب عبارة عن مثلت أصفر فيه علامة تعجب لجذب الانتباه الى أن ما يتم عرضه هو شيء هام و يستحق الانتباه

error : أيقونة الموقف الحرج عبارة عن أيقونة دائرية حمراء بها علامة خطأ لاعلامالمشغل بحدوث خطأ ما أثناء [SIZE=3]عمل البرنامج
[/SIZE]

ToolTipTitle
وضع عنوان لنافذة للأداة يظهر أعلى النص المكتوب بخط أكبر من خط النص

[SIZE=4]أهم وسائل الأداة methods :[/SIZE]

[SIZE=4]SetToolTip[/SIZE]

تحديد النص الذي سوف يظهر في مستطيل الأداة و الأداة التي سوف يظهر عليها في النموذج

كود :

("النص الذي نريد اظهاره", اسم الأداة )ToolTip1.SetToolTip

عند كتابة الكود التالي في الحدث click لــــbutton1
وتشغيل البرنامج

ToolTip1.SetToolTip(Button1, "welcome ...we are very hapyy")
سوف يظهر كما في الصورة :

Show
نفس عمل الوسيلة السابقة مع امكانية تحديد موقع نافذة الأداة من النموذج و أيضا تحدد الفترة الزمنية التي يستمر فيها ظهور الأداة قبل اختفائها

كود :

ToolTip1.Show("text", Button1, 50, 70, 6000)

"text" : هو النص الذي نريد اظهاره

*Button1 :اسم الأداة

50 هي المسافة بالبكسل من الطرف الأيسر للنموذج
* 70 هي المسافة بالبكسل من الطرف العلوي للنموذج
*6000:المدة التي يستمر فيها ظهور الأداة قبل اختفائها

ملحوظة : الخاصية AutoPopDelay أقصى قيمة لها هي 5 ثوان ثم تختفي الأداة لذلك يفضل استعمال الوسيلة show لتحديد الفترة التي تريدها

[SIZE=4]Hide
[/SIZE]
اخفاء نافذة الأداة ToolTip

و غيرها من الخصائص و الوسائل ....
[SIZE=4]
العلاقة بين الخصائص AutoPopDelay و InitialDelay و ReshowDelay و AutomaticDelay[/SIZE]

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

الخاصية :AutoPopDelay
القيمة الافتراضية : عشر أضعاف القيمة المخزة في الخاصية
Automatic Delay

الخاصية :Initial Delay
القيمة الافتراضية : تأخذ نفس القيمة المخزنة في الخاصية
Automatic Delay

الخاصية :Reshow Delay
القيمة الافتراضية : خمس 1\5 القيمة المخزنة في الخاصية
Automatic Delay

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

اذا كانت

كود :

ToolTip1.AutomaticDelay = 100

فان

كود :

[SIZE=3]

ToolTip1.Initial Delay = 100 

ToolTip1.AutoPopDelay = 1000 

ToolTip1.Reshow Delay = 20 [/SIZE]

[SIZE=4]أمثلة على استخدام الأداة ToolTip[/SIZE]

كود :

[SIZE=3]

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[/SIZE]