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

الهيكل الرئيسي للبرنامج الخاص بإنشاء النوافذ والتعامل معها مع الشرح ( الجزء الأول ):

اليوم سنحاول الإطلاع على الكود الأساسي لبناء النوافذ في windows والمشتمل على الدالتين ( )WinMain والدالة ( )WindowFunc ونتطرق لشرحه بشيء من التفصيل ولكن على أجزاء إن شاء الله. لنلقي نظرة عليه:

/* A minimal windows skeleton program. */

#include

LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM);

/* name of windows class */
char szWinName[] = "MyWin";


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst,LPSTR lpszArgs, int nWinMode)
{
 
  HWND hwnd;
  MSG msg;
  WNDCLASSEX wcl;


  /* Define a window class. */
  wcl.cbSize = sizeof(WNDCLASSEX);

  wcl.hInstance = hThisInst; /* handle to this instance */

  wcl.lpszClassName = szWinName; /* window class name */

  wcl.lpfnWndProc = WindowFunc; /* window function */

  wcl.style = 0; /* default style */

  wcl.hIcon  = LoadIcon(NULL,IDI_APPLICATION);/*std icon */

  wcl.hIconSm= LoadIcon(NULL,IDI_WINLOGO);/*small icon */

  wcl.hCursor= LoadCursor(NULL,IDC_ARROW);/*cursor style */


  wcl.lpszMenuName = NULL; /* no menu */

  wcl.cbClsExtra = 0; /* no extra */

  wcl.cbWndExtra = 0; /* information needed */

  /* Make the window background white. */
  wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH);

  /* Register the window class */
  if(!RegisterClassEx(&wcl)) return 0;

 
  /* Now that a window class has been registered,
  ** a window can be created. */
  hwnd = CreateWindow(
szWinName,    /* name of window class */
"Windows Skeleton Program", /* title */
WS_OVERLAPPEDWINDOW,    /* window style:normal */
CW_USEDEFAULT, /* X coordinate - let windows decide */
CW_USEDEFAULT, /* Y coordinate - let windows decide */
CW_USEDEFAULT, /* width - let windows decide */
CW_USEDEFAULT, /* height- let windows decide */
HWND_DESKTOP, /* no parent window */
NULL,
hThisInst, /*handle of this instance of hte program */
NULL   /* no additional arguments */
  );

  /* Display the window. */
  ShowWindow(hwnd, nWinMode);
  UpdateWindow(hwnd);

  /* Create the message loop. */
  while(GetMessage(&msg, NULL, 0, 0))
  {
    TranslateMessage(&msg);/* allow use of keyboard */
DispatchMessage(&msg); /*return control to windows */
  }
  return msg.wParam;
}

/* This function is called by Windows NT and
** is passed message from the message queue.
*********************************************/

LRESULT CALLBACK WindowFunc(HWND hwnd, UINT message,
   WPARAM wParam, LPARAM lParam)
{
switch(message) {
case WM_DESTROY: /* terminate the program */
PostQuitMessage(0);
break;
default:
/* Let Windows NT process any messages
** not specified in the preceding switch
** statement. */
return DefWindowProc(hwnd, message, wParam,  lParam);
    }
return 0;
}

وبإمكانك تحميل الكود من الرابط التالي:http://www.c4arab.com/images/lessons/programming/c/Starter.c

شرح الكود:

 



• 
  
  
   
  
  
  المكتبة windows.h لابد من تضمينها في جميع برامج الويندوز وتحتوي على  API functions  والتعاريف المستخدمة في البرنامج الرئيسي.

LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM);

 



• 
  
  وهذا السطر هو declaration للدالة ( )WindowFunc وسنتطرق لشرحها بالتفصيل لاحقا.

char szWinName[] ="MyWin";

 



• 
  
  المتغير szWinName هو الإسم الذي يعرف به نظام التشغيل (الويندوز) اسم النافذة التي سأنشأها وأتعامل معها بالبرنامج.

int WINAPI WinMain(HINSTANCE   hThisInst,  HINSTANCE   hPrevInst, LPSTR   lpszArgs,  int   nWinMode); 

 



• 
  
  الدالة WinMain  هي الدالة الرئيسية بالبرنامج والتي يبدأ عندها التنفيذ والقيمة المرجعة منها هي int ولكن ماهي WINAPI؟!
  
  قبل توضيح ماهو WINAPI  فإننا نحتاج إلى توضيح مصطلح يُسمى بـ calling convention (اتفاقية إستدعاء الدوال) وهو موجهات directives للكومبايلر لترتيب الدوال بطريقة معينة في الملف (object file) ليتمكن بعد ذلك الـlinker من توليد الملف التنفيذي (exe.) والمتوافق مع نظام معين فمثلا WINAPI (والتي تُعد واحد من الـ calling convention) تعني أن الدوال التي تُعرف بواسطتها خاصة لنظام الويندوز 32 بت، فإستخدامها هنا كـdata type للدالة WinMain يخبر المترجم بأن الدالة WinMain من دوال نظام الويندوز 32 بت وأن التطبيق الذي ننشأه هو windows application.
  ويكافيء WINAPI اتفاقية استدعاء اخرى من الممكن أن تحل محلها وهي APIENTRY وكذلك PASCAL ولكن  PASCAL  تستخدم لويندوز 3.1.
  
  والدالة WinMain  كما يتضح لنا فإن لديها أربعة متغيرات هي كالتالي:
  
  
  
  
  

  
   

  
  
  1. 
     
     hThisInst: وهو handle (مقبض: type of 32 bit integer) ويشير إلى النسخة الحالية من البرنامج في الذاكرة.
     
  
  
  2. 
     
     hPrevInst : هو handle (مقبض: type of 32 bit integer)   ويشير إلى نسخة سابقة من البرنامج في الذاكرة فمثلا لو كان البرنامج قد قد سبق وقمنا بعمل run  له فإن المتغير hPrevInst يشير إلى هذه النسخة وفي حالة كانت هذه أول مرة للـ run فإن قيمة هذا المتغير =  null.
     
  
  
  3. 
     
     lpszArgs: وهو  pointer to string (مؤشر لسلسلة)ويشير إلى سطر الأوامر command line الموجود بالإختصار الخاص بالملف التنفيذي للبرنامج على سطح المكتب.
     
  
  
  4. 
     
     nWinMode: وهو عبارة عن قيمة صحيحة integer وتحدد فيه الشكل الذي تعرض فيه النافذة إما مصغرة أو مكبرة أو مخفية وبالإمكان الإطلاع على قيم هذا المتغير والتغيرات بالمذكرة بالصفحة السادسة.

HWND  hwnd;  

 



• 
  
  HWND هو handle to window (مقبض للنافذة التي سننشأها) وهو (type of 32 bit integer) ونحتاج لتعريفه بالبرنامج وذلك لحاجتنا إليه لاحقا كي نحدد به للنظام ماهو التطبيق الذي نريد عمل actions معينة عليه، فكما هو معلوم أن نظام الويندوز يعتمد اسلوب الـmultitasking  (متعدد المهام) وبالإمكان تشغيل أكثر من تطبيق بنفس الوقت فبتعريفنا لهذا المتغير نستطيع ان نحدد لنظام الويندوز التطبيق الذي نريد الحدث ان يتم عليه.

MSG  msg ;  

 



• 
  
  MSG هي structure data type  وهي تعمل كمؤشر للرسائل الخاصة بالنافذة المنشأة بالبرنامج  وهذه الـ structure سنتطرق لمحتواها لاحقا إن شاء الله.

WNDCLASSEX   wcl;   

 



• 
  
  WNDCLASSEX وهي  structure data type تحتوي على العناصر المكونة للنافذة وبواسطتها نستطيع تحديد الهيكل العام للنافذة المرسومة وسنتعرض في الدرس القادم لمحتوياتها ان شاء الله.

درس برمجة الويندوز باستخدام Win32 API function ( الدرس الثاني )