MiniGUI窗口与控件.doc

CreateInfo.dwStyle窗口风格CreateInfo.spCaption窗口的标题CreateInfo.dwExStyle窗口的附加风格CreateInfo.hMenu附加在窗口上的菜单句柄CreateInfo.hCursor在窗口中所使用的鼠标光标句柄CreateInfo.hIcon程序的图标CreateInfo.MainWindowProc该窗口的消息处理函数指针CreateInfo.lx窗口左上角相对屏幕的绝对横坐标，以象素点表示CreateInfo.ty窗口左上角相对屏幕的绝对纵坐标，以象素点表示CreateInfo.rx窗口右下角相对屏幕的绝对横坐标，以象素点表示CreateInfo.by窗口右下角相对屏幕的绝对纵坐标，以象素点表示CreateInfo.iBkColor窗口背景颜色CreateInfo.dwAddData附带给窗口的一个 32 位值CreateInfo.hHosting窗口消息队列的托管窗口风格标识含义备注WS_NONE未指定任何风格WS_VISIBLE创建初始可见的窗口WS_DISABLED创建初始被禁止的窗口WS_CAPTION创建含标题栏的主窗口仅用于主窗口WS_SYSMENU创建含系统菜单的主窗口仅用于主窗口WS_BORDER创建有边框的窗口WS_THICKFRAME创建具有厚边框的窗口WS_THINFRAME创建具有薄边框的窗口WS_VSCROLL创建带垂直滚动条的窗口WS_HSCROLL创建带水平滚动条的窗口WS_MINIMIZEBOX标题栏上带最小化按钮仅用于主窗口WS_MAXIMIZEBOX标题栏上带最大化按钮仅用于主窗口WS_EX_NONE无扩展风格WS_EX_USEPRIVATECDC使用私有 DC仅用于主窗口WS_EX_TOPMOST建立始终处于顶层的主窗口仅用于主窗口WS_EX_TOOLWINDOW建立Tooltip 主窗口仅用于主窗口。Tooltip 主窗口将不会拥有输入焦点，但仍接收鼠标消息WS_EX_USEPARENTFONT使用父窗口字体作为默认字体WS_EX_USEPARENTCURSOR使用父窗口光标作为默认光标WS_EX_NOCLOSEBOX主窗口标题栏上不带关闭按钮WS_EX_CTRLASMAINWIN建立可显示在主窗口之外的控件仅用于控件MiniGUI中控件类的定义如下：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;控件类的主要元素如下：n 类名spClassName：区别于其它控件类的类名称n 窗口过程函数指针WinProc：该类控件的实例均使用该窗口过程函数，它处理所有发送到控件的消息并定义控件的行为和特征n 类风格dwStyle：定义窗口的外观和行为等的风格，该类的所有实例将具有该普通风格。n 扩展的类风格dwExStyle：定义窗口的扩展风格，该类的所有实例将具有该扩展风格。n 类光标hCursor：定义该类窗口中光标的形状n 背景色iBkColor：定义该类窗口的背景颜色象素值n 类的私有附加数据dwAddData：系统为该类保留的附加空间MiniGUI中控件类操作的相关函数如下：BOOL GUIAPI RegisterWindowClass (PWNDCLASS pWndClass) ;该函数注册一个控件类。BOOL GUIAPI UnregisterWindowClass (const char *szClassName) ;该函数注销一个控件类。const char* GUIAPI GetClassName (HWND hWnd) ;该函数获取指定控件的类名。.BOOL GUIAPI GetWindowClassInfo (PWNDCLASS pWndClass) ;该函数获取指定控件类的类信息。BOOL GUIAPI SetWindowClassInfo (const WNDCLASS *pWndClass) ;该函数设置指定控件类的类信息。MiniGUI-Lite 为应用程序使用 GB2312 输入法提供了如下的函数：HWND GBIMEWindowEx ( HWND hosting, int lx, int ty, int rx, int by, BOOL two_lines );该函数创建一个GB2312 的输入法窗口。在调用该函数之前，你必须创建一个主窗口作为该IME窗口的托管窗口。 GBIMEWindowEx 函数各参数的含义如下：n hosting IME窗口的托管窗口，不能取 HWND_DESKTOPn lx,ty,rx,by IME窗口的大小和位置n two_lines 指明IME窗口是否分为两行GBIMEWindowEx返回IME窗口的句柄。MiniGUI-Threads 为 GB2312 输入法定义了一个入口函数：HWND GBIMEWindow (HWND hosting);该函数创建一个可以拖动的 GB2312 输入法窗口。除上述提供 GB2312 输入法的函数之外，MiniGUI 提供了如下更加通用的输入法接口：int GUIAPI RegisterIMEWindow ( HWND hWnd );该函数把指定的窗口hWnd注册为MiniGUI的IME窗口。此后，键盘输入将首先被发送到IME窗口。注意只能注册一个IME窗口。int GUIAPI UnregisterIMEWindow ( HWND hWnd );该函数注销一个IME窗口。int GUIAPI SetIMEStatus ( int StatusCode, int Value );该函数设置当前的IME窗口状态。对 GB2312 输入法，StatusCode可以是以下值之一：n IS_ENABLE 使IME窗口有效或无效n IS_FULLCHAR 是否转换半角字符为全角字符n IS_FULLPUNC 是否转换半角标点为全角标点n IS_METHOD 输入法的种类、比如内码、全拼、五笔等等。Value为所设状态的值。int GUIAPI GetIMEStatus ( int StatusCode );该函数获取当前IME窗口的状态。StatusCode指定所要获取的内容。GetIMEStatus返回IME窗口的状态值。在 MiniGUI-Lite 中，通常由 mginit 程序创建输入法窗口。应用程序可以创建自己的输入法窗口，然后调用 RegisterIMEWindow 函数注册为输入法窗口。之后，MiniGUI 将把所有的按键消息首先发送到输入法窗口，然后再由输入法窗口进行相应的处理并转发给目标窗口或者活动客户。函数名称用途备注UpdateWindow立即更新某个窗口ShowWindow显示或隐藏某个窗口IsWindowVisible判断某个窗口是否可见控件和主窗口均可用EnableWindow使能或禁止某个窗口IsWindowEnabled判断某个窗口是否可用GetClientRect获取窗口客户区矩形GetWindowRect获取窗口矩形屏幕坐标系中的窗口尺寸GetWindowBkColor获取窗口背景色SetWindowBkColor设置窗口背景色GetWindowFont获取窗口默认字体SetWindowFont设置窗口默认字体GetWindowCursor获取窗口光标SetWindowCursor设置窗口光标GetWindowStyle获取窗口风格GetWindowExStyle获取窗口扩展风格GetFocusChild获取拥有输入焦点的子窗口SetFocusChild设置焦点子窗口GetWindowCallbackProc获取窗口过程函数SetWindowCallbackProc设置窗口过程函数GetWindowAdditionalData获取窗口附加数据一SetWindowAdditionalData设置窗口附加数据一GetWindowAdditionalData2获取窗口附加数据二对话框和控件在内部已使用附加数据二，保留附加数据一给应用程序使用SetWindowAdditionalData2设置窗口附加数据二GetWindowCaption获取窗口标题通常用于主窗口SetWindowCaption设置窗口标题InvalidateRect使窗口的给定矩形区域无效将引发窗口重绘GetUpdateRect获取窗口当前的无效区域外包矩形ClientToScreen将窗口客户区坐标转换为屏幕坐标ScreenToClient将屏幕坐标转换为客户区坐标WindowToScreen将窗口坐标转换为屏幕坐标ScreenToWindow将屏幕坐标转换为窗口坐标IsMainWindow判断给定窗口是否为主窗口IsControl判断给定窗口是否为控件GetParent获取窗口的父窗口句柄主窗口的父窗口永远为 HWND_DESKTOPGetMainWindowHandle返回包含某个窗口的主窗口句柄GetNextChild获取下一个子窗口用于遍历某个窗口的所有子窗口GetNextMainWindow获取下一个主窗口句柄用于遍历所有主窗口GetHosting获取某个主窗口的托管窗口GetFirstHosted获取某个主窗口的第一个被托管窗口用于遍历某个主窗口的所有被托管窗口GetNextHosted获取下一个被托管窗口GetActiveWindow获取当前活动主窗口SetActiveWindow设置当前活动主窗口GetCapture获取当前捕获鼠标的窗口第 24 章讲述鼠标捕获相关内容SetCapture捕获鼠标ReleaseCapture释放鼠标MoveWindow移动窗口或改变窗口大小ScrollWindow滚动窗口内容对话框操作函数函数名称用途备注DestroyAllControls销毁所有的子窗口GetDlgCtrlID根据控件句柄获取控件标识符GetDlgItem根据控件标识符获取控件句柄GetDlgItemInt获取控件文本并转换为整数值SetDlgItemInt根据整数值设置控件文本GetDlgItemText获取子控件文本功能同 GetWindowTextGetDlgItemText2获取子控件文本根据文本长度自动分配内存，应用程序负责释放该内存SetDlgItemText设置子控件文本功能同 SetWindowTextGetNextDlgGroupItem获取下一个同组子控件用于遍历同组控件，参阅 WS_GROUP 风格GetNextDlgTabItem获取下一个“TAB 键停止”子控件用于 TAB 键游历控件，参阅 WS_TABSTOP 风格SendDlgItemMessage向子控件发送消息功能同 SendMessageCheckDlgButton设置检查框子控件的选中状态CheckRadioButton设置单选按钮子控件的选中状态IsDlgButtonChecked检查子按钮是否选中GetDlgDefPushButton获取当前默认子按钮MiniGUI 预定义的控件类和对应类名称控件类类名称宏定义备注静态框staticCTRL_STATIC按钮buttonCTRL_BUTTON简单编辑框editCTRL_EDIT使用等宽系统字符来显示输入文字，只能处理 ISO8859 和 GB2312 字符集。单行编辑框sleditCTRL_SLEDIT可处理变宽字符，支持任意字符集多行编辑框mleditCTRL_MLEDIT列表框listboxCTRL_LISTBOX进度条progressbarCTRL_PRORESSBAR滑块trackbarCTRL_TRACKBAR工具条toolbarCTRL_TOOLBAR已废弃，不推荐使用新工具条newtoolbarCTRL_NEWTOOLBAR菜单按钮menubuttonCTRL_MENUBUTTON属性页propsheetCTRL_PROP