minigui控件管理之注册控件类

 minigui控件管理这几篇文章重点在于说明控件类数据结构和控件数据结构的管理，并找出控件类与控件在代码上的联系与区别。

 

1、 系统注册

 

Minigui在初始化期间，会有一个控件类初始化，该函数在src/gui/ctrlclass.c

 BOOL InitControlClass () { int i; for (i=0; i<LEN_CCITABLE; i++) ccitable[i] = NULL; // Register system controls here. #ifdef _CTRL_STATIC if (!RegisterStaticControl ()) return FALSE; #endif #ifdef _CTRL_BUTTON if (!RegisterButtonControl()) return FALSE; #endif #ifdef _CTRL_SIMEDIT if (!RegisterSIMEditControl()) return FALSE; #endif #ifdef _CTRL_SLEDIT if (!RegisterSLEditControl()) return FALSE; #endif #ifdef _CTRL_PROGRESSBAR if (!RegisterProgressBarControl()) return FALSE; #endif #ifdef _CTRL_LISTBOX if (!RegisterListboxControl()) return FALSE; #endif #ifdef _CTRL_MLEDIT if (!RegisterMLEditControl()) return FALSE; #endif #ifdef _CTRL_TOOLBAR if (!RegisterToolbarControl()) return FALSE; #endif #ifdef _CTRL_NEWTOOLBAR if (!RegisterNewToolbarControl()) return FALSE; #endif #ifdef _CTRL_MENUBUTTON if (!RegisterMenuButtonControl()) return FALSE; #endif #ifdef _CTRL_TRACKBAR if (!RegisterTrackBarControl()) return FALSE; #endif #ifdef _CTRL_COMBOBOX if (!RegisterComboBoxControl()) return FALSE; #endif #ifdef _CTRL_PROPSHEET if (!RegisterPropSheetControl()) return FALSE; #endif #ifdef _CTRL_SCROLLVIEW if (!RegisterScrollViewControl ()) return FALSE; if (!RegisterScrollWndControl ()) return FALSE; #endif #ifdef _CTRL_TEXTEDIT if (!RegisterTextEditControl ()) return FALSE; #endif return TRUE;

在这里根据配置，注册了一系列的控件。在此我们看一下关于编辑框的注册。如果定义了_CTRL_SLEDIT这个宏，就去会调用RegisterSLEditControl这个函数。该函数位于src/control/edit.c

 

BOOL RegisterSLEditControl (void) { WNDCLASS WndClass; WndClass.spClassName = CTRL_SLEDIT; WndClass.dwStyle = WS_NONE; WndClass.dwExStyle = WS_EX_NONE; WndClass.hCursor = GetSystemCursor (IDC_IBEAM); WndClass.iBkColor = GetWindowElementColor (BKC_EDIT_DEF); WndClass.WinProc = SLEditCtrlProc; return AddNewControlClass (&WndClass) == ERR_OK; }  

在注册编辑框的开始，首先会初始化一个WNDCLASS类型的窗口类，它的定义在include/window.h

 

 typedef struct _WNDCLASS { /** the class name */ char* spClassName; /** internal field, operation type */ DWORD opMask; /** window style for all instances of this window class */ DWORD dwStyle; /** extended window style for all instances of this window class */ DWORD dwExStyle; /** cursor handle to all instances of this window class */ HCURSOR hCursor; /** background color pixel value of all instances of this window class */ int iBkColor; /** window callback procedure of all instances of this window class */ int (*WinProc) (HWND, int, WPARAM, LPARAM); /** the private additional data associated with this window class */ DWORD dwAddData; } WNDCLASS; typedef WNDCLASS* PWNDCLASS;

这里对这个类做了简单的初始化，比如类名、回调函数等。这是所有编辑框共同具有的特征属性。这些初始化好之后，就调用AddNewControlClass来添加一个控件类。该函数位于src/gui/ctrlclass.c

 

 int AddNewControlClass (PWNDCLASS pWndClass) { PCTRLCLASSINFO cci, newcci; char szClassName [MAXLEN_CLASSNAME + 2]; int i=0; strncpy (szClassName, pWndClass->spClassName, MAXLEN_CLASSNAME + 1); if (!isalpha ((int)szClassName[0])) return ERR_CTRLCLASS_INVNAME; while (szClassName[i]) { szClassName[i] = toupper(szClassName[i]); i++; if (i > MAXLEN_CLASSNAME) return ERR_CTRLCLASS_INVLEN; } i = szClassName[0] - 'A'; cci = ccitable [i]; if (cci) { while (cci) { if (strcmp (szClassName, cci->name) == 0) return ERR_OK; cci = cci->next; } } cci = ccitable[i]; newcci = malloc (sizeof (CTRLCLASSINFO)); if (newcci == NULL) return ERR_CTRLCLASS_MEM; newcci->next = NULL; strcpy (newcci->name, szClassName); newcci->dwStyle = pWndClass->dwStyle; newcci->dwExStyle = pWndClass->dwExStyle; newcci->hCursor = pWndClass->hCursor; newcci->iBkColor = pWndClass->iBkColor; newcci->ControlProc = pWndClass->WinProc; newcci->dwAddData = pWndClass->dwAddData; newcci->nUseCount = 0; if (cci) { while (cci->next) cci = cci->next; cci->next = newcci; } else ccitable [i] = newcci; return ERR_OK; }

 

从这段代码可以看出，这里主要是向一个全局的hash表ccitable[]中添加一个控件类信息结构类型的指针PCTRLCLASSINFO，该结构定义在src/include/ctrlclass.h

 

 

typedef struct _CTRLCLASSINFO { char name[MAXLEN_CLASSNAME + 1]; // class name /* * common properties of this class */ DWORD dwStyle; // Default control styles. DWORD dwExStyle; // Default control extended styles. HCURSOR hCursor; // control cursor int iBkColor; // control background color. int (*ControlProc)(HWND, int, WPARAM, LPARAM); // control procedure. DWORD dwAddData; // the additional data. int nUseCount; // use count. struct _CTRLCLASSINFO* next; // next class info }CTRLCLASSINFO; typedef CTRLCLASSINFO* PCTRLCLASSINFO

 

这样，就完成了编辑框控件类的注册，以后创建编辑框控件时，会到这个数组中寻找该控件类的相关信息。

 

2、自定义控件类

 

如果我们觉得系统的控件类并不能满足我们的要求，还可以自定义控件类，并注册到系统中。首先我们可以初始化一个WNDCLASS类型的窗口类，给这个类初始化的类名要有别于现有类的类名，然后通过RegisterWindowClass这个函数，注册我们自定义的控件类。看一下这个函数src/gui/window.c

 

BOOL RegisterWindowClass (PWNDCLASS pWndClass) { if (pWndClass == NULL) return FALSE; return SendMessage (HWND_DESKTOP, MSG_REGISTERWNDCLASS, 0, (LPARAM)pWndClass) == ERR_OK; }

他向桌面线程发送一个消息MSG_REGISTERWNDCLASS，并将我们自己定义的控件类放在lParam参数中。这个消息的处理在src/kernel/desktop-comm.c

 

case MSG_REGISTERWNDCLASS: return AddNewControlClass ((PWNDCLASS)lParam);

 

可以看到，它依然是通过AddNewControlClass这个函数来向系统注册控件类。