DuiLib(二)——控件建立

上一篇讲了窗口及消息,了解了大致的程序框架。这一篇说的是控件的建立。html

duilib支持XML配置文件,即根据XML建立窗口及控件,将界面与逻辑分开,便于修改及维护。上一篇的示例中能够看到在消息WM_CREATE中有控件建立的相关代码。node

 1 if( uMsg == WM_CREATE ) {
 2             m_pm.Init(m_hWnd);
 3             //根据XML建立控件
 4             CDialogBuilder builder;
 5             CControlUI* pRoot = builder.Create(_T("HelloWorld.xml"), (UINT)0, NULL, &m_pm);
 6             ASSERT(pRoot && "Failed to parse XML");
 7             m_pm.AttachDialog(pRoot);
 8             m_pm.AddNotifier(this);
 9             return 0;
10         }

控件建立主要牵扯到类CDialogBuilder:框架

  • 建立控件树,返回根控件:CDialogBuilder::Create
  • 将控件树关联到CPaintManagerUI对象(由名字可猜出其功能与绘制控件有关):CPaintManagerUI::AttachDialog
  • 添加消息通知:CPaintManagerUI::AddNotifier

建立控件树:ide

  • 读取XML配置文件
     1 CControlUI* CDialogBuilder::Create(STRINGorID xml, LPCTSTR type, IDialogBuilderCallback* pCallback, 
     2                                    CPaintManagerUI* pManager, CControlUI* pParent)
     3 {
     4     if( HIWORD(xml.m_lpstr) != NULL ) {
     5         if( *(xml.m_lpstr) == _T('<') ) {
     6             if( !m_xml.Load(xml.m_lpstr) ) return NULL;
     7         }
     8         else {
     9             if( !m_xml.LoadFromFile(xml.m_lpstr) ) return NULL; 10         }
    11     }
    12     else {
    13         HRSRC hResource = ::FindResource(CPaintManagerUI::GetResourceDll(), xml.m_lpstr, type);
    14         if( hResource == NULL ) return NULL;
    15         HGLOBAL hGlobal = ::LoadResource(CPaintManagerUI::GetResourceDll(), hResource);
    16         if( hGlobal == NULL ) {
    17             FreeResource(hResource);
    18             return NULL;
    19         }
    20 
    21         m_pCallback = pCallback;
    22         if( !m_xml.LoadFromMem((BYTE*)::LockResource(hGlobal), ::SizeofResource(CPaintManagerUI::GetResourceDll(), hResource) )) return NULL;
    23         ::FreeResource(hResource);
    24         m_pstrtype = type;
    25     }
    26 
    27     return Create(pCallback, pManager);
    28 }
  • 解析Image(图片)、Font(字体)、Default(默认属性)、Windows(窗口相关)项(代码太长,省略了细节)
     1 CControlUI* CDialogBuilder::Create(IDialogBuilderCallback* pCallback, CPaintManagerUI* pManager, CControlUI* pParent)
     2 {
     3     m_pCallback = pCallback;//回调函数,用于建立自定义控件
     4     CMarkupNode root = m_xml.GetRoot();
     5     if( !root.IsValid() ) return NULL;
     6 
     7     if( pManager ) {
     8         LPCTSTR pstrClass = NULL;
     9         int nAttributes = 0;
    10         LPCTSTR pstrName = NULL;
    11         LPCTSTR pstrValue = NULL;
    12         LPTSTR pstr = NULL;
    13         for( CMarkupNode node = root.GetChild() ; node.IsValid(); node = node.GetSibling() ) {
    14             pstrClass = node.GetName();
    15             if( _tcscmp(pstrClass, _T("Image")) == 0 ) {//Image
    16             }
    17             else if( _tcscmp(pstrClass, _T("Font")) == 0 ) {//Font
    18             }
    19             else if( _tcscmp(pstrClass, _T("Default")) == 0 ) {//Default
    20             }
    21         }
    22 
    23         pstrClass = root.GetName();
    24         if( _tcscmp(pstrClass, _T("Window")) == 0 ) {//Window
    25         }
    26     }
    27     return _Parse(&root, NULL, pManager); 28 }
  • 建立控件:CDialogBuilder::_Parse
    • 能够经过include嵌套XML文件
       1 。。。。。。
       2 if( _tcscmp(pstrClass, _T("Include")) == 0 ) {//Include
       3             if( !node.HasAttributes() ) continue;
       4             int count = 1;
       5             LPTSTR pstr = NULL;
       6             TCHAR szValue[500] = { 0 };
       7             SIZE_T cchLen = lengthof(szValue) - 1;
       8             if ( node.GetAttributeValue(_T("count"), szValue, cchLen) )
       9                 count = _tcstol(szValue, &pstr, 10);
      10             cchLen = lengthof(szValue) - 1;
      11             if ( !node.GetAttributeValue(_T("source"), szValue, cchLen) ) continue;
      12             for ( int i = 0; i < count; i++ ) {
      13                 CDialogBuilder builder;
      14                 if( m_pstrtype != NULL ) { // 使用资源dll,从资源中读取
      15                     WORD id = (WORD)_tcstol(szValue, &pstr, 10); 
      16                     pControl = builder.Create((UINT)id, m_pstrtype, m_pCallback, pManager, pParent);
      17                 }
      18                 else {
      19                     pControl = builder.Create((LPCTSTR)szValue, (UINT)0, m_pCallback, pManager, pParent); 20                 }
      21             }
      22             continue;
      23         }
      24 。。。。。。
    • 建立控件(自定义控件调用回调函数实现)
      。。。。。。
      else {//新建控件
                  SIZE_T cchLen = _tcslen(pstrClass);
                  switch( cchLen ) {
                  case 4:
                      if( _tcscmp(pstrClass, _T("Edit")) == 0 )                   pControl = new CEditUI;
                      else if( _tcscmp(pstrClass, _T("List")) == 0 )              pControl = new CListUI;
                      else if( _tcscmp(pstrClass, _T("Text")) == 0 )              pControl = new CTextUI;
                      break;
                  case 5:
                      if( _tcscmp(pstrClass, _T("Combo")) == 0 )                  pControl = new CComboUI;
                      else if( _tcscmp(pstrClass, _T("Label")) == 0 )             pControl = new CLabelUI;
                      break;
                  case 6:
                      if( _tcscmp(pstrClass, _T("Button")) == 0 )                 pControl = new CButtonUI;
                      else if( _tcscmp(pstrClass, _T("Option")) == 0 )            pControl = new COptionUI;
                      else if( _tcscmp(pstrClass, _T("Slider")) == 0 )            pControl = new CSliderUI;
                      break;
                  case 7:
                      if( _tcscmp(pstrClass, _T("Control")) == 0 )                pControl = new CControlUI;
                      else if( _tcscmp(pstrClass, _T("ActiveX")) == 0 )           pControl = new CActiveXUI;
                      break;
                  case 8:
                      if( _tcscmp(pstrClass, _T("Progress")) == 0 )               pControl = new CProgressUI;
                      else if(  _tcscmp(pstrClass, _T("RichEdit")) == 0 )         pControl = new CRichEditUI;
                      break;
                  case 9:
                      if( _tcscmp(pstrClass, _T("Container")) == 0 )              pControl = new CContainerUI;
                      else if( _tcscmp(pstrClass, _T("TabLayout")) == 0 )         pControl = new CTabLayoutUI;
                      else if( _tcscmp(pstrClass, _T("ScrollBar")) == 0 )         pControl = new CScrollBarUI; 
                      break;
                  case 10:
                      if( _tcscmp(pstrClass, _T("ListHeader")) == 0 )             pControl = new CListHeaderUI;
                      else if( _tcscmp(pstrClass, _T("TileLayout")) == 0 )        pControl = new CTileLayoutUI;
                      break;
                  case 12:
                      if( _tcscmp(pstrClass, _T("DialogLayout")) == 0 )           pControl = new CDialogLayoutUI;
                      break;
                  case 14:
                      if( _tcscmp(pstrClass, _T("VerticalLayout")) == 0 )         pControl = new CVerticalLayoutUI;
                      else if( _tcscmp(pstrClass, _T("ListHeaderItem")) == 0 )    pControl = new CListHeaderItemUI;
                      break;
                  case 15:
                      if( _tcscmp(pstrClass, _T("ListTextElement")) == 0 )        pControl = new CListTextElementUI;
                      break;
                  case 16:
                      if( _tcscmp(pstrClass, _T("HorizontalLayout")) == 0 )       pControl = new CHorizontalLayoutUI;
                      else if( _tcscmp(pstrClass, _T("ListLabelElement")) == 0 )  pControl = new CListLabelElementUI;
                      break;
                  case 20:
                      if( _tcscmp(pstrClass, _T("ListContainerElement")) == 0 )   pControl = new CListContainerElementUI;
                      break;
                  }
                  // User-supplied control factory
                  if( pControl == NULL && m_pCallback != NULL ) {
                      pControl = m_pCallback->CreateControl(pstrClass);
                  }
              }
      。。。。。。
    • 添加子控件(解析子控件:递归调用_Parse、关联到父控件:CContainerUI::Add)
       1 。。。。。。
       2 // Add children
       3         if( node.HasChildren() ) {
       4             _Parse(&node, pControl, pManager);  5         }
       6         // Attach to parent
       7         // 由于某些属性和父窗口相关,好比selected,必须先Add到父窗口
       8         if( pParent != NULL ) {
       9             if( pContainer == NULL ) pContainer = static_cast<IContainerUI*>(pParent->GetInterface(_T("IContainer")));
      10             ASSERT(pContainer);
      11             if( pContainer == NULL ) return NULL;
      12             if( !pContainer->Add(pControl) ) { 13                 delete pControl;
      14                 continue;
      15             }
      16         }
      17 。。。。。。
    • 返回根控件
    • 1 。。。。。。
      2 // Return first item
      3         if( pReturn == NULL ) pReturn = pControl;
      4 。。。。。。

 控件建立基本就这些,下一篇写控件消息。函数