بسم الله الرحمن الرحيم

في هذا الدرس نستكمل الجزء الأخير من شرح برنامج الهيكل الرئيسي لنافذة الويندوز حيث يشمل هذا الجزء من الـ WinMain على تنفيذ الـmessage loop بواسطة الكود التالي:

((while(GetMessage(&msg, NULL, 0, 0

 ((TranslateMessage(&msg }

{  (DispatchMessage(&msg

وحتى نفهم تسلسل تنفيذ الـ message loop  فإنه علينا ان نفهم متى تبدأ بالتنفيذ.

تبدأ الـ message loop  بالتنفيذ حين يدرك نظام التشغيل (الويندوز) ان الـ queue الخاصة بهذا التطبيق استقبلت رسالة جديدة من المستخدم ففي هذه الحالة يقوم نظام التشغيل بإعطاء التحكم (control) إلى التطبيق لينفذ الرسالة ثم يعود التطبيق لإرسال الرسالة المستلمة من الـ queue إلى نظام التشغيل والسبب هنا كما ذكرناه سابقا وهو لعمل جدولة scheduling لتوقيت قراءة الرسائل في نظام التشغيل.

والآن نقرأ الكود السابق جزئياً:

(while(GetMessage(&msg, NULL, 0, 0

حلقة التكرار while السابقة تستمر بالتنفيذ طالما ان الدالة ( ) GetMessage مازالت ترجع قيمة غير الصفر والدالة ( ) GetMessage هي  API function  تقرأ الرسائل الموجودة في الـ queue الخاصة بالتطبيق وهذه الدالة لها متغيرين ..الأول هو عنوان المتغير الذي سبق وعرفناه من نوع  MSG structure والمتحوي على معلومات عن الرسالة المستقبلة وعناصر الـMSG structure  هي كالتالي :

 }typedef struct 
    HWND hwnd
    UINT message
    WPARAM wParam
    LPARAM lParam
    DWORD time
    POINT pt
 MSG {

والمتغير الثاني للدالة ( ) GetMessage هو hwnd  وهو السابق تعريفه ببداية البرنامج كـ handle للنافذة الخاصة بالرسالة المستقبلة

والمتغير الثالث والرابع لانحتاج لهما وعادة تُعبى بالصفر

وفي حالة كانت الـ message queue  خالية من الرسائل فإن الدالة ( ) GetMessage ترجع صفر وهنا تتوقف حلقة التكرار ويعود التحكم ( control ) لنظام التشغيل ( الويندوز ) ...وبداخل حلقة التكرار السابقة نستخدم دالتين كلاهما  API function  الأولى هي:

(TranslateMessage(&msg

وهذه الدالة تسمح للمستخدم بعمل حدث من لوحة المفاتيح ..فكما هو معلوم عندما يقوم المستخدم بضغط زر على لوحة المفاتيح فإن قيمة الـ scan code  للزر المضغوط هي المستقبلة في نظام التشغيل والدالة ( ) TranslateMessage هي المسئولة عن تحويل الرقم المستقبل من ضغطة الزر ( scan code ) إلى ( ascii code ) ولها متغير واحد فقط هو عنوان الرسالة الناتجة من الحدث.

(DispatchMessage(&msg

وبالنسبة للدالة ( ) DispatchMessage فإنها تعيد الرسالة التي تم إستقبالها في الدالة ( ) GetMessage  إلى نظام التشغيل ( الويندوز ) كما تعيد التحكم ( control ) إلى نظام التشغيل ليقوم هو بعد ذلك بإرسال رسالة لتنفيذ الحدث للدالة ( ) WindowFunc  والتي يُعد دائما الكود المراد تنفيذه   و الحدث المطلوب يكتب في هذه الدالة.

والآن ننتقل لشرح الدالة الثانية في البرنامج وهي ( ) WindowFunc  وهذه الدالة كما سبق ووضحت تشمل على switch statement تختبر بها الرسالة التي تصلها وعلى أساسها يتم تنفيذ الحدث المطلوب حسب ماراده المبرمج ويتم إستدعاء هذه الدالة من نظام التشغيل ( الويندوز ) والدالة هذه ليست دالة قياسية بمعنى انه يمكن للمبرمج تغيير اسمها كيفما شاء مع الحفاظ على القيمة المرجعة ونوعها والمتغيرات المرسلة.

 (LRESULT CALLBACK WindowFunc(HWND hwnd, UINT message,WPARAM wParam, LPARAM lParam

بالسطر السابق يبدأ تعريف الدالة ( ) WindowFunc وكما نلاحظ فإن  لها قيمة مرجعة هي LRESULT  وهي من نوع ( long integer ) كما ان لها  calling convenrion  من اشهر الأنواع الموجودة بالنظام وهو CALLBACK  ويستخدم لإعلام المترجم ( compiler ) بأن هذه الدالة تم إستدعائها بواسطة نظام التشغيل وكما نلاحظ فهذه الدالة لها اربعة متغيرات هي كالتالي:

hwnd  وهو كما سبق ووضحت handle للنافذة الحالية التي ننشأها.

message وهي الرسالة المستقبلة بالدالة.

wParam , lParam  هذين المتغيرين يحتويان على معلومات إضافية عن الرسالة الخاصة بالتطبيق شاملة أرقام الـ scan code  والـ ascii code  وقيم أخرى لتحديد الزر المضغوط .

وبداخل الدالة ( ) WindowFunc كما وضحت يتم إختبار الرسالة ففي حالة برنامجنا فإن الوظيفة الوحيدة المستقبلة من لوحة المفاتيح هي عملية إغلاق النافذة والرسالة الناتجة عن ضغط الأزرار الخاصة بغلق النافذة من لوزحة المفاتيح هي WM_DESTROY ( اي في حالة ضغط المستخدم على ( Alt+F4 ))

} (switch(message
 : case WM_DESTROY
(PostQuitMessage(0
break

ففي حالة أردنا غلق النافذة فإن الدالة المستخدمة لهذا الحدث هي ( ) PostQuitMessage وهي دالة عند استدعئها تنتج لنا الرسالة WM_QUIT  وترسلها للدالة( ) GetMessage  الموجودة في الـWinMain  وتسبب إنهاء البرنامج وإغلاقه.

(default :  return DefWindowProc(hwnd, message, wParam, lParam

وفي حالة عدم ضغط المستخدم لأي زر على لوحة المفاتيح فإنه يتم عمل تمرير للدالة    لنظام التشغيل ... كذلك في حالة رغبة المستخدم في إضافة أحداث للبرنامج فإن إضافتها تتم في الدالة ( ) WindowFunc  بداخل الـ switch statement  وليس في الـ WinMain .

وبالتالي نكون قد انتهينا من شرح الكود الخاص ببناء نافذة في نظام الويندوز وتقريبا هذا هو الجزء الذي أردت شرحه ... وبالله التوفيق