CN104252351A - 实现列表控件的方法和装置 - Google Patents

Abstract

本发明公开了一种实现列表控件的方法和装置。该方法包括：对于列表控件中每个列表项，创建所述列表项对应的根容器和所述列表项中的插件元素，将插件元素添加到根容器中；通过布局管理器将根容器中的插件元素按设置的方式进行布局；当通过根容器接收到鼠标对列表控件的操作时，通过鼠标管理器将鼠标的操作通知给操作所作用的插件元素，插件元素根据获知的鼠标的操作进行对应处理。通过每个列表项创建根容器和插件元素并将插件元素添加到根容器中，通过布局管理器对插件元素进行布局；通过鼠标管理器管理鼠标的操作，从而使得列表控件能够方便地添加和管理插件元素。

Description

实现列表控件的方法和装置

技术领域

本发明涉及电子终端技术领域，特别涉及一种实现列表控件的方法和装置。

背景技术

在大部分客户端软件界面的设计开发工作中都会使用到列表型控件。现有的操作系统自带列表控件有列表框（ListBox）、列表控制（ListCtrl）、树控制（TreeCtrl）、组合框（Combobox）、菜单（Menu）等，这些控件通常只能用于显示一系列的文本信息或者图标。如果想让列表控件增加更多的交互功能，例如要在某一列中增加一个小按钮，用于删除该列的话，则需要对该控件进行自绘，或者重写一个列表控件。

对于IM（即时通信）类型客户端，联系人列表的需求改变或者功能增加非常频繁。目前大部分软件仅是采用自绘内部元素的方法，为每个元素维护一个区域。

然而，随着内部元素的增多，元素位置检测、布局、显隐、信息提示等都会变得麻烦，列表型控件的可维护性和可扩展性差。

发明内容

本发明提供了一种实现列表控件的方法和装置，本发明的技术方案使得能够通过增加、删除和修改插件元素，实现列表控件元素的增加、删除和修改操作，方便了开发和使用。

为达到上述目的，本发明公开的一种实现列表控件的方法，包括：

对于列表控件中每个列表项，创建所述列表项对应的根容器和所述列表项中的插件元素，将插件元素添加到根容器中；

通过布局管理器将根容器中的插件元素按设置的方式进行布局；

当通过根容器接收到鼠标对列表控件的操作时，通过鼠标管理器将鼠标的操作通知给操作所作用的插件元素，插件元素根据获知的鼠标的操作进行对应处理。

其中，创建所述列表项中插件元素具体包括：

在插件元素中设置消息通知接口；

所述插件元素根据获知的鼠标的操作进行对应处理具体包括：

当根据鼠标的操作需要调用列表控件之外的功能模块时，通过消息通知接口向该功能模块发送消息。

其中，所述通过布局管理器将根容器中插件元素按设置的方式进行布局具体包括：

通过布局管理器获取根容器中插件元素的布局类型，以及显示插件元素所需的宽度和高度，根据获取的插件元素的宽度、高度和布局类型进行布局。

其中，所述通过鼠标管理器将鼠标的操作通知给操作所作用的插件元素具体包括：

通过鼠标管理器遍历根容器中插件元素，确定出鼠标当前操作所作用的插件元素，将鼠标的操作通知该插件元素。

其中，所述当通过根容器接收到鼠标对列表控件的操作时，通过鼠标管理器将鼠标的操作通知给操作所作用的插件元素具体包括：

当鼠标移动入列表项时，通过列表项将鼠标操作消息通知给该列表项对应的根容器，通过根容器将该鼠标操作消息通知给鼠标管理器;

通过鼠标管理器将该鼠标操作消息通知给位于鼠标下的插件元素，同时开启定时器，如果预设时长内，位于鼠标下的插件元素没有变化，则为该插件元素获取提示内容文本，弹出包含该提示内容文本的提示条。

其中，当创建插件元素时，将创建的插件元素添加到根容器中，通过布局管理器将根容器中插件元素重新布局；

和/或

当删除插件元素时，将删除的插件元素从根容器中删除，通过布局管理器将根容器中剩余插件元素重新布局。

其中，当隐藏列表控件的列表项时，将该列表项对应的根容器隐藏。

本发明进一步公开了一种实现列表控件的装置，包括：

创建单元，用于对于列表控件中每个列表项，创建所述列表项对应的根容器和所述列表项中的插件元素，将插件元素添加到根容器中；

布局单元，用于通过布局管理器将根容器中的插件元素按设置的方式进行布局；

鼠标操作处理单元，用于当通过根容器接收到鼠标对列表控件的操作时，通过鼠标管理器将鼠标的操作通知给操作所作用的插件元素，插件元素根据获知的鼠标的操作进行对应处理。

其中，所述创建单元，用于在插件元素中设置消息通知接口；

所述鼠标操作处理单元，具体用于当根据鼠标的操作需要调用列表控件之外的功能模块时，指示插件元素通过消息通知接口向该功能模块发送消息。

其中，所述鼠标操作处理单元，具体用于当通过根容器接收到鼠标对列表控件的操作时，遍历根容器中插件元素，确定出鼠标当前操作所作用的插件元素，将鼠标的操作通知给该插件元素。

由上述可见，本发明通过每个列表项创建根容器和插件元素并将插件元素添加到根容器中，通过布局管理器对插件元素进行布局；通过鼠标管理器管理鼠标的操作，可以方便地添加和管理插件元素，简化列表控件的变化，提高产品开关效率。

附图说明

图1是本发明的一种实现列表控件的方法的流程图；

图2是本发明的一种实现列表控件的装置的框图；

图3是使用本发明所获得的界面的示意图；

图4是使用本发明所获得的另一界面的示意图；

图5是本发明一实施中实现列表控件的架构图。

具体实施方式

为使本发明的目的、技术方案和优点更加清楚，下面将结合附图对本发明实施方式作进一步地详细描述。

图1是本发明的一种实现列表控件的方法的流程图。在本发明中，该方法包括以下步骤：

步骤S101、对于列表控件中每个列表项，创建列表项对应的根容器（RootIPluginPanelItem）和列表项中的插件元素，将插件元素添加到根容器中。

步骤S102、通过布局管理器（LayoutManager），将根容器中的插件元素按设置的方式进行布局。

此处，通过布局管理器将根容器中的插件元素按设置的方式进行布局可以包括多种方式。

例如，在根容器中包含子容器的情况下，各个子容器有自己的布局管理器。在步骤S101中将插件元素添加到根容器中具体包括：将插件元素添加到对应的子容器中，

步骤S102中具体包括：通过子容器的布局管理器对子容器中的插件元素进行布局，通过根容器的布局管理器对根容器中的子容器进行布局。

又例如，在根容器中不包含子容器的情况下，通过根容器的布局管理器对根容器中插件元素进行布局。

步骤S103、当通过根容器接收到鼠标对列表控件的操作时，通过鼠标管理器（MouseManager）将鼠标的操作通知给操作所作用的插件元素，插件元素根据获知的鼠标的操作进行对应处理。

步骤S101之中，创建列表项中插件元素具体包括：在插件元素中设置消息通知接口，可以通过多种方式在插件元素中设置消息通知接口。例如，通过继承根容器的消息通知接口在插件元素中设置消息通知接口，或者也可以在插件元素中自定义消息通知接口。

此外，在具体实施例中，创建插件元素，可以通过元素创建器（PluginCreator）依据XML文件或文本创建插件元素。

所以，如果需要增加一个新的插件元素，只要继承包含消息通知接口的插件元素类，就能获得插件元素，并可以很方便地将插件元素添加到根容器中。所述插件元素继承了插件元素类，则能够通过消息通知接口交换信息。

本实施例中，插件元素可以为文本元素（IPluginStringItem）、图片元素（IPluginImageItem）、按钮元素（IPluginButtonItem）、超链接元素（IPluginHyperLinkItem），或用于显示其它内容的元素。其中，所述文本元素可用于显示文本，例如昵称、心情短语等。所述图片元素可用于显示图片，例如用户头像。所述按钮元素用于显示按钮，例如发送短信快捷按钮。所述超链接元素用于显示超链接。

如图5所示，是本发明一实施中实现列表控件的架构图。

其中，IPluginItem为插件元素类，通过继承该插件元素类创建文本元素（IPluginStringItem）、图片元素（IPluginImageItem）、按钮元素（IPluginButtonItem）、超链接元素（IPluginHyperLinkItem），和其它元素。并且，各个插件元素中具有消息通知接口（IPluginMessage）。RootIPluginPanelItem为根容器，其包含插件元素。根容器具有自己的鼠标管理器（MouseManager）和布局管理器（LayoutManager）。通过元素创建器（PluginCreator）可以依据XML文件或文本创建插件元素。

步骤S102之中，所述通过布局管理器将根容器中插件元素按设置的方式进行布局具体包括：通过布局管理器获取根容器中插件元素的布局类型，以及显示插件元素所需的宽度和高度，根据获取的插件元素的宽度、高度和布局类型进行布局。

本实施例中布局管理器对所有的布局类型都支持插件元素大小自适应，例如对于文本元素，则通过调用测量字符串操作（MeasureString）测量出显示该文本元素所需要的宽度和高度；对于图像元素，则通过获取图像的宽度和高度作为显示该图像元素所需要的宽度和高度。常用的布局类型有画布（Canvas）布局、堆栈（Stack）布局和卡片（Card）布局。Canvas布局除了支持使用一个方形（RECT）区域设置一个元素位置外，还支持对齐模式，例如将一个按钮元素始终放在界面的右侧偏10px位置。Stack布局可以实现将所有的插件元素从左自右排列，或者从右到左，或者左右混排，排放的先后顺序取决于该插件元素在根容器中的顺序。Card布局可以实现将多个插件元素放在同一位置，同一时间只有一个插件元素可见。

举例而言，如图3和图4所示，为将插件元素布局后的列表项。需要在列表项中显示讨论组名称、人数（2人）、未读消息数量（15）。按从右向左的顺序，排列未读消息数量、人数，当剩余空间不足以显示讨论组名称全部时，则显示讨论组名称一部分，如图4所示，名称未显示部分用“…”代替。由此，能够实现自动布局，省略在布局时的复杂计算，提高效率。

步骤S103之中，插件元素根据获知的鼠标的操作进行对应处理具体包括：当根据鼠标的操作需要调用列表控件之外的功能模块时，通过消息通知接口向该功能模块发送消息。

步骤S103之中，所述通过鼠标管理器将鼠标的操作通知给操作所作用的插件元素具体包括：通过鼠标管理器遍历根容器中插件元素，确定出鼠标当前操作所作用的插件元素，将鼠标的操作通知该插件元素。

步骤S103之中，所述当通过根容器接收到鼠标对列表控件的操作时，通过鼠标管理器将鼠标的操作通知给操作所作用的插件元素具体包括：当鼠标移动入列表项时，通过列表项将鼠标操作消息（即鼠标移动消息WM_MOUSEMOVE）通知给该列表项对应的根容器，通过根容器将该鼠标操作消息通知给鼠标管理器;通过鼠标管理器将该鼠标操作消息通知给位于鼠标下的插件元素，同时开启定时器，如果预设时长内，位于鼠标下的插件元素没有变化，则为该插件元素获取提示内容文本，弹出包含该提示内容文本的提示条。

举例而言，

Root IPluginPanelItem接受到WM_MOUSEMOVE消息之后，将消息交给MouseManager。

MouseManager内部维护两个成员变量：IPluginItem*m_pHoverItem和IPluginItem*m_pPressItem。MouseManager接收到WM_MOUSEMOVE消息后，将遍历所有插件元素，得到当前在鼠标下的插件元素，并将其保存为m_pHoverItem。

之后，MouseManager，开启一个定时器，如果预设时长内，位于鼠标下的插件元素没有变化，则调用插件元素的GetTooltipText方法为该插件元素获取提示内容文本，弹出包含该提示内容文本的提示条。MouseManager还会在鼠标移动时，调用m_pHoverItem的OnMouseMove方法，通知m_pHoverItem鼠标消息。

此外，插件元素通过OnMouseMove方法显示悬浮样式。插件元素通过OnMouseMove获知鼠标消息，确定自身在鼠标下后，将自身样式更新为悬浮样式。对于不同的插件元素类型，显示悬浮样式的操作有所不同，IPluginStringItem、IPluginImageItem由于没有悬浮（hover）样式，则无需更新为悬浮样式，IPluginButtonItem则需要更新为悬浮样式。

进一步地，本发明的方法还包括：当创建插件元素时，将创建的插件元素添加到根容器中，通过布局管理器将根容器中插件元素重新布局；当删除插件元素时，将删除的插件元素从根容器中删除，通过布局管理器将根容器中剩余插件元素重新布局。

在根容器中包含子容器的情况下，当创建插件元素时，将创建的插件元素添加到对应子容器中，通过该子容器的布局管理器将子容器中插件元素重新布局；当删除插件元素时，将删除的插件元素从所在子容器中删除，通过该子容器的布局管理器将子容器中剩余插件元素重新布局。

进一步地，本发明的方法还包括：当隐藏列表控件的列表项时，将该列表项对应的根容器隐藏。通过隐藏根容器，即可以实现隐藏所述插件元素。

图2是本发明的一种实现列表控件的装置的框图。该装置包括创建单元201、布局单元202和鼠标操作处理单元203。

创建单元201，用于对于列表控件中每个列表项，创建所述列表项对应的根容器和列表项中的插件元素，将插件元素添加到根容器中。

布局单元202，用于将根容器中的插件元素按设置的方式进行布局。

鼠标操作处理单元203，用于当通过根容器接收到鼠标对列表控件的操作时，将鼠标的操作通知给操作所作用的插件元素；由插件元素根据获知的鼠标的操作进行对应处理。

本发明中的创建单元201，用于在插件元素中设置消息通知接口。

鼠标操作处理单元，具体用于当根据鼠标的操作需要调用列表控件之外的功能模块时，指示插件元素通过消息通知接口向该功能模块发送消息。

本发明中的布局单元202，具体用于获取根容器中插件元素的布局类型，以及显示插件元素所需的宽度和高度，根据获取的插件元素的宽度、高度和布局类型进行布局。

本发明中的鼠标操作处理单元203，具体用于当通过根容器接收到鼠标对列表控件的操作时，通过鼠标管理器遍历根容器中插件元素，确定出鼠标当前操作所作用的插件元素，将鼠标的操作通知该插件元素。

较佳地，鼠标操作处理单元203，具体用于当鼠标移动入列表项时，通过列表项将鼠标操作消息通知给该列表项对应的根容器，通过根容器将该鼠标操作消息通知给鼠标管理器;通过鼠标管理器将该鼠标操作消息通知给位于鼠标下的插件元素，同时开启定时器，如果预设时长内，位于鼠标下的插件元素没有变化，则为该插件元素获取提示内容文本，弹出包含该提示内容文本的提示条。

较佳地，布局单元202，还用于当创建插件元素时，将创建的插件元素添加到根容器中，通过布局管理器将根容器中插件元素重新布局。

布局单元202，还用于当删除插件元素时，将删除的插件元素从根容器中删除，通过布局管理器将根容器中剩余插件元素重新布局。

布局单元202，还用于当隐藏列表控件的列表项时，将该列表项对应的根容器隐藏。

图3是使用本发明的方法所获得的界面的示意图。图3所示的界面，能够通过以下的伪代码表示：

使用本发明的方法获得如图3所示的界面，需要创建一个根容器和六个插件元素，并将六个插件元素添加到根容器中。本实施例的六个插件元素包括两个容器元素、一个图片元素、一个按钮元素和两个文本元素。

根容器反映在显示界面是未突出显示的矩形，包括两个子元素，依序是一个图片元素和一个位于第一层的容器元素，反映在显示界面分别是自左向右排列的图片和图片右侧的未突出显示的、布局类型是堆栈类型的右对齐的矩形。该位于第一层的容器元素，包括两个子元素，依序是一个按钮元素和一个位于第二层的容器元素，反映在显示界面分别是自右向左排列的按钮和按钮左侧的未突出显示的矩形。该位于第二层的容器元素，包括两个子元素，是两个文本元素，反映在显示界面分别是自右向左排列的文本“（2人）”和“讨论组测试”。

因此，本发明的方法，至少具有以下的优点：

（1）每个列表项创建根容器和插件元素并将插件元素添加到根容器中，通过布局管理器对插件元素进行布局；通过鼠标管理器管理鼠标的操作，可以方便地添加和管理插件元素。

（2）布局管理器对所有的布局类型都支持元素大小自适应，所以可以根据列表项的显示内容，自适应地对根容器布局。

以上所述仅为本发明的较佳实施例而已，并非用于限定本发明的保护范围。凡在本发明的精神和原则之内所作的任何修改、等同替换、改进等，均包含在本发明的保护范围内。

Claims (10)

1.一种实现列表控件的方法，其特征在于，该方法包括：

对于列表控件中每个列表项，创建所述列表项对应的根容器和所述列表项中的插件元素，将插件元素添加到根容器中；

通过布局管理器将根容器中的插件元素按设置的方式进行布局；

当通过根容器接收到鼠标对列表控件的操作时，通过鼠标管理器将鼠标的操作通知给操作所作用的插件元素，插件元素根据获知的鼠标的操作进行对应处理。

2.根据权利要求1所述的方法，其特征在于，

创建所述列表项中插件元素具体包括：

在插件元素中设置消息通知接口；

所述插件元素根据获知的鼠标的操作进行对应处理具体包括：

当根据鼠标的操作需要调用列表控件之外的功能模块时，通过消息通知接口向该功能模块发送消息。

3.根据权利要求1所述的方法，其特征在于，

所述通过布局管理器将根容器中插件元素按设置的方式进行布局具体包括：

通过布局管理器获取根容器中插件元素的布局类型，以及显示插件元素所需的宽度和高度，根据获取的插件元素的宽度、高度和布局类型进行布局。

4.根据权利要求1所述的方法，其特征在于，

所述通过鼠标管理器将鼠标的操作通知给操作所作用的插件元素具体包括：

通过鼠标管理器遍历根容器中插件元素，确定出鼠标当前操作所作用的插件元素，将鼠标的操作通知该插件元素。

5.根据权利要求1所述的方法，其特征在于，

所述当通过根容器接收到鼠标对列表控件的操作时，通过鼠标管理器将鼠标的操作通知给操作所作用的插件元素具体包括：

当鼠标移动入列表项时，通过列表项将鼠标操作消息通知给该列表项对应的根容器，通过根容器将该鼠标操作消息通知给鼠标管理器;

通过鼠标管理器将该鼠标操作消息通知给位于鼠标下的插件元素，同时开启定时器，如果预设时长内，位于鼠标下的插件元素没有变化，则为该插件元素获取提示内容文本，弹出包含该提示内容文本的提示条。

6.根据权利要求1所述的方法，其特征在于，所述方法还包括：

当创建插件元素时，将创建的插件元素添加到根容器中，通过布局管理器将根容器中插件元素重新布局；

和/或

当删除插件元素时，将删除的插件元素从根容器中删除，通过布局管理器将根容器中剩余插件元素重新布局。

7.根据权利要求1所述的方法，其特征在于，所述方法还包括：

当隐藏列表控件的列表项时，将该列表项对应的根容器隐藏。

8.一种实现列表控件的装置，其特征在于，该装置包括：

创建单元，用于对于列表控件中每个列表项，创建所述列表项对应的根容器和所述列表项中的插件元素，将插件元素添加到根容器中；

布局单元，用于通过布局管理器将根容器中的插件元素按设置的方式进行布局；

鼠标操作处理单元，用于当通过根容器接收到鼠标对列表控件的操作时，通过鼠标管理器将鼠标的操作通知给操作所作用的插件元素，插件元素根据获知的鼠标的操作进行对应处理。

9.根据权利要求8所述的装置，其特征在于，

所述创建单元，用于在插件元素中设置消息通知接口；

所述鼠标操作处理单元，具体用于当根据鼠标的操作需要调用列表控件之外的功能模块时，指示插件元素通过消息通知接口向该功能模块发送消息。

10.根据权利要求8所述的装置，其特征在于，

所述鼠标操作处理单元，具体用于当通过根容器接收到鼠标对列表控件的操作时，遍历根容器中插件元素，确定出鼠标当前操作所作用的插件元素，将鼠标的操作通知给该插件元素。