CustomUI Direct3D9_Sample

刚开始建这个项目的时候编译器报了很多Link2019的错误。

后来添加了一些lib文件才解决，参考    缺少.lib文件导致的Link2019 解决方案汇总

============================================================================================================================

Dialog::InitDefaultElements()

创建各种Element(元素，组成Control的单元)，放到CDXUTElementHolder类型的Dialog::m_DefaultElements中.

 struct DXUTElementHolder
 {
     UINT nControlType;
     UINT iElement;

     CDXUTElement Element;
 };

m_DefaultElements存放的ElementHolder根据所属控件的类型（nControlType）从小到大(0开始)编号

 //-------------------------------------
     // CDXUTButton - Button
     //-------------------------------------
     SetRect( &rcTexture, , , ,  );
     Element.SetTexture( , &rcTexture );
     Element.SetFont(  );
     Element.TextureColor.States[ DXUT_STATE_NORMAL ] = D3DCOLOR_ARGB( , , ,  );
     Element.TextureColor.States[ DXUT_STATE_PRESSED ] = D3DCOLOR_ARGB( , , ,  );
     Element.FontColor.States[ DXUT_STATE_MOUSEOVER ] = D3DCOLOR_ARGB( , , ,  );

     // Assign the Element
     SetDefaultElement( DXUT_CONTROL_BUTTON, , &Element );

     //-------------------------------------
     // CDXUTButton - Fill layer
     //-------------------------------------
     SetRect( &rcTexture, , , ,  );
     Element.SetTexture( , &rcTexture, D3DCOLOR_ARGB( , , ,  ) );
     Element.TextureColor.States[ DXUT_STATE_MOUSEOVER ] = D3DCOLOR_ARGB( , , ,  );
     Element.TextureColor.States[ DXUT_STATE_PRESSED ] = D3DCOLOR_ARGB( , , ,  );
     Element.TextureColor.States[ DXUT_STATE_FOCUS ] = D3DCOLOR_ARGB( , , ,  );

     // Assign the Element
     SetDefaultElement( DXUT_CONTROL_BUTTON, , &Element );

这段代码定义了两个Button类型的Element，编号为0和1。

如果继续添加的话编号递增。

添加另一种类型的话，编号重新从零开始。

===================================================================================================================

CDXUTControl::SetElement

 HRESULT CDXUTControl::SetElement( UINT iElement, CDXUTElement* pElement )
 {
     HRESULT hr = S_OK;

     if( pElement == NULL )
         return E_INVALIDARG;

     //m_DefaultElements中的元素同类型编号按从小到大的顺序排列
     //所以从m_DefaultElements中挑选出来的pElement的编号iElement递增（0,1,2.....）
     //某一种控件第一次调用此函数（SetElement）时，控件的m_Elements为空，将编号为0的Element存入，循环退出
     // Make certain the array is this large
     for( UINT i = m_Elements.GetSize(); i <= iElement; i++ )
     {
         CDXUTElement* pNewElement = new CDXUTElement();
         if( pNewElement == NULL )
             return E_OUTOFMEMORY;

         hr = m_Elements.Add( pNewElement );
         if( FAILED( hr ) )
         {
             SAFE_DELETE( pNewElement );
             return hr;
         }
     }

     // Update the data
     CDXUTElement* pCurElement = m_Elements.GetAt( iElement );
     *pCurElement = *pElement;

     return S_OK;
 }

===================================================================================================

Element的定义如下

 class CDXUTElement
 {
 public:
     void    SetTexture( UINT iTexture, RECT* prcTexture, D3DCOLOR defaultTextureColor = D3DCOLOR_ARGB( , , ,
                                                                                                         ) );
     void    SetFont( UINT iFont, D3DCOLOR defaultFontColor = D3DCOLOR_ARGB( , , ,
                                                                              ), DWORD dwTextFormat = DT_CENTER |
                      DT_VCENTER );

     void    Refresh();
 　　//纹理， 文本字体， 文本格式，
     UINT iTexture;          // Index of the texture for this Element
     UINT iFont;             // Index of the font for this Element
     DWORD dwTextFormat;     // The format argument to DrawText
 　　// 放纹理的边界矩形
     RECT rcTexture;         // Bounding rect of this element on the composite texture
 　　//纹理和文本的Blend颜色， Blend分量用于控制透明度
     DXUTBlendColor TextureColor;
     DXUTBlendColor FontColor;
 };

======================================================================================================

可以使用输入法(Input Method Editor)的IMEEditBox

 //已经定义了g_SampleUI
     CDXUTDialog                 g_SampleUI;             // dialog for sample specific controls
     g_SampleUI.Init( &g_DialogResourceManager );
     g_SampleUI.SetCallback( OnGUIEvent );
 // IME-enabled edit box
     CDXUTIMEEditBox* pIMEEdit;
     CDXUTIMEEditBox::InitDefaultElements( &g_SampleUI );
     if( SUCCEEDED( CDXUTIMEEditBox::CreateIMEEditBox( &g_SampleUI, IDC_EDITBOX2,
                                                       L"IME-capable edit control with custom styles. Type and press Enter", , , , , false, &pIMEEdit ) ) )
     {
         g_SampleUI.AddControl( pIMEEdit );
         pIMEEdit->GetElement(  )->iFont = ;
         pIMEEdit->GetElement(  )->iFont = ;
         pIMEEdit->GetElement(  )->iFont = ;
         pIMEEdit->GetElement(  )->TextureColor.Init( D3DCOLOR_ARGB( , , ,  ) );  // Transparent center
         pIMEEdit->SetBorderWidth(  );
         pIMEEdit->SetTextColor( D3DCOLOR_ARGB( , , ,  ) );
         pIMEEdit->SetCaretColor( D3DCOLOR_ARGB( , , ,  ) );
         pIMEEdit->SetSelectedTextColor( D3DCOLOR_ARGB( , , ,  ) );
         pIMEEdit->SetSelectedBackColor( D3DCOLOR_ARGB( , , ,  ) );
     }

CDXUTIMEEditBox继承自CDXUTEditBox， 定义在DXUTguiIME.h/cpp文件中

包含了静态函数:

static void             InitDefaultElements( CDXUTDialog* pDialog );

负责为该类定义所使用的Element(元素),并通过

HRESULT CDXUTDialog::SetDefaultElement( UINT nControlType, UINT iElement, CDXUTElement* pElement );

添加到所属Dialog的默认元素表（m_DefaultElements）中,  一共9个Element

Please refer to DXUTguiIME.h/cpp  for more details  .

=-=========================================================================================================================

单选列表框                                                     多选列表框

                           

 class CDXUTListBox : public CDXUTControl
 {
 public:
                     CDXUTListBox( CDXUTDialog* pDialog = NULL );
     virtual         ~CDXUTListBox();
     .
     .
     .
     .//member function skipped
     .
     .

 protected:
     RECT m_rcText;      // Text rendering bound
     RECT m_rcSelection; // Selection box bound
     CDXUTScrollBar m_ScrollBar;
     int m_nSBWidth;
     int m_nBorder;
     int m_nMargin;
     int m_nTextHeight;  // Height of a single line of text
     DWORD m_dwStyle;    // List box style
     int m_nSelected;    // Index of the selected item for single selection list box
     int m_nSelStart;    // Index of the item where selection starts (for handling multi-selection)
     bool m_bDrag;       // Whether the user is dragging the mouse to select

     CGrowableArray <DXUTListBoxItem*> m_Items;
 };

CDXUTListBox成员里的两个类型

CDXUTScrollBar m_ScrollBar; 滚动条定义如下

 class CDXUTScrollBar : public CDXUTControl
 {
 public:
                     CDXUTScrollBar( CDXUTDialog* pDialog = NULL );
     virtual         ~CDXUTScrollBar();
     .
     .
     .    //member functions skipped
     .
     .
     .

 protected:
     // ARROWSTATE indicates the state of the arrow buttons.
     // CLEAR            No arrow is down.
     // CLICKED_UP       Up arrow is clicked.
     // CLICKED_DOWN     Down arrow is clicked.
     // HELD_UP          Up arrow is held down for sustained period.
     // HELD_DOWN        Down arrow is held down for sustained period.
     enum ARROWSTATE
     {
         CLEAR,
         CLICKED_UP,
         CLICKED_DOWN,
         HELD_UP,
         HELD_DOWN
     };

     void            UpdateThumbRect();
     void            Cap();  // Clips position at boundaries. Ensures it stays within legal range.

     bool m_bShowThumb;
     bool m_bDrag;
     RECT m_rcUpButton;
     RECT m_rcDownButton;
     RECT m_rcTrack;
     RECT m_rcThumb;
     int m_nPosition;  // Position of the first displayed item
     int m_nPageSize;  // How many items are displayable in one page
     int m_nStart;     // First item
     int m_nEnd;       // The index after the last item
     POINT m_LastMouse;// Last mouse position
     ARROWSTATE m_Arrow; // State of the arrows
     double m_dArrowTS;  // Timestamp of last arrow event.
 };

CGrowableArray <DXUTListBoxItem*> m_Items  选项的类型如下

1 struct DXUTListBoxItem
2 {
3     WCHAR strText[256];
4     void* pData;
5
6     RECT rcActive;
7     bool bSelected;
8 };

CGrowableArray解析