UILIB自定义控件使用说明书.docx

UILIB自定义控件使用说明书 夏艳 2011-4-15 CUITransManager 透明窗体绘图管理器 派生自派生自CPaintManagerUI，通过UpdateLayeredWindow实现窗体的透明透明。 使用CUITransManager 为绘图管理器的窗体，窗体上不可以使用有自带窗体的控件（如CEditUI，CRichEditUI）和ActiveX控件（如IE控件）。 自定义菜单 CUIMenu 菜单窗口 派生自派生自CWindowWnd，并使用CUITransManager为绘图管理器，可以实现半透明效果。和窗体一样，自定义菜单可以通过xml文件来创建，例如咔咕工程中的主菜单。 菜单窗口含有一个CVerticalLayoutUI容器，它是所有菜单项的容器。 xml属性： hotimage 菜单项被选中时的背景图 normalimage 菜单项正常状态的背景图 disabledimage 菜单项不可用时的背景图 itemsepimage 分割线菜单项的背景图 itemheadimage 菜单项题头（通常是用于放图标的位置）背景图 expondico 含有子菜单的菜单项，菜单项右边缘的图标 normalico 菜单项正常状态下的图标 checkedico 菜单项checked状态时的图标 itemwidth 菜单项的宽度，其实也是该菜单窗口的宽度 itemheight 菜单项高度 sepheight 分割线菜单项的高度 在xml菜单窗体的属性中，除上述属性外，其余的属性都是它的容器的属性 以上其实都是菜单项的属性参数，如果在菜单窗口中配置这些参数，可以统一设置这个窗口内的所有菜单项。 CMenuItemUI 菜单项 派生自CControlUI，实现菜单项的绘制和事件。 xml属性： 上述的菜单xml属性，皆可用于菜单项 name 如果该项为“sep”，则表示该项为分割线 hotimage 菜单项被选中时的背景图 normalimage 菜单项正常状态的背景图 disabledimage 菜单项不可用时的背景图 itemsepimage 分割线菜单项的背景图 itemheadimage 菜单项题头（通常是用于放图标的位置）背景图 expondico 含有子菜单的菜单项，菜单项右边缘的图标 normalico 菜单项正常状态下的图标 checkedico 菜单项checked状态时的图标 itemwidth 菜单项的宽度，其实也是该菜单窗口的宽度 itemheight 菜单项高度 sepheight 分割线菜单项的高度 文字相关属性同CLabelUI。 上述配置参数，在xml文件的菜单窗口和菜单项都可以配置，如果菜单项的配置优先级将高于菜单窗口。 如某菜单窗口配置，itemheight=”30”，而在某个菜单项设置了itemheight=”40”，则表示，该菜单项的高度为40，其余菜单项，由于没有单独设置该参数，将依照菜单窗口统一配置的参数，高度为30。 重要变量 m_pPmNotify 接受菜单消息的窗口管理器 当某项菜单被点击后，将向其消息接收窗口m_pPmNotify（如：程序主窗口）发送“click”事件，交给主程序处理。 调用示例 CMenuWin* m_pMenuTray = new CMenuWin; m_pMenuTray-SetNotifyPM(m_pm); //设置接收菜单消息的窗口管理器 m_pMenuTray-LoadFromXml(ID_XML_MENUTRAY, _T(XML)); //通过资源加载配置文件 POINT pt; ::GetCursorPos(pt); m_pMenuTray-ShowMenu(pt); //显示菜单，pt为菜单窗口左上角坐标 图示 expondico normalico itemheadimage 抽屉窗口 CStackItemUI抽屉项 抽屉项由抽屉头，抽屉身组成，抽屉项派生于CVerticalLayoutUI ，它的两个元素即抽屉头和抽屉身。 抽屉项的xml属性完全同CVerticalLayoutUI的相应属性，没有新的扩展。 CStackItemHeaderUI 抽屉头 派生于CHorizontalLayoutUI，是抽屉项的标题。 xml属性： hotimage 抽屉头鼠标经过时的背景图 normalimage 抽屉头正常状态的背景图 disabledimage 抽屉头不