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

UILIB自定义控件使用说明书夏艳2011-4-151. CUITransManager 透明窗体绘图管理器派生自派生自CPaintManagerUI，通过UpdateLayeredWindow实现窗体的透明透明。使用CUITransManager 为绘图管理器的窗体，窗体上不可以使用有自带窗体的控件（如CEditUI，CRichEditUI）和ActiveX控件（如IE控件）。2. 自定义菜单2.1 CUIMenu 菜单窗口派生自派生自CWindowWnd，并使用CUITransManager为绘图管理器，可以实现半透明效果。和窗体一样，自定义菜单可以通过xml文件来创建，例如咔咕工程中的主菜单。菜单窗口含有一个CVerticalLayoutUI容器，它是所有菜单项的容器。xml属性：hotimage 菜单项被选中时的背景图normalimage 菜单项正常状态的背景图disabledimage 菜单项不可用时的背景图itemsepimage 分割线菜单项的背景图itemheadimage 菜单项题头（通常是用于放图标的位置）背景图expondico 含有子菜单的菜单项，菜单项右边缘的图标normalico 菜单项正常状态下的图标checkedico 菜单项checked状态时的图标itemwidth 菜单项的宽度，其实也是该菜单窗口的宽度itemheight 菜单项高度sepheight 分割线菜单项的高度在xml菜单窗体的属性中，除上述属性外，其余的属性都是它的容器的属性以上其实都是菜单项的属性参数，如果在菜单窗口中配置这些参数，可以统一设置这个窗口内的所有菜单项。2.2 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。2.3 重要变量m_pPmNotify 接受菜单消息的窗口管理器当某项菜单被点击后，将向其消息接收窗口m_pPmNotify（如：程序主窗口）发送“click”事件，交给主程序处理。2.4 调用示例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为菜单窗口左上角坐标2.5 图示expondiconormalicoitemheadimage3. 抽屉窗口3.1 CStackItemUI抽屉项抽屉项由抽屉头，抽屉身组成，抽屉项派生于CVerticalLayoutUI ，它的两个元素即抽屉头和抽屉身。抽屉项的xml属性完全同CVerticalLayoutUI的相应属性，没有新的扩展。3.2 CStackItemHeaderUI 抽屉头派生于CHorizontalLayoutUI，是抽屉项的标题。xml属性：hotimage 抽屉头鼠标经过时的背景图normalimage 抽屉头正常状态的背景图disabledimage 抽屉头不可用时的背focusedimage 抽屉头被选中的背景图expondico 抽屉展开时的抽屉头图标normalico 抽屉收缩时的抽屉头图标其余属性皆同CHorizontalLayoutUI的属性，文字相关属性同CLabelUI。3.3 CStackWinUI抽屉窗口派生于CVerticalLayoutUI，它的各个元素即是抽屉项。抽屉有三种类别：normal，multi，uniquenormal 当抽屉项收缩的时候，该抽屉项只显示其抽屉头，抽屉项放开的时候则抽屉头和抽屉身都显示。同时只允许一个抽屉元素展开，此时展开的抽屉身高度为确定值：抽屉窗口高度减去所有抽屉头的高度。点击抽屉头时，该抽屉展开，其余所有抽屉收缩。当未指定multi和unique属性时，抽屉窗口都是normal类型。multi 当抽屉项收缩的时候，该抽屉项只显示其抽屉头，抽屉项放开的时候则抽屉头和抽屉身都显示。同时允许多个抽屉元素同时展，须设置每个抽屉元素的高度。点击抽屉头的时候实现该抽屉项的展开还是收缩。unique 只允许抽屉窗口有两个抽屉元素，此时抽屉头更像是两个抽屉窗口切换的开关。当一个抽屉项展示时，它的抽屉头被隐藏，抽屉身显示，而另一个抽屉项的抽屉身隐藏，抽屉头显示，位于抽屉窗口的底部；反之亦然，只是抽屉头位于抽屉窗口顶部。点击抽屉头实现切换。xml属性：hotimage 抽屉头鼠标经过时的背景图normalimage 抽屉头正常状态的背景图disabledimage 抽屉头不可用时的背focusedimage 抽屉头被选中的背景图expondico 抽屉展开时的抽屉头图标normalico 抽屉收缩时的抽屉头图标headerheight 抽屉头高度select 指定展开的抽屉的序号multi 如果为“true”表示为multi型抽屉unique 如果为“true”表示为unique型抽屉其余属性皆同CHorizontalLayoutUI的属性，文字相关属性同CLabelUI。3.4 图示抽屉头normal抽屉窗口抽屉头抽屉身normalimage抽屉头multi抽屉窗口 抽屉身expondico两个抽屉都展开 两个抽屉都收缩unique 抽屉窗口抽屉头 抽屉身 展开第一个抽屉抽屉身抽屉头展开第二个抽屉4. 列表控件4.1 CListControlUI 列表框列表框派生于CVerticalLayoutUI，它的元素即是列表的所有列表行。xml属性dragable 如果为“true”, 列表头的单元格可拖拽，用来改变该列的宽度headersepwidth 列表头单元格间隔线的宽度itemsepwidth 列表行单元格间隔线的宽度 itembkcoloreven 偶数列表行的背景色itembkcolorodd 奇数列表行的背景色itembkcolorhot 列表行鼠标滑过时的背景色itembkcolorselected 列表行选中后的背景色headernormalimage 列表头单元格的普通状态的背景图headerpushedimage 列表头单元格的鼠标按下状态的背景图headersepimage 列表头单元格间隔线的背景图itemhotimage 列表行鼠标滑过时的背景图itemselectedimage 列表行鼠标选中后的背景图itemsepimage 列表行单元格间隔线的背景图reserveico 用户预留列“添加按钮”的图标reserve 如果为“true”，表示该列表框使用用户预留列lines 在列表框中显示的行数，如果行里面没有数据，则显示空行check 如果为“true”，表示该列表框使用“全选”功能chknormalico 全选控件的背景图（正常状态）chkpushedico 全选控件的背景图（鼠标按下）chkwidth 全选控件宽度当reserve为true时，在列表头的最后一列将显示“添加按钮”，点击该按钮，改表头的单元格将变成编辑框，用户可以输入文字，用户鼠标点击别处时，编辑框里的文字将被保留为该列的名称，同时该列的所有单元格都变成可编辑，即用户点击单元格时出现编辑框。当check为true时，列表框的第一列将全是checkbox，当列表头的checkbox被选中时，第一列的所有checkbox将被选中；列表行中有一行变成“未选中”的状态，列表头的checkbox也会变成“未选中”。4.2 CListRowUI列表行派生于CHorizontalLayoutUI，它的元素即该行的所有单元格。xml属性完全同CHorizontalLayoutUI的相应属性，没有新的扩展。4.3 CListRowHeaderUI列表头派生于CListRowUI，它的元素即该行的所有单元格，列表行是列表控件的第一行，在xml配置中，如果需要设置列表头，列表头需排列在第一个元素的位置。xml属性完全同CListRowUI的相应属性，没有新的扩展。4.4 CListCellUI列表单元格派生自CContainerUI，在check列，单元格含有一个checkbox元素；在reserve列的表头，单元格含有一个“添加按钮”元素；或可编辑的单元格内，编辑的时候，单元格含有一个编辑框元素。xml属性editable 如果为“true”，则表示该单元格支持“可编辑”。其余属性完全同CContainerUI的相应属性。列表头check列reserve列列表行单元格4.5 图示 列表元素编辑表头reserve列 用户编辑reserve列 reserve