【C#】【EXCEL】BumblebeeComponentsAnalysisGH_Ex_Ana_CondBlank.cs

2024-08-27 09:44
文章标签 c# excel .net cs netcore ex ana bumblebeecomponentsanalysisgh condblank

本文主要是介绍【C#】【EXCEL】BumblebeeComponentsAnalysisGH_Ex_Ana_CondBlank.cs，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

这段代码定义了一个名为 GH_Ex_Ana_CondBlank 的类，它是一个 Grasshopper 组件，用于在 Excel 工作表中为特定范围添加条件格式。具体功能和介绍如下：

  1. 功能概述：
    这个组件用于在 Excel 中为指定的单元格范围添加基于空白值的条件格式。它允许用户高亮显示空白或非空白的单元格。

  2. 主要特性：

    • 可以设置高亮颜色
    • 可以选择高亮空白或非空白单元格
    • 可以选择清除现有的条件格式
    • 可以控制是否激活条件格式

  3. 输入参数：

    • 工作表和范围（从基类继承）
    • 单元格颜色（用于高亮显示）
    • 翻转选项（决定是高亮空白还是非空白单元格）
    • 清除选项（是否清除现有条件格式）
    • 激活选项（是否应用条件格式）

  4. 输出：

    • 应用了条件格式的 Excel 范围

  5. 使用场景：
    这个组件可以用于数据分析或可视化，帮助用户快速识别 Excel 表格中的空白或填充单元格。例如，在数据清理过程中识别缺失数据，或在数据录入过程中突出显示已填写的字段。

  6. 技术细节：

    • 继承自 GH_Ex_Rng__Base 类，可能是一个自定义的基础 Excel 范围操作组件
    • 使用 Grasshopper 的组件框架
    • 集成了 Excel 操作功能，可能使用了某种 Excel 互操作库

  7. 用户界面：

    • 在 Grasshopper 中作为一个次要（secondary）级别的组件显示
    • 有自定义图标（BB_Cond_Blank_01）

总的来说，这是一个专门用于 Excel 数据处理的 Grasshopper 插件组件，为用户提供了一种简单的方式来可视化和分析 Excel 中的空白数据。

Flow diagram

SolveInstance / 解决实例
Yes
Yes
No
No
Get Worksheet / 获取工作表
SolveInstance Method / 解决实例方法
Get Range / 获取范围
Get Color / 获取颜色
Get Flip / 获取翻转状态
Get Clear / 获取清除状态
Get Activate / 获取激活状态
Start / 开始
Initialize Component / 初始化组件
Register Input Parameters / 注册输入参数
Register Output Parameters / 注册输出参数
Activate? / 是否激活?
Clear? / 是否清除?
ClearConditions / 清除条件
AddConditionalBlanks / 添加条件格式
Set Output / 设置输出
End / 结束

这个流程图展示了 GH_Ex_Ana_CondBlank 类的主要执行流程：

  1. Start / 开始: 组件开始执行。
  2. Initialize Component / 初始化组件: 对应构造函数 GH_Ex_Ana_CondBlank()。
  3. Register Input Parameters / 注册输入参数: 对应 RegisterInputParams 方法。
  4. Register Output Parameters / 注册输出参数: 对应 RegisterOutputParams 方法。
  5. SolveInstance Method / 解决实例方法: 对应 SolveInstance 方法。
    • Get Worksheet / 获取工作表
    • Get Range / 获取范围
    • Get Color / 获取颜色
    • Get Flip / 获取翻转状态
    • Get Clear / 获取清除状态
    • Get Activate / 获取激活状态
  6. Activate? / 是否激活?: 检查是否应用条件格式。
  7. Clear? / 是否清除?: 如果激活，检查是否需要清除现有条件。
  8. ClearConditions / 清除条件: 如果需要清除，执行 range.ClearConditions()。
  9. AddConditionalBlanks / 添加条件格式: 执行 range.AddConditionalBlanks(color, flip)。
  10. Set Output / 设置输出: 对应 DA.SetData(0, range)。
  11. End / 结束: 组件执行结束。

这个流程图清晰地展示了代码的执行过程，包括主要的决策点和操作步骤。

Description

  1. 构造函数 GH_Ex_Ana_CondBlank()
public GH_Ex_Ana_CondBlank(): base("Conditional Blank", "Blank","Add conditional formatting to a Range based on blank values",Constants.ShortName, Constants.SubAnalysis)
{
}

解释：
这是类的构造函数。它调用基类的构造函数，设置组件的名称、昵称、描述和分类。

  • “Conditional Blank”：组件的全名
  • “Blank”：组件的昵称
  • 描述文本解释了组件的功能
  • Constants.ShortName 和 Constants.SubAnalysis 可能是定义组件分类的常量
  1. Exposure 属性
public override GH_Exposure Exposure
{get { return GH_Exposure.secondary; }
}

解释：
这个属性定义了组件在 Grasshopper 界面中的显示级别。

  • GH_Exposure.secondary 表示这是一个次要组件，可能在子菜单或高级选项中显示。
  1. RegisterInputParams 方法
protected override void RegisterInputParams(GH_Component.GH_InputParamManager pManager)
{base.RegisterInputParams(pManager);pManager[1].Optional = true;pManager.AddColourParameter("Cell Color", "C", "The cell highlight color", GH_ParamAccess.item, Sd.Color.LightGray);pManager[2].Optional = true;pManager.AddBooleanParameter("Flip", "F", "If true, filled cells will be highlighted", GH_ParamAccess.item, false);pManager[3].Optional = true;pManager.AddBooleanParameter("Clear", "_X", "If true, the existing conditions will be cleared", GH_ParamAccess.item, false);pManager[4].Optional = true;pManager.AddBooleanParameter("Activate", "_A", "If true, the condition will be applied", GH_ParamAccess.item, false);pManager[5].Optional = true;
}

解释：
这个方法注册组件的输入参数。

  • 首先调用基类的 RegisterInputParams 方法注册基本参数。
  • 然后添加特定于此组件的参数：
    • 单元格颜色：用于高亮显示的颜色
    • 翻转选项：决定是高亮空白还是非空白单元格
    • 清除选项：是否清除现有条件格式
    • 激活选项：是否应用条件格式
  • 所有新添加的参数都被设置为可选的（Optional = true）
  1. RegisterOutputParams 方法
protected override void RegisterOutputParams(GH_Component.GH_OutputParamManager pManager)
{base.RegisterOutputParams(pManager);
}

解释：
这个方法注册组件的输出参数。在这里，它只是调用基类的方法，没有添加额外的输出参数。

  1. SolveInstance 方法
protected override void SolveInstance(IGH_DataAccess DA)
{// ... (代码略)
}

解释：
这是组件的核心方法，执行实际的操作。

  • 获取输入数据（工作表、范围、颜色、选项等）
  • 根据输入参数应用条件格式
  • 设置输出数据

Key parts explanation (关键部分解释):

if (activate)
{if (clear) range.ClearConditions();range.AddConditionalBlanks(color, flip);
}

If activated, clear existing conditions if required, then add conditional formatting for blank cells.
如果激活，根据需要清除现有条件，然后为空白单元格添加条件格式。

  1. Icon 属性
protected override System.Drawing.Bitmap Icon
{get{return Properties.Resources.BB_Cond_Blank_01;}
}

解释：
这个属性提供组件的图标。它返回一个名为 “BB_Cond_Blank_01” 的资源图像。

  1. ComponentGuid 属性
public override Guid ComponentGuid
{get { return new Guid("f8e03658-c939-4d29-97a9-58d181a38c08"); }
}

解释：
这个属性返回组件的唯一标识符（GUID）。这个 GUID 在组件发布后不应更改，用于在 Grasshopper 中唯一标识此组件。

总结：
这个类实现了一个 Grasshopper 组件，用于在 Excel 工作表中为空白单元格添加条件格式。它展示了如何创建自定义 Grasshopper 组件，包括参数注册、核心逻辑实现、图标设置等。这种组件可以帮助用户更有效地分析和可视化 Excel 数据中的空白值。

Code

using Grasshopper.Kernel;
using Grasshopper.Kernel.Parameters;
using Grasshopper.Kernel.Types;
using Rhino.Geometry;
using System;
using System.Collections.Generic;
using Sd = System.Drawing;namespace Bumblebee.Components
{// 定义一个用于在Excel中为空白单元格添加条件格式的Grasshopper组件public class GH_Ex_Ana_CondBlank : GH_Ex_Rng__Base{/// <summary>/// 初始化 GH_Ex_An_CondBlank 类的新实例。/// </summary>public GH_Ex_Ana_CondBlank(): base("Conditional Blank", "Blank","Add conditional formatting to a Range based on blank values",Constants.ShortName, Constants.SubAnalysis){// 构造函数调用基类构造函数，设置组件名称、昵称、描述和分类}/// <summary>/// 设置组件的曝光级别。/// </summary>public override GH_Exposure Exposure{// 返回次要曝光级别，表示这是一个不太常用的组件get { return GH_Exposure.secondary; }}/// <summary>/// 注册该组件的所有输入参数。/// </summary>protected override void RegisterInputParams(GH_Component.GH_InputParamManager pManager){// 调用基类方法注册基本参数base.RegisterInputParams(pManager);pManager[1].Optional = true;// 添加单元格颜色参数pManager.AddColourParameter("Cell Color", "C", "The cell highlight color", GH_ParamAccess.item, Sd.Color.LightGray);pManager[2].Optional = true;// 添加翻转选项参数pManager.AddBooleanParameter("Flip", "F", "If true, filled cells will be highlighted", GH_ParamAccess.item, false);pManager[3].Optional = true;// 添加清除现有条件参数pManager.AddBooleanParameter("Clear", "_X", "If true, the existing conditions will be cleared", GH_ParamAccess.item, false);pManager[4].Optional = true;// 添加激活条件参数pManager.AddBooleanParameter("Activate", "_A", "If true, the condition will be applied", GH_ParamAccess.item, false);pManager[5].Optional = true;}/// <summary>/// 注册该组件的所有输出参数。/// </summary>protected override void RegisterOutputParams(GH_Component.GH_OutputParamManager pManager){// 调用基类方法注册输出参数base.RegisterOutputParams(pManager);}/// <summary>/// 这是实际执行工作的方法。/// </summary>/// <param name="DA">DA对象用于从输入检索数据并存储到输出。</param>protected override void SolveInstance(IGH_DataAccess DA){IGH_Goo gooS = null;DA.GetData(0, ref gooS);ExWorksheet worksheet = new ExWorksheet();bool hasWs = gooS.TryGetWorksheet(ref worksheet);IGH_Goo gooR = null;DA.GetData(1, ref gooR);ExRange range = new ExRange();if (!gooR.TryGetRange(ref range, worksheet)) return;if (!hasWs) worksheet = range.Worksheet;// 获取单元格高亮颜色Sd.Color color = Sd.Color.LightGray;DA.GetData(2, ref color);// 获取翻转选项bool flip = false;DA.GetData(3, ref flip);// 获取清除选项bool clear = false;DA.GetData(4, ref clear);// 获取激活选项bool activate = false;DA.GetData(5, ref activate);// 如果激活，则应用条件格式if (activate){// 如果需要清除，则清除现有条件if (clear) range.ClearConditions();// 添加基于空白值的条件格式range.AddConditionalBlanks(color, flip);}// 设置输出数据DA.SetData(0, range);}/// <summary>/// 提供组件的图标。/// </summary>protected override System.Drawing.Bitmap Icon{get{// 返回组件的图标return Properties.Resources.BB_Cond_Blank_01;}}/// <summary>/// 获取此组件的唯一ID。发布后不要更改此ID。/// </summary>public override Guid ComponentGuid{// 返回组件的唯一标识符get { return new Guid("f8e03658-c939-4d29-97a9-58d181a38c08"); }}}
}

这段代码现在包含了详细的中文注释，解释了每个方法和属性的功能。这些注释涵盖了：

  1. 类的整体功能
  2. 构造函数的作用
  3. 各个方法的用途和工作原理
  4. 输入参数和输出参数的含义
  5. SolveInstance 方法中的主要逻辑步骤
  6. 图标和GUID属性的作用

这篇关于【C#】【EXCEL】BumblebeeComponentsAnalysisGH_Ex_Ana_CondBlank.cs的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/1111310。

相关文章

Java实战之利用POI生成Excel图表

Java实战之利用POI生成Excel图表

《Java实战之利用POI生成Excel图表》ApachePOI是Java生态中处理Office文档的核心工具,这篇文章主要为大家详细介绍了如何在Excel中创建折线图,柱状图,饼图等常见图表,需要的... 目录一、环境配置与依赖管理二、数据源准备与工作表构建三、图表生成核心步骤1. 折线图（Line Ch
阅读更多...
Python3脚本实现Excel与TXT的智能转换

Python3脚本实现Excel与TXT的智能转换

《Python3脚本实现Excel与TXT的智能转换》在数据处理的日常工作中,我们经常需要将Excel中的结构化数据转换为其他格式,本文将使用Python3实现Excel与TXT的智能转换,需要的可以... 目录场景应用：为什么需要这种转换技术解析：代码实现详解核心代码展示改进点说明实战演练：从Excel到
阅读更多...
C# string转unicode字符的实现

C# string转unicode字符的实现

《C#string转unicode字符的实现》本文主要介绍了C#string转unicode字符的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随... 目录1. 获取字符串中每个字符的 Unicode 值示例代码：输出：2. 将 Unicode 值格式化
阅读更多...
Python自动化办公之合并多个Excel

Python自动化办公之合并多个Excel

《Python自动化办公之合并多个Excel》在日常的办公自动化工作中,尤其是处理大量数据时,合并多个Excel表格是一个常见且繁琐的任务,下面小编就来为大家介绍一下如何使用Python轻松实现合... 目录为什么选择 python 自动化目标使用 Python 合并多个 Excel 文件安装所需库示例代码
阅读更多...
C#中读取XML文件的四种常用方法

C#中读取XML文件的四种常用方法

《C#中读取XML文件的四种常用方法》Xml是Internet环境中跨平台的,依赖于内容的技术,是当前处理结构化文档信息的有力工具,下面我们就来看看C#中读取XML文件的方法都有哪些吧... 目录XML简介格式C#读取XML文件方法使用XmlDocument使用XmlTextReader/XmlTextWr
阅读更多...
Python创建Excel的4种方式小结

Python创建Excel的4种方式小结

《Python创建Excel的4种方式小结》这篇文章主要为大家详细介绍了Python中创建Excel的4种常见方式,文中的示例代码简洁易懂,具有一定的参考价值,感兴趣的小伙伴可以学习一下... 目录库的安装代码1——pandas代码2——openpyxl代码3——xlsxwriterwww.cppcns.c
阅读更多...
Python给Excel写入数据的四种方法小结

Python给Excel写入数据的四种方法小结

《Python给Excel写入数据的四种方法小结》本文主要介绍了Python给Excel写入数据的四种方法小结,包含openpyxl库、xlsxwriter库、pandas库和win32com库,具有... 目录1. 使用 openpyxl 库2. 使用 xlsxwriter 库3. 使用 pandas 库
阅读更多...
使用Python在Excel中创建和取消数据分组

使用Python在Excel中创建和取消数据分组

《使用Python在Excel中创建和取消数据分组》Excel中的分组是一种通过添加层级结构将相邻行或列组织在一起的功能,当分组完成后,用户可以通过折叠或展开数据组来简化数据视图,这篇博客将介绍如何使... 目录引言使用工具python在Excel中创建行和列分组Python在Excel中创建嵌套分组Pyt
阅读更多...
使用Python在Excel中插入、修改、提取和删除超链接

使用Python在Excel中插入、修改、提取和删除超链接

《使用Python在Excel中插入、修改、提取和删除超链接》超链接是Excel中的常用功能,通过点击超链接可以快速跳转到外部网站、本地文件或工作表中的特定单元格,有效提升数据访问的效率和用户体验,这... 目录引言使用工具python在Excel中插入超链接Python修改Excel中的超链接Python
阅读更多...
C#比较两个List集合内容是否相同的几种方法

C#比较两个List集合内容是否相同的几种方法

《C#比较两个List集合内容是否相同的几种方法》本文详细介绍了在C#中比较两个List集合内容是否相同的方法,包括非自定义类和自定义类的元素比较,对于非自定义类,可以使用SequenceEqual、... 目录 一、非自定义类的元素比较1. 使用 SequenceEqual 方法（顺序和内容都相等）2.
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2