إستكمالا للشرح :

رابعا : شرح أوامر التعامل مع العنصر " الأكواد " :

• GridEx.AddBitmap يستخدم هذا الأمر لإضافة صور بإمتداد "bmp." إلى ذاكرة العنصر ويعود برقم يعبر عن الصورة يمكن إستخدام هذا الرقم فيما بعد لإستدعاء عرض الصورة داخل أى خلية يتم تحديدها .

مثال على ذلك الكود :

[HTML]--
result = GridEx.AddBitmap("Plugin1", "AutoPlay\\Images\\bitmap.bmp");[/HTML]


فى الكود السابق يتم تخزين الصورة المسماه " bitmap.bmp " والتى قمنا بإختيارها كرقم إندكس فماذا يا ترى رقم الإندكس هذا ؟ يمكن معرفتة عن طريق عدد الأكواد فلكل كود حسب ترتيبه فى محرر الأكشن ودائما يبدأ العدد من 0 أى أن فى حالة إدراج كود واحد فقط يكون قيمة المتغير الذى يحفظ فيه هو 0 وفى حالة وجود خطأ فى تنفيذ الأمر يكون الريتيرن هو"1-" .


محتويات الكود كما بالصورة التالية :




1- هو إسم عنصر الأوبجيكت المراد تنفيذ الكود عليه .
2- هو مسار الصورة التى يتم تحديدها والتى يجب أن تكون بصيغة bmp .
3- هو المتغير الذى سوف يتم تخزين قيمة رقمية فيه معبرة عن رقم الإندكس المحفوظة فية الصورة داخل ذاكرة العنصر .

• GridEx.SetCellBitmap يستخدم هذا الأمر لوضع الصورة السابقة التحديد بالكود السابق داخل الخلية التى يتم تحديدها .


مثال على ذلك الكود :

[HTML]--
result2 = GridEx.SetCellBitmap("Plugin1", 1, 0, result, 65280);[/HTML]


فى الكود السابق تم وضع رقم إندكس الصورة والذى تم تخزينه فى المتغير result فى الكود الأسبق وبالتالى فإن المتغير result يعبر عن رقم الإندكس الخاص بالصورة المخزنه فى ذاكرة العنصر GridEx ونلاحظ أننا بذلك الكود قمنا بوضع الصورة للعمود رقم 1 فى الصف رقم 0 .


محتويات الكود كما بالصورة التالية :




1- هو إسم عنصر الأوبجيكت الذى سوف يتم تنفيذ الكود عليه .
2- هو رقم العمود الذى سوف يتم تنفيذ الكود عليه .
3- هو رقم الصف الذى سوف يتم تنفيذ الكود عليه .
4- هو رقم إندكس الصورة المحفوظة فى ذاكرة العنصر مسبقا بالكود السابق شرحه وكما ذكرنا
يمكن وضع إسم المتغير أو القيمة الرقمية التى حفظت فى المتغير كما وضحنا سابقا .
5- يمكننا من إختيار لون يتم عمل شفافية له من الصورة السابق تحديدها .
6- هو المتغير الذى سوف يتم حفظ ناتج العملية فيه وفى هذا الكود فإن الناتج يكون قيمة بولينية إما
True فى حالة نجاح إتمام عمل الكود أو false فى حالة وجود خطأ فى عملية إضافة الصورة أو فشل العملية .

• GridEx.RedrawAll يستخدم هذا الأمر لإعادة رسم الشبكة " عنصر الأوبجيكت " أو إعادة إنعاشها بمعنى عمل ريفريش للعنصر وذلك بغرض عرض أى تغييرات قمت لاحقا بعملها على العنصر من تنفيذ أكواد أو غيرها .


محتويات الكود كما بالصورة التالية :




1- هو إسم عنصر الأوبجيكت المراد تنفيذ الكود عليه .
2- هو إسم المتغير الذى سوف يتم حفظ قيمة الريتيرن فيه بعد تنفيذ الكود ففى حالة نجاح تنفيذ الكود يكون الريتيرن المخزن فى المتغير هو قيمة بولينية True وفى حالة الفشل يخزن فى المتغير القيمة البولينية false .

• GridEx.AddFont يستخدم هذا الأمر لإضافة فونت أو خط جديد وتحميلة إلى ذاكرة العنصر كإندكس أو رقم يتم حفظه فى إسم المتغير المستخدم مع الأمر عن طريق الريتيرن حيث يسهل بعد ذلك إستدعاء الخط وإستخدامه فيما بعد .


محتويات الكود كما بالصورة التالية :




1- هو إسم العنصر المستخدم والذى سوف يتم تنفيذ الكود عليه .
2- هو إسم الخط المراد إستخدامه يتم إختياره من مجلد الخطوط فى الويندوز .
3- هو حجم الخط الذى تم إختيارة أثناء الكتابة به بداخل العنصر .
4- هو ثقل الخط الذى تم إختيارة أثناء الكتابة به بداخل العنصر ويتم الإختيار من خيارات عدة
" FW_DONTCARE - FW_THIN - FW_EXTRALIGHT - FW_LIGHT - FW_NORMAL - FW_MEDIUM - FW_SEMIBOLD - FW_BOLD - FW_EXTRABOLD - FW_HEAVY ".
5- إذا تم إختيار القيمة البولينية True فإن الكتابة بالخط المائل سوف تصبح مفعلة ويكون النتيجة هى الكتابة بخط مائل وإذا تم إختيار القيمة false تصبح الكتابة بخط مائل غير مفعلة فى هذا الفونت الذى تم إختيارة بالأعلى .
6- إذا تم إختيار القيمة البولينية True فإن الكتابة يصبح تحتها خط مفعلة ويكون النتيجة هى الكتابة وتحتها خط وإذا تم إختيار القيمة false تصبح غير مفعلة فى هذا الفونت الذى تم إختيارة بالأعلى .
7- إذا تم إختيار القيمة البولينية True فإن الكتابة يصبح فى منتصفها خط مفعلة ويكون النتيجة هى الكتابة وفى منتصفها خط وإذا تم إختيار القيمة false تصبح غير مفعلة فى هذا الفونت الذى تم إختيارة بالأعلى .
8- هو المتغير الذى سوف يتم حفظ ناتج هذا الكود وهو الريتيرن ويكون رقما يتم تخزينه فى ذاكرة العنصر ومن ثم يمكن إستدعاؤه فيما بعد عند إستخدامك لهذا الخط فى الكتابه داخل العنصر .

• GridEx.SetDefaultFont يستخدم هذا الأمر لوضع خط إفتراضى يتم إستخدامه عند الكتابة داخل العنصر .


محتويات الكود كما بالصورة التالية :




1- هو إسم البليجين أو العنصر المراد إجراء تنفيذ الكود عليه .
2- هو رقم إندكس الخط المراد إستخدامه والذى تم تخزينه فى الذاكرة أو ذاكرة العنصر من قبل الكود السابق الذى كان GridEx.AddFont .

3- هو المتغير المراد حفظ نتيجة تنفيذ هذا الكود به وفى هذا الكود يكون الريتيرن الذى سوف يتم تخزينه بالمتغير هو عبارة عن قيمة بولينية إما True فى حالة نجاح عمل الكود أو false فى حالة فشل الكود .

• GridEx.SetCellFont يستخدم هذا الأمر لتعيين خط معين لإستخدامه فى خلية معينه .



محتويات الكود كما بالصورة التالية :





1- هو إسم البليجين أو العنصر المراد تنفيذ الكود على أحد خلاياه .
2- هو رقم العمود المراد إستخدام الخط فيه .
3- هو رقم الصف المراد إستخدام الخط فيه .
وكما تعلمون أن عمود معين مع صف معين يكون خلية أو أطلق أنا عليها كذلك حتى يكون كلامى مفهوم لدى الجميع .

4- هو رقم إندكس الخط المراد إستخدامه والذى تم تخزينه فى الذاكرة أو ذاكرة العنصر من قبل الكود السابق الذى كان GridEx.AddFont .
5- هو المتغير المراد حفظ نتيجة تنفيذ هذا الكود به وفى هذا الكود يكون الريتيرن الذى سوف يتم تخزينه بالمتغير هو عبارة عن قيمة بولينية إما True فى حالة نجاح عمل الكود أو false فى حالة فشل الكود .

• GridEx.AddTab يستخدم هذا الأمر أو الكود لإنشاء لسان جديد إلى العنصر يمكن من خلال هذا اللسان عمل تصفح أو عمل مجموعة صفحات بالعنصر بحد أقصى 64 لسان .

ويوضع هذا الكود فى الحدث " On SetUp " فى أحداث عنصر الــــ GridEx
كما يتم إضافة مجموعة أوامر تشكل المظهر العام للسان المراد إنشاؤه كما سيوضح بالمتابعه معى فى الشرح هذا .



محتويات الكود كما بالصورة التالية :



1- هو إسم عنصر الأوبجيكت الذى سوف يتم تنفيذ الكو عليه .
2- هو النص المراد كتابته كــ إسم للسان الذى سوف يتم إنشاؤه .
3- هو عبارة عن رقم معرف اللسان الذى سوف يتم إنشاؤه ومن خلال هذا الرقم يتم التعامل مع اللسان بعد ذلك ويمكن أن يبدأ من 0 .
4- هو المتغير المراد حفظ نتيجة تنفيذ هذا الكود به وفى هذا الكود يكون الريتيرن الذى سوف يتم تخزينه بالمتغير هو عبارة عن قيمة بولينية إما True فى حالة نجاح عمل الكود أو false فى حالة فشل الكود .

• GridEx.SetTabBackColor يستخدم هذا الكود لعمل لون خلفية للسان ويظهر هذا اللسان فى حالة عدم تنشيط إختيار اللسان أى أن لون خلفية اللسان يظهر عندما يكون لسان آخر هو الذى تم إختياره أو تم الضغط على لسان آخر .
ويوضع هذا الكود فى الحدث " On SetUp " فى أحداث عنصر الــــ GridEx


محتويات الكود كما بالصورة التالية :




1- هو إسم عنصر الأوبجيكت الذى سوف يتم تنفيذ الكو عليه .
2- هو عبارة عن رقم معرف اللسان الذى سوف يتم إنشاؤه ومن خلال هذا الرقم يتم التعامل مع اللسان بعد ذلك ويمكن أن يبدأ من .
3- هو اللون الذى تريد إختياره كخلفية للسان فى حالة عدم تنشيط إختياره .
4- هو المتغير المراد حفظ نتيجة تنفيذ هذا الكود به وفى هذا الكود يكون الريتيرن الذى سوف يتم تخزينه بالمتغير هو عبارة عن قيمة بولينية إما True فى حالة نجاح عمل الكود أو false فى حالة فشل الكود .

• GridEx.SetTabTextColor يستخدم هذا الكود لإختيار لون النص المكتوب فى اللسان ويظهر هذا اللسان فى حالة عدم تنشيط إختيار اللسان أى أن لون خلفية اللسان يظهر عندما يكون لسان آخر هو الذى تم إختياره أو تم الضغط على لسان آخر .

ويوضع هذا الكود فى الحدث " On SetUp " فى أحداث عنصر الــــ GridEx



محتويات الكود كما بالصورة التالية :




1- هو إسم عنصر الأوبجيكت الذى سوف يتم تنفيذ الكو عليه .
2- هو عبارة عن رقم معرف اللسان الذى سوف يتم إنشاؤه ومن خلال هذا الرقم يتم التعامل مع اللسان بعد ذلك ويمكن أن يبدأ من 0 .
3- هو اللون الذى تريد إختياره كخلفية الكتابة فى اللسان فى حالة عدم تنشيط إختياره .
4- هو المتغير المراد حفظ نتيجة تنفيذ هذا الكود به وفى هذا الكود يكون الريتيرن الذى سوف يتم تخزينه بالمتغير هو عبارة عن قيمة بولينية إما True فى حالة نجاح عمل الكود أو false فى حالة فشل الكود .

• GridEx.SetTabHiliteBackColor يستخدم هذا الكود لعمل لون خلفية للسان ويظهر هذا اللسان فى حالة تنشيط إختيار اللسان أى أن لون خلفية اللسان يظهر عندما يكون اللسان هو الذى تم إختياره .
ويوضع هذا الكود فى الحدث " On SetUp " فى أحداث عنصر الــــ GridEx



محتويات الكود كما بالصورة التالية :




1- هو إسم عنصر الأوبجيكت الذى سوف يتم تنفيذ الكو عليه .
2- هو عبارة عن رقم معرف اللسان الذى سوف يتم إنشاؤه ومن خلال هذا الرقم يتم التعامل مع اللسان بعد ذلك ويمكن أن يبدأ من 0 .
3- هو اللون الذى تريد إختياره كخلفية للسان فى حالة تنشيط إختياره .
4- هو المتغير المراد حفظ نتيجة تنفيذ هذا الكود به وفى هذا الكود يكون الريتيرن الذى سوف يتم تخزينه بالمتغير هو عبارة عن قيمة بولينية إما True فى حالة نجاح عمل الكود أو false فى حالة فشل الكود .

• GridEx.SetTabHiliteTextColor يستخدم هذا الكود لإختيار لون النص المكتوب فى اللسان ويظهر هذا اللسان فى حالة تنشيط إختيار اللسان أى أن لون خلفية اللسان يظهر عندما يكون اللسان هو الذى تم إختياره .

ويوضع هذا الكود فى الحدث " On SetUp " فى أحداث عنصر الــــ GridEx



محتويات الكود كما بالصورة التالية :




1- هو إسم عنصر الأوبجيكت الذى سوف يتم تنفيذ الكو عليه .
2- هو عبارة عن رقم معرف اللسان الذى سوف يتم إنشاؤه ومن خلال هذا الرقم يتم التعامل مع اللسان بعد ذلك ويمكن أن يبدأ من 0 .
3- هو اللون الذى تريد إختياره كخلفية الكتابة فى اللسان فى حالة تنشيط إختياره .
4- هو المتغير المراد حفظ نتيجة تنفيذ هذا الكود به وفى هذا الكود يكون الريتيرن الذى سوف يتم تخزينه بالمتغير هو عبارة عن قيمة بولينية إما True فى حالة نجاح عمل الكود أو false فى حالة فشل الكود .

• GridEx.SetTabWidth يستخدم هذا الكود لتحديد عرض اللسان المراد إنشاؤه ويعمم هذا العرض على كافة الألسنة التى تنشئ .

ويوضع هذا الكود فى الحدث " On SetUp " فى أحداث عنصر الــــ GridEx



محتويات الكود كما بالصورة التالية :




1- هو إسم عنصر الأوبجيكت الذى سوف يتم تنفيذ الكو عليه .
2- هو العرض الذى تريد أن يظهر به اللسان ويعمم هذا العرض على كافة الألسنه .
3- هو المتغير المراد حفظ نتيجة تنفيذ هذا الكود به وفى هذا الكود يكون الريتيرن الذى سوف يتم تخزينه بالمتغير هو عبارة عن قيمة بولينية إما True فى حالة نجاح عمل الكود أو false فى حالة فشل الكود .

• GridEx.GetTabCount يستخدم هذا الكود لمعرفة عدد الألسنة التى تم إنشاؤها .


محتويات الكود كما بالصورة التالية :




1- هو إسم عنصر الأوبجيكت الذى سوف يتم تنفيذ الكو عليه .
2- هو المتغير المراد حفظ نتيجة تنفيذ هذا الكود به وفى هذا الكود يكون الريتيرن الذى سوف يتم تخزينه بالمتغير هو عبارة عن عدد الألسنه فى حالة نجاح عمل الكود أو 0 فى حالة فشل الكود .

خالص الشكر والامتنان على ما بذلتموه من جهود مباركة


وفقك الله وأثابك ونفع بك