[RaggiTech]

أهم و أشهر خصائص و وسائل و أحداث الأداة 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]