用途
GroupView 控件是 Syncfusion 提供的 Windows Forms 列表型控件,用于显示带文本和图像的项目列表。它适合用于创建 Visual Studio .NET 工具箱风格界面、Microsoft OutlookBar 克隆、导航面板、文件浏览器、设置菜单和仪表盘小部件选择器等场景。
主要能力
GroupView 显示 GroupViewItem 集合,每个项目支持:文本标签(含格式化和高亮)、来自 ImageList 的小图标和大图标、交互状态(选中、高亮、选择中)、拖拽重排序、就地重命名、工具提示和上下文菜单、各状态的自定义颜色和偏移量、水平和垂直排列方向。
控件级能力包括:扁平或 3D 外观、ButtonView 按下状态可视化、FlowView 图像为主布局、大数据集的集成滚动、选择/高亮/重命名/重排序的事件通知。
使用方式
基本设置
引入命名空间 Syncfusion.Windows.Forms.Tools,使用 new GroupView() 创建控件,设置 Location 和 Size,通过 SmallImageList 或 LargeImageList 绑定 ImageList,通过 GroupViewItems.AddRange() 添加项目,并订阅 GroupViewItemSelected 等事件。
工具箱风格界面
设置 FlatLook = true、FlowView = true、ShowFlowViewItemText = true、IntegratedScrolling = true、SmallImageView = true、AllowDragDrop = true,并配置 HighlightText、HighlightImage、HighlightItemColor 和 HighlightTextColor。
动态添加项目
使用 new GroupViewItem(text, imageIndex, visible, toolTipText, name) 构造单个项目并通过 Add() 添加,或使用 AddRange() 批量添加多个项目。
高亮与选中配置
启用 HighlightText 和 HighlightImage,设置 HighlightItemColor、HighlightTextColor、SelectedItemColor、SelectedTextColor、SelectedHighlightItemColor 和 SelectedHighlightTextColor。
拖拽与重命名
设置 AllowDragDrop = true(可选 AllowDragAnyObject = true),处理 GroupViewItemsReordered 事件。使用 InplaceRenameItem(index) 启动就地重命名,处理 GroupViewItemRenamed 事件获取 GroupItemRenamedEventArgs 的 OldLabel 和 NewLabel。
上下文菜单
处理 ShowContextMenu 事件,使用 ContextMenuItem 属性判断鼠标是否位于某个项目上方,然后通过 ContextMenuStrip 显示菜单。
GroupBar 集成
可将 GroupView 作为客户端控件添加到 GroupBar 中,创建 VS.NET 工具箱界面,相关细节参见 references/groupbar-integration.md。
关键属性
- 核心:
GroupViewItems、SelectedItem、HighlightedItem、ContextMenuItem - 外观:
FlatLook、BorderStyle、SmallImageView、FlowView - 行为:
AllowDragDrop、IntegratedScrolling、Orientation、ButtonView - 图像:
SmallImageList、LargeImageList、HighlightImage、ImageSpacing - 文本:
HighlightText、TextWrap、TextUnderline、TextSpacing - 颜色:
HighlightItemColor、HighlightTextColor、SelectedItemColor、SelectedTextColor
事件
GroupViewItemSelected、GroupViewItemHighlighted、GroupViewItemRenamed、GroupViewItemsReordered、GroupViewItemDoubleClick、ShowContextMenu。
适用场景
导航面板、工具调色板、文件浏览器、设置菜单、仪表盘小部件等需要图标加文本列表交互的 Windows Forms 界面。
限制
资料未说明该控件的授权方式、价格、系统版本要求或性能上限。使用中图像不显示时需检查 ImageList 绑定、SmallImageView 设置和 ImageIndex 有效性;事件不触发时需检查订阅和控件添加;拖拽不工作时需设置 AllowDragDrop;选中不可见时需配置选中颜色或启用 ButtonView。