Realizzazione di una Finestra con le API Windows
Mer 03 Ott 2007

Invia Articolo

Il tuo nome (your name)
*

La tua email (your email)
*

Email Destinatario (dest email)
*

Inserire il codice
(c'è distinzione tra maiuscole
e minuscole)

Nuovo Codice (New Code)
*
(*) Campi Obbligatori (Required fields)

Messaggio (opzionale)


"> ">

Una Semplice Finestra

1. #include <windows.h>
2.  
3. LRESULT CALLBACK WndProc(HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam)
4. {
5. switch(msg)
6. {
7. case WM_CLOSE: DestroyWindow(hwnd); break;
8. case WM_DESTROY: PostQuitMessage(0); break;
9. default: return DefWindowProc(hwnd, msg, wParam, lParam);
10. }
11. return 0;
12. }
13.  
14. int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance,
15. LPSTR lpCmdLine, int nCmdShow)
16. {
17. WNDCLASSEX wc;
18. HWND handle;
19. MSG message;
20.  
21. //Registrazione della Window Class
22. wc.cbSize = sizeof(WNDCLASSEX);
23. wc.style = 0;
24. wc.lpfnWndProc = WndProc;
25. wc.cbClsExtra = 0;
26. wc.cbWndExtra = 0;
27. wc.hInstance = hInstance;
28. wc.hIcon = LoadIcon(NULL, IDI_APPLICATION);
29. wc.hCursor = LoadCursor(NULL, IDC_ARROW);
30. wc.hbrBackground = (HBRUSH)(COLOR_WINDOW+1);
31. wc.lpszMenuName = NULL;
32. wc.lpszClassName = "simplewin";
33. wc.hIconSm = LoadIcon(NULL, IDI_APPLICATION);
34.  
35. if(!RegisterClassEx(&wc))
36. {
37. MessageBox(NULL, "Registrazione della Finestra Fallita!", "Errore!",
38. MB_ICONEXCLAMATION | MB_OK);
39. return 0;
40. }
41.  
42. // Creazione della finestra
43. // Una volta registrata la classe si passa a costruire la finestra.
44. handle = CreateWindowEx(WS_EX_CLIENTEDGE, "simplewin",
45. "Titolo della mia finestra", WS_OVERLAPPEDWINDOW, CW_USEDEFAULT,
46. CW_USEDEFAULT, 340, 120,NULL, NULL, hInstance, NULL);
47.  
48. // si verifica se la finestra è stata creata verificando se l'handle è valido
49. if(handle == NULL)
50. {
51. MessageBox(NULL, "Creazione della Finestra Fallita!", "Errore!",
52. MB_ICONEXCLAMATION | MB_OK);
53. return 0;
54. }
55.  
56. ShowWindow(handle, nCmdShow); // Si visualizza la finestra
57. UpdateWindow(handle); // si aggiorna la finestra
58.  
59. // Ci si pone in ascolto dei messaggi verso la finestra
60. while(GetMessage(&message, NULL, 0, 0) > 0)
61. {
62. TranslateMessage(&message);
63. DispatchMessage(&message);
64. }
65.  
66. return message.wParam; // exit value restituito al sistema
67. }

Figura 6. Una Semplice Finestra.

• si definiscono tre variabili
  • la variabile wc di tipo WNDCLASSEX, che conterrà delle informazioni sulla finestra che si vuole costruire;
  • la variabile handle di tipo HWND (Window Handle), che conterrà l’handle della finestra che si vuole costruire;
  • la variabile message di tipo MSG;
  
  
  
  18. WNDCLASSEX wc;
  19. HWND handle;
  20. MSG message;
  
  
• si definiscono le proprietà della finestra fissando i campi della variabile wc
  
  
  23. wc.cbSize = sizeof(WNDCLASSEX);
  24. wc.style = 0;
  25. wc.lpfnWndProc = WndProc;
  26. wc.cbClsExtra = 0;
  27. wc.cbWndExtra = 0;
  28. wc.hInstance = hInstance;
  29. wc.hIcon = LoadIcon(NULL, IDI_APPLICATION);
  30. wc.hCursor = LoadCursor(NULL, IDC_ARROW);
  31. wc.hbrBackground = (HBRUSH)(COLOR_WINDOW+1);
  32. wc.lpszMenuName = NULL;
  33. wc.lpszClassName = "simplewin";
  34. wc.hIconSm = LoadIcon(NULL, IDI_APPLICATION);
  
  
• una volta definita la finestra la si deve registrare. Questo si fa tramite l’istruzione RegisterClassEx
  
  
  36. if(!RegisterClassEx(&wc))
  37. {
  38. MessageBox(NULL, "Registrazione della Finestra Fallita!", "Errore!",
  39. MB_ICONEXCLAMATION | MB_OK);
  40. return 0;
  41. }
  
  
• viene creata la finestra tramite l’istruzione CreateWindowEx
  
  
  45. handle = CreateWindowEx(WS_EX_CLIENTEDGE, "simplewin",
  46. "Titolo della mia finestra", WS_OVERLAPPEDWINDOW, CW_USEDEFAULT,
  47. CW_USEDEFAULT, 340, 120,NULL, NULL, hInstance, NULL);
  
  
• si verifica se la finestra è stata creata verificando se l’handle è valido
  
  
  50. if(handle == NULL)
  51. {
  52. MessageBox(NULL, "Creazione della Finestra Fallita!", "Errore!",
  53. MB_ICONEXCLAMATION | MB_OK);
  54. return 0;
  55. }
  
  
• si visualizza la finestra tramite l’istruzione ShowWindow, e la si ridisegna tramite l’istruzione UpdateWindow
  
  
  57. ShowWindow(handle, nCmdShow); // Si visualizza la finestra
  58. UpdateWindow(handle); // si aggiorna la finestra
  
  
• si entra in un ciclo in cui si accettano tutti i messaggi diretti alla finestra e li si invia alla funzione WndProc che li processerà
  
  
  61. while(GetMessage(&message, NULL, 0, 0) > 0)
  62. {
  63. TranslateMessage(&message);
  64. DispatchMessage(&message);
  65. }
  
  tramite la funzione GetMessage ci si pone in ascolto e in attesa di un messaggio inviato verso la finestra. Non appena arriva un messaggio questo viene tradotto tramite la funzione TranslateMessage (il segnale che arriva, dal sistema operativo, viene tradotto in un valore che consentirà poi alla procedura WndProc di processarli). Il messaggio tradotto viene passato, tramite l'istruzione DispatchMessage, alla funzione WndProc che provvederà a processarlo.
  Il programma resterà in ascolto, tramite la funzione GetMessage, fino a quando non si verificherà un errore, nel qual caso la GetMessage restituirà il valore -1, o fino a quando non sarà prelevato dalla coda dei messaggi il messaggio WM_QUIT, nel qual caso la GetMessage restituirà il valore 0.
  Quindi finché il valore restituito dalla GetMessage sarà maggiore di zero il programma resterà in ascolto.
• si definisce la funzione WndProc che si occuperà di processare tutti i messaggi in arrivo per la finestra.
  
  
  3. LRESULT CALLBACK WndProc(HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam)
  4. {
  5. switch(msg)
  6. {
  7. case WM_CLOSE: DestroyWindow(hwnd); break;
  8. case WM_DESTROY: PostQuitMessage(0); break;
  9. default: return DefWindowProc(hwnd, msg, wParam, lParam);
  10. }
  11. return 0;
  12. }
  
  La funzione riceve i messaggi inviati da DispatchMessage e li processa. La funzione è definibile dall'utente che potrà decidere il comportamento da seguire in corrispondenza ai vari possibili messaggi che si possono ricevere.
  Nell'esempio qui proposto la funzione riceve il messaggio msg, quindi se il messaggio è WM_CLOSE (è stato premuto il close button) la finestra viene chiusa invocando la funzione DestroyWindow passandogli come parametro l'handle della finestra, se il messaggio è WM_DESTROY (la finestra è stata chiusa) viene specificato l'exit code dell'applicazione invocando la funzione PostQuitMessage.
  In caso arrivi un qualsiasi altro messaggio viene richiamata la funzione DefWindowProc a cui vengono passati gli stessi parametri della funzione WndProc.