【C#】【EXCEL】Bumblebee/Components/Analysis/GH_Ex_Ana_CondBetween.cs

2024-08-26 01:04
文章标签 c# excel .net cs components netcore ex analysis gh ana bumblebee condbetween

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

这段代码定义了一个名为 GH_Ex_Ana_CondBetween 的 Grasshopper 组件，其主要功能是为 Excel 工作表中的特定范围添加条件格式。具体来说：

  1. 功能概述：

    • 为 Excel 中的数据范围添加基于区间值的条件格式
    • 允许用户自定义高亮颜色
    • 提供选项来反转条件（高亮区间外的值）
    • 可以清除现有的条件格式
    • 可以控制是否激活条件格式

  2. 输入参数：

    • 工作表数据
    • 范围数据
    • 区间（用于评估的数值范围）
    • 单元格颜色
    • 是否反转条件
    • 是否清除现有条件
    • 是否激活条件格式

  3. 输出：

    • 处理后的 Excel 范围对象

  4. 组件特性：

    • 作为次要组件显示在 Grasshopper 界面中
    • 具有自定义图标
    • 有唯一的组件标识符（GUID）

  5. 使用场景：
    这个组件适用于需要在 Grasshopper 中处理 Excel 数据的情况，特别是当用户想要突出显示落在特定数值区间内（或外）的数据时。它可以帮助用户快速识别符合特定条件的数据，提高数据分析和可视化的效率。

  6. 代码结构：

    • 继承自基础范围组件 (GH_Ex_Rng__Base)
    • 重写了多个方法来自定义组件行为
    • 使用 SolveInstance 方法实现主要逻辑

  7. 扩展性：
    这个组件展示了如何将 Excel 的高级功能集成到 Grasshopper 中，为数据分析和可视化提供了更多可能性。类似的方法可以用于创建其他类型的 Excel 数据处理组件。

总的来说，这个组件为 Grasshopper 用户提供了一种灵活的方式来对 Excel 数据应用条件格式，特别是基于数值区间的格式。它体现了将 Excel 的强大功能与 Grasshopper 的参数化设计能力相结合的潜力，为建筑、工程等领域的专业人士提供了更强大的数据处理和可视化工具。

Flow diagram
成功 / Success
失败 / Failure
成功 / Success
失败 / Failure
是 / Yes
否 / No
是 / Yes
否 / No
开始 / Start
初始化参数 / Initialize Parameters
获取工作表数据 / Get Worksheet Data
获取范围数据 / Get Range Data
结束 / End
获取其他输入参数 / Get Other Input Parameters
是否激活条件? / Activate Condition?
是否清除现有条件? / Clear Existing Conditions?
设置输出数据 / Set Output Data
清除条件 / Clear Conditions
添加条件格式 / Add Conditional Formatting

这个流程图对应到代码中的主要步骤如下：

  1. 开始 (Start): 对应 SolveInstance 方法的开始。
  2. 初始化参数 (Initialize Parameters): 对应方法开始时的变量声明。
  3. 获取工作表数据 (Get Worksheet Data): 对应 DA.GetData(0, ref gooS) 和相关处理。
  4. 获取范围数据 (Get Range Data): 对应 DA.GetData(1, ref gooR) 和相关处理。
  5. 获取其他输入参数 (Get Other Input Parameters): 对应获取间隔、颜色、翻转、清除和激活等参数的代码。
  6. 是否激活条件? (Activate Condition?): 对应 if (activate) 条件判断。
  7. 是否清除现有条件? (Clear Existing Conditions?): 对应 if (clear) 条件判断。
  8. 清除条件 (Clear Conditions): 对应 range.ClearConditions() 调用。
  9. 添加条件格式 (Add Conditional Formatting): 对应 range.AddConditionalBetween() 调用。
  10. 设置输出数据 (Set Output Data): 对应 DA.SetData(0, range) 调用。
  11. 结束 (End): 对应方法的结束。

这个流程图清晰地展示了代码的主要逻辑流程，包括数据获取、条件判断和操作执行的顺序。

Description

  1. 构造函数 GH_Ex_Ana_CondBetween()
public GH_Ex_Ana_CondBetween(): base("Conditional Between", "Between","Add conditional formatting to a Range for values between two numbers",Constants.ShortName, Constants.SubAnalysis)
{
}

解释：
这是组件的构造函数。它调用基类构造函数，设置组件的名称、昵称、描述和分类。初始化条件格式（区间）组件，设置其基本信息。
Initializes the Conditional Between component, setting its basic information.

  1. Exposure 属性
public override GH_Exposure Exposure
{get { return GH_Exposure.secondary; }
}

解释：
设置组件在 Grasshopper 界面中的显示级别。将组件设置为次要显示级别，通常在子菜单中显示。
Sets the component to secondary exposure level, typically displayed in a submenu.

  1. RegisterInputParams 方法
protected override void RegisterInputParams(GH_Component.GH_InputParamManager pManager)
{base.RegisterInputParams(pManager);pManager[1].Optional = true;pManager.AddIntervalParameter("Domain", "D", "The domain to evaluate", GH_ParamAccess.item);pManager.AddColourParameter("Cell Color", "C", "The cell highlight color", GH_ParamAccess.item, Sd.Color.LightGray);// ... 其他参数注册
}

解释：
注册组件的输入参数。调用基类方法注册基本参数，然后添加特定于此组件的参数。定义组件所需的输入数据，如区间、颜色、条件设置等。
Defines the input data required by the component, such as interval, color, condition settings, etc.

  1. RegisterOutputParams 方法
protected override void RegisterOutputParams(GH_Component.GH_OutputParamManager pManager)
{base.RegisterOutputParams(pManager);
}

解释：
注册组件的输出参数。这里直接调用基类方法，表明输出与基类相同。定义组件的输出数据，在这里与基类输出相同。
Defines the output data of the component, which is the same as the base class in this case.

  1. SolveInstance 方法
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;// 获取其他参数Interval interval = new Interval();if (!DA.GetData(2, ref interval)) return;Sd.Color color = Sd.Color.LightGray;DA.GetData(3, ref color);// ... 获取其他参数// 应用条件格式if (activate){if (clear) range.ClearConditions();range.AddConditionalBetween(interval.Min, interval.Max, color, flip);}// 设置输出DA.SetData(0, range);
}

解释：
这是组件的核心方法，执行实际的数据处理。依次获取输入数据，处理工作表和范围信息，然后根据设置应用条件格式。
Sequentially retrieves input data, processes worksheet and range information, then applies conditional formatting based on settings.
关键步骤包括：

  1. 获取并验证工作表和范围数据

  2. 获取条件格式的参数（区间、颜色等）

  3. 根据激活状态决定是否应用条件格式

  4. 如果需要，清除现有条件并添加新的条件格式

  5. 输出处理后的范围对象

  6. Icon 属性

protected override System.Drawing.Bitmap Icon
{get{return Properties.Resources.BB_Cond_Between_01;}
}

解释：
提供组件的图标。返回组件在 Grasshopper 界面中显示的自定义图标。
Returns the custom icon displayed for the component in the Grasshopper interface.

  1. ComponentGuid 属性
public override Guid ComponentGuid
{get { return new Guid("bd35ec14-ab24-4bbf-99ae-38ccc3d4a6da"); }
}

解释：
定义组件的唯一标识符。返回组件的唯一 GUID，用于 Grasshopper 内部识别和管理。
Returns the unique GUID of the component, used for internal identification and management in Grasshopper.

总结：
这个组件展示了如何创建一个自定义的 Grasshopper 组件，用于在 Excel 范围内应用条件格式。它demonstrates了参数注册、数据处理和 Excel 操作的集成。通过这种方式，开发者可以扩展 Grasshopper 的功能，为用户提供更强大的数据分析和可视化工具。

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
{// 定义一个条件格式（区间）组件类，继承自基础范围组件public class GH_Ex_Ana_CondBetween : GH_Ex_Rng__Base{/// <summary>/// 初始化 GH_Ex_An_CondBetween 类的新实例/// </summary>public GH_Ex_Ana_CondBetween(): base("Conditional Between", "Between","Add conditional formatting to a Range for values between two numbers",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.AddIntervalParameter("Domain", "D", "The domain to evaluate", GH_ParamAccess.item); // 添加区间参数pManager.AddColourParameter("Cell Color", "C", "The cell highlight color", GH_ParamAccess.item, Sd.Color.LightGray); // 添加颜色参数，默认为浅灰色pManager[3].Optional = true; // 设置为可选pManager.AddBooleanParameter("Flip", "F", "If true, non unique values will be highlighted", GH_ParamAccess.item, false); // 添加翻转参数pManager[4].Optional = true; // 设置为可选pManager.AddBooleanParameter("Clear", "_X", "If true, the existing conditions will be cleared", GH_ParamAccess.item, false); // 添加清除条件参数pManager[5].Optional = true; // 设置为可选pManager.AddBooleanParameter("Activate", "_A", "If true, the condition will be applied", GH_ParamAccess.item, false); // 添加激活条件参数pManager[6].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; // 如果之前没有获取到工作表，从范围中获取Interval interval = new Interval();if (!DA.GetData(2, ref interval)) return; // 获取区间数据Sd.Color color = Sd.Color.LightGray;DA.GetData(3, ref color); // 获取颜色数据bool flip = false;DA.GetData(4, ref flip); // 获取是否翻转bool clear = false;DA.GetData(5, ref clear); // 获取是否清除现有条件bool activate = false;DA.GetData(6, ref activate); // 获取是否激活条件if (activate){if (clear) range.ClearConditions(); // 如果需要清除，则清除现有条件range.AddConditionalBetween(interval.Min, interval.Max, color, flip); // 添加条件格式}DA.SetData(0, range); // 设置输出数据}/// <summary>/// 提供组件的图标/// </summary>protected override System.Drawing.Bitmap Icon{get{// 你可以将图像文件添加到项目资源中并像这样访问它们：// return Resources.IconForThisComponent;return Properties.Resources.BB_Cond_Between_01;}}/// <summary>/// 获取此组件的唯一 ID。发布后不要更改此 ID。/// </summary>public override Guid ComponentGuid{get { return new Guid("bd35ec14-ab24-4bbf-99ae-38ccc3d4a6da"); }}}
}

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


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

相关文章

java中使用POI生成Excel并导出过程

java中使用POI生成Excel并导出过程

《java中使用POI生成Excel并导出过程》：本文主要介绍java中使用POI生成Excel并导出过程,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录需求说明及实现方式需求完成通用代码版本1版本2结果展示type参数为atype参数为b总结注：本文章中代码均为
阅读更多...
C#基础之委托详解(Delegate)

C#基础之委托详解(Delegate)

《C#基础之委托详解(Delegate)》：本文主要介绍C#基础之委托(Delegate),具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录1. 委托定义2. 委托实例化3. 多播委托（Multicast Delegates）4. 委托的用途事件处理回调函数LINQ
阅读更多...
在C#中调用Python代码的两种实现方式

在C#中调用Python代码的两种实现方式

《在C#中调用Python代码的两种实现方式》：本文主要介绍在C#中调用Python代码的两种实现方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录C#调用python代码的方式1. 使用 Python.NET2. 使用外部进程调用 Python 脚本总结C#调
阅读更多...
利用Python开发Markdown表格结构转换为Excel工具

利用Python开发Markdown表格结构转换为Excel工具

《利用Python开发Markdown表格结构转换为Excel工具》在数据管理和文档编写过程中,我们经常使用Markdown来记录表格数据,但它没有Excel使用方便,所以本文将使用Python编写一... 目录1.完整代码2. 项目概述3. 代码解析3.1 依赖库3.2 GUI 设计3.3 解析 Mark
阅读更多...
C#中的 StreamReader/StreamWriter 使用示例详解

C#中的 StreamReader/StreamWriter 使用示例详解

《C#中的StreamReader/StreamWriter使用示例详解》在C#开发中,StreamReader和StreamWriter是处理文本文件的核心类,属于System.IO命名空间,本... 目录前言一、什么是 StreamReader 和 StreamWriter？1. 定义2. 特点3. 用
阅读更多...
Java利用poi实现word表格转excel

Java利用poi实现word表格转excel

《Java利用poi实现word表格转excel》这篇文章主要为大家详细介绍了Java如何利用poi实现word表格转excel,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 一、每行对象类需要针对不同的表格进行对应的创建。package org.example.wordToEx
阅读更多...
利用Python实现添加或读取Excel公式

利用Python实现添加或读取Excel公式

《利用Python实现添加或读取Excel公式》Excel公式是数据处理的核心工具,从简单的加减运算到复杂的逻辑判断,掌握基础语法是高效工作的起点,下面我们就来看看如何使用Python进行Excel公... 目录python Excel 库安装Python 在 Excel 中添加公式/函数Python 读取
阅读更多...
基于Python开发批量提取Excel图片的小工具

基于Python开发批量提取Excel图片的小工具

《基于Python开发批量提取Excel图片的小工具》这篇文章主要为大家详细介绍了如何使用Python中的openpyxl库开发一个小工具,可以实现批量提取Excel图片,有需要的小伙伴可以参考一下... 目前有一个需求，就是批量读取当前目录下所有文件夹里的Excel文件，去获取出Excel文件中的图片，并
阅读更多...
Java导入、导出excel用法步骤保姆级教程(附封装好的工具类)

Java导入、导出excel用法步骤保姆级教程(附封装好的工具类)

《Java导入、导出excel用法步骤保姆级教程(附封装好的工具类)》：本文主要介绍Java导入、导出excel的相关资料,讲解了使用Java和ApachePOI库将数据导出为Excel文件,包括... 目录前言一、引入Apache POI依赖二、用法&步骤2.1 创建Excel的元素2.3 样式和字体2.
阅读更多...
使用EasyExcel实现简单的Excel表格解析操作

使用EasyExcel实现简单的Excel表格解析操作

《使用EasyExcel实现简单的Excel表格解析操作》：本文主要介绍如何使用EasyExcel完成简单的表格解析操作,同时实现了大量数据情况下数据的分次批量入库,并记录每条数据入库的状态,感兴... 目录前言固定模板及表数据格式的解析实现Excel模板内容对应的实体类实现AnalysisEventLis
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2