شرح تفصيلى للتعامل مع عنصر الليست بوكس إى إكس"ListBox EX"

╮════════════════════════════╭

إخـــوانى أعضــاء وزوار منتدى أتوبلاى العرب

╯════════════════════════════╰


فى البداية أحب أن أوضح أن هذا الشرح تم بناءا على فهمى الشخصى للعنصر ليست بوكس إى إكس

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

فى الشرح والتوضيح أن يكتب ردا بالتصحيح المناسب لأى معلومة غير مكتملة أو خاطئة .


* نبدأ إن شاء الله تعالى

سلسلة لشرح التعامل مع عنصر الأوبجيكت " ListBox EX " هذا العنصر المهم والذى له

إمكانيات كبيرة جدا بالمقارنة مع عنصر الليست بوكس العادى وسنبدأ أولا مع كيفية ادراج هذا العنصر للمشروع :

1- من قائمة " Object " ثم نذهب الى كلمة " Plugins " .

2- نضغط على هذة الكلمة وهى تحتوى على كل عناصر الأوبجيكت المنصبة فى فولدر البليجين داخل البرنامج .

3- يتم البحث عن العنصر المراد إضافتة بالمشروع " ListBox EX " ويتم الضغط علية حتى يمكن إدراجة بالمشروع .

• صورة توضيحية لما سبق :


• بعد ما سبق سوف تظهر الصورة التالية :

• شرح لما هو موجود بالصورة السابقة

╮═════════════════════╭

أولا كلمة " Settings "

╯═════════════════════╰


أولا كلمة " Settings " أعلى يسار الصورة بمعنى الضبط :

للوصول الى معلومات حول العنصر و ضبط خصائص العنصر و نتطرق لشرح خصائص العنصر "Properties" كالتالى

صورة توضيحية :



توضيح بالشرح لما هو موجود بالصورة السابقة :

1- " Border Style " هو نمط الحدود الخارجية لعنصر الليست بوكس

صورة توضيحية :


حيث يتم الإختيار ما بين 4 خيارات وهم :

- " None" و "Flat" و "Sunken" و "Bevel"

بالتجربة ستجد ما يناسبك من ناحية الشكل .

===================================


2- " Back Color " وهى الخلفية اللونية للليست بوكس ولا تظهر هذة الخلفية عند المعاينة

للمشروع إلا فى حالة إذا كان عدد العناصر المدرجة فى الليست بوكس أصغر و أقل فى الحجم

من ناحية الإرتفاع للعناصر حيث يمكن تغيير حجم العناصر المدرجة فى الليست بوكس بمعنى المقاس .

===================================


3- " CheckList Style " يستخدم هذا الخيار عند تنشيط خيار تحديد العناصر " Check Boxes "

وهو الخيار السادس فى الصورة السابقة للشرح حيث :

- القيمة " true " حتى يمكن تحديد وإزالة التحديد للعناصر عند الضغط بالماوس على العنصر

نفسة فى أى مكان لا يشترط على مربع التحديد فقط بل على أى مكان فى أى اندكس حيث

كل عنصر يدرج فى الليست بوكس يأخذ إندكس .

- القيمة " False " تلغى الخاصية السابق ذكرها وتكتفى بتحديد العنصر فقط من خلال مربع

التحديد فى حالة كما ذكرنا تنشيط الخيار "Check Boxes " .

===================================


4- " Drag And Drop " وهى تستخدم عندما نريد إدراج عناصر بالسحب والإفلات بالماوس

فالقيمة " true " للتمكين من ذلك و القيمة " False " لعدم التمكين لهذا الخيار .

===================================


5- "Raised Edges " يحدد بروز حواف مرتفعة للفواصل بين العناصر المدرجة فى الليست بوكس

بمعنى فواصل الاندكسات بالقيمة " true " تمكن ذلك والقيمة " False " للإلغاء .

===================================


6- " Check Boxes " لعمل مربع لتحديد العناصر فى الليست بوكس لكل إندكس أو عنصر مدرج

القيمة " true " أو عدم تمكين ذلك بالقيمة" False ".

===================================


7- " Separator " لعمل فواصل بين العناصر المدرجة فى الليست بوكس القيمة " true " للعمل والقيمة " False " للإلغاء .

===================================


8- " Color Separator" لون الفواصل السابق تفعيلها الى أى لون تريد .

===================================


9- " Normal Color " وهو اللون الإفتراضى لخلفية العناصر المدرجة فى الليست بوكس أثناء عدم وجود الماوس على العنصر .

===================================


10- " HighLight Color " هو لون خلفية العنصر عند مرور الماوس على العنصر .

===================================


11- " Selection Color " هو لون خلفية العنصر عند الضغط بالماوس على العنصر .

===================================


12- " Normal GStyle " هو اتجاة التدرج اللونى لعناصر الليست بوكس فى الحالة العادية وذلك عند استخدام أكثر من لون من خلال

أوامر التعامل مع الليست بوكس والتى سوف نتعرف عليها لاحقا .

===================================


13-" HighLight GStyle " هو اتجاة التدرج اللونى لخلفية العناصر المدرجة فى الليست بوكس فى حالة مرور الماوس على العنصر .

===================================


14-" Selection GStyle" هو اتجاة التدرج اللونى لخلفية العناصر المدرجة فى الليست بوكس فى حالة الضغط بالماوس على العنصر

أو عند إختيار العنصر بمعنى أصح .

===================================


15- "HighLight Items " هو لإظهار التدرج اللونى عند مرور الماوس فى حالة إختيار القيمة " true " أو عدم الإظهار فى الحالة " False " .

الصورة التالية توضح ما تم ذكرة عن التدرج اللونى لخلفية العناصر المدرجة بالليست بوكس :


ملحوظة هامة جدا للتوضيح فى كل إندكس من الليست بوكس تجد تدرج مختلف وأنا هنا أقصد التدرج اللونى وليس اللون نفسة .

===================================



16- " Show Icons " هذا هو خيار إظهار أيكونة بجوار كل العناصر المدرجة فى الليست بوكس بمعنى إظهار أيكونة لكل إندكس فى الليست بوكس

صورة توضيحية :

===================================


17- " Default Font " هو الخط الافتراضي .

===================================


18- " Show ToolTips" هو تمكين ظهور أداة تلميح أو تعليق عند مرور الماوس على أى إندكس

وذلك عند إختيار القيمة " true " أو عدم ظهور التلميح أو التعليق " False "

صورة توضيحية :

===================================


19- " ToolTips Text Color " هو الون الإفتراضى لنص التلميح أو التعليق ويتم إختيار أى لون .

===================================


20- " BackColor Begin " منها يتم إختيار لون خلفية الشريحة العلوية لخلفية التعليق أو التلميح الذى تم الإشارة إلية .

===================================


21- " BackColor Middle" منها يتم إختيار لون الخلفية لشريحة المنتصف الأفقية للتعليق أو التلميح الذى تم الإشارة إلية .

===================================


22- " BackColor End " منها يتم إختيار لون خلفية الشريحة السفلية لخلفية التعليق أو التلميح الذى تم الإشارة إلية .

* ملحوظة كل ماسبق هو عبارة عن شرائح أفقية للألوان كما بالصورة التالية

حيث تم إختيار الجزء العلوى والسفلى بلون أصفر و جزء المنتصف بلون برتقالى انظر الى الصورة التالية:



===================================


23- " Max Tooltip width " يمكن من خلالة التحكم فى عرض التلميح أو التعليق بمعنى أنة

عندما يصل الى هذا الحد ولا يزال كلمات أخرى فى التعليق فيتم كتابتها فى السطر التالى كما هو موضح بالصورة التالية :


إلى هنا قد إنتهت المرحلة الأولى للتعريف بضبط الخصائص

للعنصــر " ListBox EX " .


╮═════════════════════╭

• ثالثا كلمة " Script "

╯═════════════════════╰


• ثالثا كلمة " " Scriptأعلى يمين الصورة بمعنى سناريو التعامل مع العنصر من خلال الأوامر

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

الصورة التالية لترقيم الشرح :



الشرح التفصيلى كالأتى :

1- " On Create " هو الحدث الخاص بالأوامر المراد تنفيذها أثناء الإنشاء للبليجين على سبيل المثال لتوضيح الفكرة نضع كود إظهار رسالة " مرحبا بك فى منتدى الأتوبلاى ميديا ستوديو " الكود كالتالى :

كود:

الكود:

كود:
Dialog.Message("مرحبا بك فى منتدى الأتوبلاى ميديا ستوديو ", "رسالة ترحيب", MB_OK, MB_ICONINFORMATION, MB_DEFBUTTON1);

عند المعاينة ستظهر رسالة الترحيب

*هذة نبذة بسيطة للتعريف أما عند التعرض للأكواد سيتم وضع طريقة ومكان كتابة الكود المناسب .

===================================


2- " On Select " الأكواد التى يتم وضعها فى هذا الحدث يتم تنفيذها عند إختيار عنصر

من عناصر قائمة الليست بوكس عند الضغط على الأندكس المطلوب ضغطة واحدة بالماوس.

===================================


3- " On DobleClick " الأكواد التى يتم وضعها فى هذا الحدث يتم تنفيذها عند إختيار عنصر من عناصر

قائمة الليست بوكس و الضغط على الأندكس المطلوب ضغطتتين متتاليتين بالماوس.

===================================


4- " On RightClick " الأكواد التى يتم وضعها فى هذا الحدث يتم تنفيذها عند إختيار عنصر من عناصر قائمة الليست بوكس

و الضغط على الأندكس المطلوب بيمين الماوس يمكن أن يستخدم لإظهار قوائم والتنفيذ منها .

===================================


5- " On Enter " الأكواد التى يتم وضعها فى هذا الحدث يتم تنفيذها عند مرور الماوس على الليست بوكس .

===================================


6- " On Leave " الأكواد التى يتم وضعها فى هذا الحدث يتم تنفيذها بعد مغادرة الماوس للليست بوكس .

===================================


7- " On Focus " الأكواد التى يتم وضعها فى هذا الحدث يتم تنفيذها عند تركيز الإدخال

بمعنى الوضع الأول لضغط الماوس على عنصر الليست بوكس عند عدم تنشيطة .

===================================


8- " On MB-LeftClick" الأكواد التى توضع فى هذ الحدث يتم تنفيذها عند الضغط على شريط رسالة يمكن ظهورها

فوق عنصر الليست بوكس مباشرة بنفس عرض الليست بوكس بيسار الماوس .

===================================


9- " On MB-RightClick" الأكواد التى توضع فى هذ الحدث يتم تنفيذها عند الضغط على شريط رسالة يمكن ظهورها

فوق عنصر الليست بوكس مباشرة بنفس عرض الليست بوكس بيمين الماوس .

===================================


10- " On CheckBox " الأكواد التى توضع فى هذ الحدث يتم تنفيذها عند وضع علامة فى مربع التحديد

المجاور للعناصر المدرجة بالليست بوكس أو عند إزالة هذة العلامة و أيضا سوف يتم شرح الكود المناسب

وكيفية التعامل معة فيما بعد وطبعا شرط تفعيل خيار " Check Boxes " السابق ذكرة أثناء التعريف بضبط خصائص العنصر ..

===================================


11- " On DopFiles " الأكواد التى يتم وضعها فى هذا الحدث يتم تنفيذها عند السحب والإفلات لملفات

أو مجلدات من خارج المشروع لإضافتها إلى قائمة الليست بوكس

وطبعا شرط تفعيل خيار " Drag And Drop " السابق ذكرة أثناء التعريف بضبط خصائص العنصر .

===================================


12- " On SearchBtn " الأكواد فى هذا الحدث يتم تنفيذها عند الضغط على زر البحث للبحث عن عنصر مثلا

أو إسم فى الليست بوكس حيث يوفر الليست بوكس خاصية البحث ويتم عرضها أسفل العنصر

عبارة عن إينبت وزر ضمن إمكانيات الليست بوكس .

===================================


13- " On LinkClk " الأكواد فى هذا الحدث يتم تنفيذها عند الضغط على الرابط والذى يمكن وضعة

فى كل إندكس من عناصر الليست بوكس وعن طريق الأكواد يمكن الذهاب أو فتح الرابط

سواء خارج التجميعة أو المشروع أو داخل التجميعة أو المشروع .

===================================


14- " On TTLinkClk " الأكواد فى هذا الحدث يتم تنفيذها عند الضغط على الرابط والذى يمكن وضعة فى التعليق

الذى يظهر عند مرور الماوس على عناصر الليست بوكس وعن طريق الأكواد يمكن الذهاب أو فتح الرابط

سواء خارج التجميعة أو المشروع أو داخل التجميعة أو المشروع .

===================================


15- " Event Variables" مهم جدا لمعرفة المتغيرات التى يتعامل معها أى حدث فى أى عنصـر

والتى تختصر علينا أشياء كثيرة .

ولتوضيح بعض النقاط السابق ذكرها بالصور انظر إلى الصورة التالية والتى توضح عرض شريط تعليق أعلى الليست بوكس

و شريط آخر للبحث عن أسماء فى الليست بوكس الذى هو عبارة عن إينبت و زر كما ذكرنا مسبقا

وهو من المحتويات المدمجة فى الليست بوكس وأيضا إنظر إلى أنة يمكن التحكم فى عرض زر البحث و الإسم الذى يعطى لة

و أيضا الصورة توضح كيفية ظهور وصلة التحميل فى الإندكس المحدد وأيضا ظهور وصلة تحميل فى التعليق

الذى يظهر بمرور الماوس على العناصر المدرجة بالليست بوكس أو الإندكسات :