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

本文主要是介绍【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# Where 泛型约束的实现

《C#Where泛型约束的实现》本文主要介绍了C#Where泛型约束的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧... 目录使用的对象约束分类where T : structwhere T : classwhere T : ne

C#实现将Excel表格转换为图片(JPG/ PNG)

《C#实现将Excel表格转换为图片(JPG/PNG)》Excel表格可能会因为不同设备或字体缺失等问题,导致格式错乱或数据显示异常,转换为图片后,能确保数据的排版等保持一致,下面我们看看如何使用C... 目录通过C# 转换Excel工作表到图片通过C# 转换指定单元格区域到图片知识扩展C# 将 Excel

C#中async await异步关键字用法和异步的底层原理全解析

《C#中asyncawait异步关键字用法和异步的底层原理全解析》:本文主要介绍C#中asyncawait异步关键字用法和异步的底层原理全解析,本文给大家介绍的非常详细,对大家的学习或工作具有一... 目录C#异步编程一、异步编程基础二、异步方法的工作原理三、代码示例四、编译后的底层实现五、总结C#异步编程

C#TextBox设置提示文本方式(SetHintText)

《C#TextBox设置提示文本方式(SetHintText)》:本文主要介绍C#TextBox设置提示文本方式(SetHintText),具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑... 目录C#TextBox设置提示文本效果展示核心代码总结C#TextBox设置提示文本效果展示核心代

C#中DrawCurve的用法小结

《C#中DrawCurve的用法小结》本文主要介绍了C#中DrawCurve的用法小结,通常用于绘制一条平滑的曲线通过一系列给定的点,具有一定的参考价值,感兴趣的可以了解一下... 目录1. 如何使用 DrawCurve 方法(不带弯曲程度)2. 如何使用 DrawCurve 方法(带弯曲程度)3.使用Dr

使用Python将JSON,XML和YAML数据写入Excel文件

《使用Python将JSON,XML和YAML数据写入Excel文件》JSON、XML和YAML作为主流结构化数据格式,因其层次化表达能力和跨平台兼容性,已成为系统间数据交换的通用载体,本文将介绍如何... 目录如何使用python写入数据到Excel工作表用Python导入jsON数据到Excel工作表用

使用C#代码在PDF文档中添加、删除和替换图片

《使用C#代码在PDF文档中添加、删除和替换图片》在当今数字化文档处理场景中,动态操作PDF文档中的图像已成为企业级应用开发的核心需求之一,本文将介绍如何在.NET平台使用C#代码在PDF文档中添加、... 目录引言用C#添加图片到PDF文档用C#删除PDF文档中的图片用C#替换PDF文档中的图片引言在当

详解C#如何提取PDF文档中的图片

《详解C#如何提取PDF文档中的图片》提取图片可以将这些图像资源进行单独保存,方便后续在不同的项目中使用,下面我们就来看看如何使用C#通过代码从PDF文档中提取图片吧... 当 PDF 文件中包含有价值的图片,如艺术画作、设计素材、报告图表等,提取图片可以将这些图像资源进行单独保存,方便后续在不同的项目中使

C#使用SQLite进行大数据量高效处理的代码示例

《C#使用SQLite进行大数据量高效处理的代码示例》在软件开发中,高效处理大数据量是一个常见且具有挑战性的任务,SQLite因其零配置、嵌入式、跨平台的特性,成为许多开发者的首选数据库,本文将深入探... 目录前言准备工作数据实体核心技术批量插入:从乌龟到猎豹的蜕变分页查询:加载百万数据异步处理:拒绝界面

C#数据结构之字符串(string)详解

《C#数据结构之字符串(string)详解》:本文主要介绍C#数据结构之字符串(string),具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录转义字符序列字符串的创建字符串的声明null字符串与空字符串重复单字符字符串的构造字符串的属性和常用方法属性常用方法总结摘