【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。

相关文章

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.
阅读更多...
如何利用Python实现给Excel表格截图

如何利用Python实现给Excel表格截图

《如何利用Python实现给Excel表格截图》这篇文章主要为大家详细介绍了如何利用Python实现给Excel表格截图功能,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 我搜索了网络上的方案，感觉把 Excel 表格转换为 html 再用 platwright 截图是比China编程较顺
阅读更多...
C#使用DeepSeek API实现自然语言处理,文本分类和情感分析

C#使用DeepSeek API实现自然语言处理,文本分类和情感分析

《C#使用DeepSeekAPI实现自然语言处理,文本分类和情感分析》在C#中使用DeepSeekAPI可以实现多种功能,例如自然语言处理、文本分类、情感分析等,本文主要为大家介绍了具体实现步骤,... 目录准备工作文本生成文本分类问答系统代码生成翻译功能文本摘要文本校对图像描述生成总结在C#中使用Deep
阅读更多...
Java导出Excel动态表头的示例详解

Java导出Excel动态表头的示例详解

《Java导出Excel动态表头的示例详解》这篇文章主要为大家详细介绍了Java导出Excel动态表头的相关知识,文中的示例代码简洁易懂,具有一定的借鉴价值,有需要的小伙伴可以了解下... 目录前言一、效果展示二、代码实现1.固定头实体类2.动态头实现3.导出动态头前言本文只记录大致思路以及做法，代码不进
阅读更多...
C#从XmlDocument提取完整字符串的方法

C#从XmlDocument提取完整字符串的方法

《C#从XmlDocument提取完整字符串的方法》文章介绍了两种生成格式化XML字符串的方法,方法一使用`XmlDocument`的`OuterXml`属性,但输出的XML字符串不带格式,可读性差,... 方法1：通过XMLDocument的OuterXml属性，见XmlDocument类该方法获得的xm
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2