天行健 君子當自強而不息

控件是用戶接口的重要組成部分，為了便于用戶操作，為程序界面添加各種控件是非常好的方法。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設備設置對話框，如下圖所示：

主程序：

下載示例工程