SuperAPI AI 工具集

syncfusion-winforms-group-view

前端与建站

查看项目

更新于 10-16 02:14

技能介绍

用途

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。