天行健 君子当自强而不息

控件是用户接口的重要组成部分，为了便于用户操作，为程序界面添加各种控件是非常好的方法。DXUT框架为在Direct3D程序中添加各种控件提供了支持。为了便于加载控件和处理各控件的消息，通常先在窗口中加载对话框，然后在对话框中添加响应的控件，由对话框来管理控件。为了统一管理各个对话框，还需要定义对话框资源管理器类CDXUTDialogResourceManager的一个对象，在程序开始时，调用各个对话框的Init函数和对话框资源管理对象进行初始化：

CDXUTDialogResourceManager g_dlg_resource_manager;
CD3DSettingsDlg g_settings_dlg;
CDXUTDialog g_button_dlg;
CDXUTDialog g_control_dlg;

g_settings_dlg.Init(&g_dlg_resource_manager);
g_button_dlg.Init(&g_dlg_resource_manager);
g_control_dlg.Init(&g_dlg_resource_manager);

需要注意的是，对话框类CD3DSettingsDlg是Direct3D封装好的一个专门用于Direct3D渲染设备设置的对话框类，其中的控件已经都加载好了，同时各个控件将如何响应用户的输入Direct3D也已经实现了。在此只需对它的对象实例g_settings_dlg进行相应的初始化，并在程序退出前释放对应的资源即可。

g_button_dlg和g_control_dlg是两个标准的DXUT对话框，它们中没有任何控件，可以把它们看作两个装载控件的容器。其初始化包括三项内容：设置对话框控件消息处理回调函数、添加控件、设置对话框位置和大小。

设置对话框控件消息处理回调函数、添加控件的代码如下所示：

g_button_dlg.SetCallback(OnGUIEvent);

int x = 35, y = 10, width = 125, height = 22;

g_button_dlg.AddButton(IDC_TOGGLE_FULLSCREEN, L"Toggle full screen", x, y, width, height);
g_button_dlg.AddButton(IDC_TOGGLE_REF, L"Toggle REF (F3)", x, y += 24, width, height);
g_button_dlg.AddButton(IDC_CHANGE_DEVICE, L"Change device (F2)", x, y += 24, width, height, VK_F2);

g_button_dlg.SetCallback(OnGUIEvent);

y = 10;

g_control_dlg.AddComboBox(IDC_COMBO, x, y += 24, width, height);
g_control_dlg.GetComboBox(IDC_COMBO)->AddItem(L"Text1", NULL);
g_control_dlg.GetComboBox(IDC_COMBO)->AddItem(L"Text2", NULL);
g_control_dlg.GetComboBox(IDC_COMBO)->AddItem(L"Text3", NULL);
g_control_dlg.GetComboBox(IDC_COMBO)->AddItem(L"Text4", NULL);

g_control_dlg.AddCheckBox(IDC_CHECK_BOX_1, L"CheckBox1", x, y += 24, width, height);
g_control_dlg.AddCheckBox(IDC_CHECK_BOX_2, L"CheckBox2", x, y += 24, width, height);

g_control_dlg.AddRadioButton(IDC_RADIO_1, IDC_RADIO_GROUP_1, L"Radio1G1", x, y += 24, width, height);
g_control_dlg.AddRadioButton(IDC_RADIO_2, IDC_RADIO_GROUP_1, L"Radio2G1", x, y += 24, width, height);
g_control_dlg.AddRadioButton(IDC_RADIO_3, IDC_RADIO_GROUP_1, L"Radio3G1", x, y += 24, width, height);
g_control_dlg.GetRadioButton(IDC_RADIO_3)->SetChecked(true);

g_control_dlg.AddButton(IDC_BUTTON_1, L"Button1", x, y += 24, width, height);
g_control_dlg.AddButton(IDC_BUTTON_2, L"Button2", x, y += 24, width, height);

g_control_dlg.AddRadioButton(IDC_RADIO_4, IDC_RADIO_GROUP_2, L"Radio1G2", x, y += 24, width, height);
g_control_dlg.AddRadioButton(IDC_RADIO_5, IDC_RADIO_GROUP_2, L"Radio2G2", x, y += 24, width, height);
g_control_dlg.GetRadioButton(IDC_RADIO_5)->SetChecked(true);

g_control_dlg.AddSlider(IDC_SLIDER, 50, y += 24, 100, height);
g_control_dlg.GetSlider(IDC_SLIDER)->SetRange(0, 100);
g_control_dlg.GetSlider(IDC_SLIDER)->SetValue(50);

g_control_dlg.AddEditBox(IDC_EDIT, L"Test", x, y += 24, width, 32);

设置对话框位置和大小的代码如下所示：

// set dialog position and size

g_button_dlg.SetLocation(pBackBufferSurfaceDesc->Width - 170, 0);
g_button_dlg.SetSize(170, 170);

g_control_dlg.SetLocation(pBackBufferSurfaceDesc->Width - 170, pBackBufferSurfaceDesc->Height - 350);
g_control_dlg.SetSize(170, 300);

因为上面的代码用到了与对话框和控件相关的几个类，所以需要将实现这几个类的源文件添加到工程项目中，具体包括4个文件：DXUTgui.h、DXUTgui.cpp、DXUTSettingsDlg.h和DXUTSettingsDlg.cpp，这4个文件位于当前目录的common目录下。

渲染控件

在主程序的OnFrameRender()回调函数中，调用各个对话框的OnRender()函数对各个对话框进行渲染，代码如下：

//--------------------------------------------------------------------------------------
// Render the scene 
//--------------------------------------------------------------------------------------
void CALLBACK OnFrameRender( IDirect3DDevice9* pd3dDevice, double fTime, float fElapsedTime, void* pUserContext )
{
    HRESULT hr;

	if(g_settings_dlg.IsActive())
	{
		g_settings_dlg.OnRender(fElapsedTime);
		return;
	}

    // Clear the render target and the zbuffer 
    V( pd3dDevice->Clear(0, NULL, D3DCLEAR_TARGET | D3DCLEAR_ZBUFFER, D3DCOLOR_ARGB(0, 0, 0, 0), 1.0f, 0) );

    // Render the scene
    if( SUCCEEDED( pd3dDevice->BeginScene() ) )
    {
		RenderText();

		V(g_button_dlg.OnRender(fElapsedTime));
		V(g_control_dlg.OnRender(fElapsedTime));

        V( pd3dDevice->EndScene() );
    }
}

处理控件消息

当在应用程序的窗口中单击鼠标或触发其他事件时，先由对话框资源管理器对象g_dlg_resource_manager处理全局消息以更新GUI，然后进入各个对话框的消息处理函数：

//--------------------------------------------------------------------------------------
// Handle messages to the application 
//--------------------------------------------------------------------------------------
LRESULT CALLBACK MsgProc( HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam, 
                          bool* pbNoFurtherProcessing, void* pUserContext )
{
	*pbNoFurtherProcessing = g_dlg_resource_manager.MsgProc(hWnd, uMsg, wParam, lParam);
	if(*pbNoFurtherProcessing)
		return 0;

	if(g_settings_dlg.IsActive())
	{
		g_settings_dlg.MsgProc(hWnd, uMsg, wParam, lParam);
		return 0;
	}

	*pbNoFurtherProcessing = g_button_dlg.MsgProc(hWnd, uMsg, wParam, lParam);
	if(*pbNoFurtherProcessing)
		return 0;

	*pbNoFurtherProcessing = g_control_dlg.MsgProc(hWnd, uMsg, wParam, lParam);
	if(*pbNoFurtherProcessing)
		return 0;

    return 0;
}

g_settings_dlg对于自己消息的处理Direct3D已经封装好了，需要做的工作就是在回调函数OnGUIEvent()中处理对话框的消息。

//--------------------------------------------------------------------------------------
// Handle events for controls
//--------------------------------------------------------------------------------------
void CALLBACK OnGUIEvent(UINT event, int control_id, CDXUTControl* control, void* user_context)
{
	switch(control_id)
	{
	case IDC_TOGGLE_FULLSCREEN:
		DXUTToggleFullScreen();
		break;

	case IDC_TOGGLE_REF:
		DXUTToggleREF();
		break;

	case IDC_CHANGE_DEVICE:
		g_settings_dlg.SetActive(true);
		break;
	}
}

释放对话框

在程序退出前需要释放各个对话框所占用的资源：

//--------------------------------------------------------------------------------------
// Release resources created in the OnResetDevice callback here 
//--------------------------------------------------------------------------------------
void CALLBACK OnLostDevice( void* pUserContext )
{
	g_dlg_resource_manager.OnLostDevice();
	g_settings_dlg.OnLostDevice();
	g_font->OnLostDevice();
	release_com(g_text_sprite);
}

//--------------------------------------------------------------------------------------
// Release resources created in the OnCreateDevice callback here
//--------------------------------------------------------------------------------------
void CALLBACK OnDestroyDevice( void* pUserContext )
{
	g_dlg_resource_manager.OnDestroyDevice();
	g_settings_dlg.OnDestroyDevice();
	release_com(g_font);
}

在程序运行时，单击窗口上的【Toggle Full Screen】按钮，可切换到全屏模式下。单击窗口上的【Toggle REF】按钮，可切换到参考设备下。按下F2键或单击窗口上的【Change Device】按钮，则显示Direct3D设备设置对话框，如下图所示：

主程序：

下载示例工程