【MangoGUI控件系列教程】MangoGUI Tut01_CreateWindwos 建立窗体

夜行的猫仔

需要使用MangoGUI创建创建窗体有两种方法：
一种是自己创建窗口将MangoGUI绑定到自己创建的窗口上，另外一个方法是通过MangoGUI创建，这两种方法创建得到的都是标准win32 API 窗口。大家可以根据自己的项目需求选用创建模式。这里给大家讲如何使用MangoGUI创建新窗体。

首先创建新的win32窗口工程。在项目属性的连接器属性中添加如下库：

1. dxerr.lib
   
2. dxguid.lib
   
3. d3dx9d.lib
   
4. d3d9.lib
   
5. winmm.lib
   
6. comctl32.lib
   
7. ..\MangoInterface\lib\MangoGUI2005_lib.lib

复制代码

其中最后一个库是通过源代码MangoGUI编译生成的lib静态库文件，路径可以自行修改。

以下是窗体创建完整代码：

1. <font size="1">//=============================================================================
   
2. // Desc: Direct3D应用程序框架
   
3. //=============================================================================
   
4. #include "../MangoInterface/interface/Mango.h"
   
5. //-----------------------------------------------------------------------------
   
6. // 全局变量
   
7. //-----------------------------------------------------------------------------
   
8. 
   
9. 
   
10. //-----------------------------------------------------------------------------
    
11. // Desc: 函数声明
    
12. //------------------------------------------------------------------------------
    
13. bool    CALLBACK IsDeviceAcceptable( D3DCAPS9* pCaps, D3DFORMAT AdapterFormat, D3DFORMAT BackBufferFormat, bool bWindowed, void* pUserContext );
    
14. bool    CALLBACK ModifyDeviceSettings( MANGODeviceSettings* pDeviceSettings, const D3DCAPS9* pCaps, void* pUserContext );
    
15. void    CALLBACK OnFrameRender( IDirect3DDevice9* pd3dDevice, double fTime, float fElapsedTime, void* pUserContext );
    
16. //-----------------------------------------------------------------------------
    
17. // Desc: 入口函数
    
18. //-----------------------------------------------------------------------------
    
19. INT WINAPI WinMain( HINSTANCE, HINSTANCE, LPSTR, int )
    
20. {
    
21.         //为Debug配置启用运行时内存检查功能
    
22. #if defined(DEBUG) | defined(_DEBUG)
    
23.         _CrtSetDbgFlag( _CRTDBG_ALLOC_MEM_DF | _CRTDBG_LEAK_CHECK_DF );
    
24. #endif
    
25. 
    
26.         //初始化MANGO, 创建窗口, 创建Direct3D设备对象
    
27.         MANGOSetFrameRender( OnFrameRender );
    
28. 
    
29. 
    
30.         MANGOInit( );
    
31.         MANGOCreateWindow( L"MangoGUI System  v 0.1.53" );
    
32.         MANGOCreateDevice( D3DADAPTER_DEFAULT, true, 640, 480, IsDeviceAcceptable, ModifyDeviceSettings );
    
33. 
    
34.         //进入消息循环和场景渲染
    
35.         MANGOMainLoop();
    
36. 
    
37.         //在此进行应用程序相关的清除工作
    
38. 
    
39.         return MANGOGetExitCode();
    
40. }
    
41. 
    
42. 
    
43. //-----------------------------------------------------------------------------
    
44. // Desc: 设备能力检查
    
45. //-----------------------------------------------------------------------------
    
46. bool CALLBACK IsDeviceAcceptable( D3DCAPS9* pCaps, D3DFORMAT AdapterFormat,
    
47.                                                                  D3DFORMAT BackBufferFormat, bool bWindowed,
    
48.                                                                  void* pUserContext )
    
49. {
    
50.         IDirect3D9* pD3D = MANGOGetD3DObject();
    
51.         if( FAILED( pD3D->CheckDeviceFormat( pCaps->AdapterOrdinal, pCaps->DeviceType,
    
52.                 AdapterFormat, D3DUSAGE_QUERY_POSTPIXELSHADER_BLENDING,
    
53.                 D3DRTYPE_TEXTURE, BackBufferFormat ) ) )
    
54.                 return false;
    
55. 
    
56.         return true;
    
57. }
    
58. 
    
59. 
    
60. //-----------------------------------------------------------------------------
    
61. // Desc: 修改Direct3D渲染设备设置
    
62. //-----------------------------------------------------------------------------
    
63. bool CALLBACK ModifyDeviceSettings( MANGODeviceSettings* pDeviceSettings,
    
64.                                                                    const D3DCAPS9* pCaps, void* pUserContext )
    
65. {
    
66.         pDeviceSettings->pp.PresentationInterval = D3DPRESENT_INTERVAL_IMMEDIATE;
    
67.         //如果不支持硬件顶点处理则使用软件顶点处理
    
68.         if( (pCaps->DevCaps & D3DDEVCAPS_HWTRANSFORMANDLIGHT) == 0)
    
69.         {
    
70.                 pDeviceSettings->BehaviorFlags = D3DCREATE_SOFTWARE_VERTEXPROCESSING;
    
71.         }
    
72. 
    
73.         //如果使用参考设备,则弹出警告对话框
    
74.         static bool s_bFirstTime = true;
    
75.         if( s_bFirstTime )
    
76.         {
    
77.                 s_bFirstTime = false;
    
78.                 if( pDeviceSettings->DeviceType == D3DDEVTYPE_REF )
    
79.                         MANGODisplaySwitchingToREFWarning();
    
80.         }
    
81. 
    
82.         return true;
    
83. }
    
84. 
    
85. //-----------------------------------------------------------------------------
    
86. // Desc: 渲染场景
    
87. //-----------------------------------------------------------------------------
    
88. void CALLBACK OnFrameRender( IDirect3DDevice9* pd3dDevice, double fTime,
    
89.                                                         float fElapsedTime, void* pUserContext )
    
90. {
    
91.         HRESULT hr;
    
92.         //清除后台颜色缓冲区和深度缓冲区
    
93.         V( pd3dDevice->Clear(0, NULL, D3DCLEAR_TARGET | D3DCLEAR_ZBUFFER,
    
94.                 D3DCOLOR_ARGB(0, 45, 50, 170), 1.0f, 0) );
    
95. 
    
96.         //渲染场景
    
97.         if( SUCCEEDED( pd3dDevice->BeginScene() ) )
    
98.         {
    
99.                 //渲染文本和控件
    
100.                 MANGO_BeginPerfEvent( MANGO_PERFEVENTCOLOR, L"HUD / Stats" );
     
101.                 MANGO_EndPerfEvent();
     
102. 
     
103.                 V( pd3dDevice->EndScene() );
     
104.         }
     
105. }</font>
     

复制代码

接下来详细解释每一段代码的意义：

1.头文件

1. //=============================================================================
   
2. // Desc: Direct3D应用程序框架
   
3. //=============================================================================
   
4. #include "../MangoInterface/interface/Mango.h"
   
5. //-----------------------------------------------------------------------------

复制代码

头文件中首先调用了MangoGUI的接口文件“Mango.h“。在GUI中需要调用的控件都从这个接口中获取。

2.定义GUI系统回调函数

1. bool    CALLBACK IsDeviceAcceptable( D3DCAPS9* pCaps, D3DFORMAT AdapterFormat, D3DFORMAT BackBufferFormat, bool bWindowed, void* pUserContext );
   
2. bool    CALLBACK ModifyDeviceSettings( MANGODeviceSettings* pDeviceSettings, const D3DCAPS9* pCaps, void* pUserContext );
   
3. void    CALLBACK OnFrameRender( IDirect3DDevice9* pd3dDevice, double fTime, float fElapsedTime, void* pUserContext );

复制代码

MangoGUI提供了丰富的接口函数，这些函数全是依靠回调机制调用的，我们先接触其中的三个函数：IsDeviceAcceptable，ModifyDeviceSettings和OnFrameRender。

IsDeviceAcceptable函数设备初始化的时候调用，在创建某个Direct3D渲染设备之前，如果需要对渲染设备的特征进行检查，查看设备是否支持需要的功能，可将检查代码写在函数IsD3D9DeviceAcceptable()中。

在某个渲染设备创建之前，如果需要修改该渲染设备的设置，可将代码写在函数ModifyDeviceSettings()中。MangoGUI接下来就根据设置（或者是默认设置）创建最适合当前硬件的Direct3D渲染设备。例如，当硬件不支持某些功能时，可以通过使用参考设备进行模拟，设置使用参考设备代码通常写在该函数中。

OnFrameRender函数 就是标准dx中的Render函数的步骤，也就是绘制窗口中的蓝色背景的部分。这个函数在以后我们将详细讲。

3.WinMain函数是入口函数。

1. INT WINAPI WinMain( HINSTANCE, HINSTANCE, LPSTR, int )

复制代码

在开始将OnFrameRender函数设定为MangoGUI渲染回调。
接下来MANGOInit();初始化窗口属性类型。
MANGOCreateWindow( L"MangoGUI System  v 0.1.53" );设定创建窗口的窗口标题。
MANGOCreateDevice(D3DADAPTER_DEFAULT, true, 640, 480, IsDeviceAcceptable, ModifyDeviceSettings)这里才是真正的设定d3dpp属性的地方，其中后面两个参数是设定的两个回调函数。

MANGOMainLoop();这里才是处理消息循环的地方。这里几乎不用管。
最后是MANGOGetExitCode()程序返回代码。

MANGOGUI是一个框架程序 ，一旦框架搭设完毕，就在框架中添加代码或者类就可以了，非常方便。