DirectX/Creare la finestra: differenze tra le versioni

== main ==

Dimenticate il caro vecchio ''main''. Quando si programma Win32 si usa '''WinMain'''. Un entry point di esempio è:

#include <Windows.h>

 

return 0;

}

Argomenti:

* '''hInstance''' è un HANDLE, ossia un codice che identifica l'applicazione (una specie di Process ID - pid)

=== Creazione della struttura ===

La struttura da creare è WNDCLASSEX. In questa struttura (detta classe) è contenuto quasi tutto il necessario a generare una finestra.

struct WNDCLASSEX

{

HICON hIconSm;

};

* '''cbSize''' deve essere impostato a sizeof(WNDCLASSEX). Questo permette in futuro l'espansione della struttura stessa, mantenendo retrocompatibilità.

* '''style''' imposta alcuni parametri secondari della finestra. Generalmente useremo ''CS_HREDRAW | CS_VREDRAW''. Questa impostazione chiede a Windows di ridisegnare la finestra in caso di modifiche all'altezza ed alla larghezza.

 

Riempiamo ora questa struttura:

WNDCLASSEX wc;

ZeroMemory(&wc, sizeof(WNDCLASSEX));

wc.lpszClassName = L"DxTutorial1";

wc.hIconSm = NULL;

'''ZeroMemory''' è la nostra prima API Win32. Non fa nient'altro che azzerare la memoria di una data struttura. Infatti:

#define ZeroMemory(Destination, Length) memset(Destination, 0, Length);

'''LoadIcon''' e '''LoadCursor''' vengono usate per generare HANDLE a icona e cursore partendo dal nome del file. In questo caso però anzichè usare il nome del file abbiamo usato delle costanti che rispondono a icone e cursori predefiniti. IDI_APPLICATION è l'icona di programma generico. IDC_ARROW è la freccia. Un altro cursore predefinito è IDC_WAIT (la clessidra fino a Windows XP, il cerchio blu di caricamento da Windows Vista in poi). Ultima particolarità: la '''L''' davanti a "DxTutorial1". Quella L indica al compilatore di codificare la stringa in UTF-16 e non come semplice stringa di ''char''.

 

A questo punto dobbiamo dare questi dati a Windows. Windows infatti terrà nella sua memoria interna questa struttura a cui noi ci riferiremo solo tramite il valore contenuto in ''lpszClassName'', o tramite il valore restituito da questa chiamata. Per dare in pasto questa struttura a Windows:

ATOM res = RegisterClassEx(&wc);

if (!res)

return -1;

}

ATOM è un valore a 16bit che identifica internamente a Windows il valore di lpszClassName. Come se fosse un indice in un array di stringhe che contengono ''ClassName''s. A questo punto usare il valore dato da RegisterClassEx o il valore lpszClassName è equivalente. A noi basta sapere però che se il suo valore è 0, c'è stato un errore e che non si può andare avanti finché non l'avrete corretto.

 

=== Creare la finestra ===

Creiamo ora la finestra usando la classe appena registrata. La funzione da usare è:

HWND WINAPI CreateWindow(LPCTSTR lpClassName, LPCTSTR lpWindowName, DWORD dwStyle, int x, int y, int nWidth, int nHeight, HWND hWndParent, HMENU hMenu, HINSTANCE hInstance, LPVOID lpParam);

Non lasciamoci spaventare dal numero di argomenti (c'è di peggio in Direct3D) e vediamo cosa inserire:

* '''lpClassName''' qui andrà messo il valore lpszClassName della classe oppure il valore ''res'' ritornato da ''RegisterClassEx'' (con un cast a LPCTSTR)

 

Quindi:

HWND windowHandle = CreateWindow(L"DxTutorial1", L"Titolo della finestra", WS_OVERLAPPEDWINDOW, CW_USEDEFAULT, CW_USEDEFAULT, 800, 600, NULL, NULL, hInstance, NULL);

// In alternativa se preferite usare l'atom al posto della ClassName:

HWND windowHandle = CreateWindow((LPCTSTR) res, L"Titolo della finestra", WS_OVERLAPPEDWINDOW, CW_USEDEFAULT, CW_USEDEFAULT, 800, 600, NULL, NULL, hInstance, NULL);

 

=== Mostrare la finestre ===

A questo punto dopo aver creato la finestra non ci resta che mostrarla con:

ShowWindow(HWND hWnd, int nCmdShow);

* '''hWnd''' è l'HANDLE alla finestra appena creata.

* '''nCmdShow''' indica come la finestra deve essere mostrata (ridotta ad icona, massimizzata, ecc.). Normalmente qui andrebbe passato l'argomento a WinMain ''nCmdShow'', ma noi abbiamo deciso di ignorare quel valore e passeremo SW_SHOWDEFAULT, che mostra una normalissima finestra davanti a voi.

 

Quindi:

ShowWindow(windowHandle, SW_SHOWDEFAULT);

 

== Conclusione ==

 

Ecco il codice completo di questo modulo:

#include <Windows.h>

#include <stdio.h>

return 0;

}

 

[[Categoria:DirectX|Creare la finestra]]