如何在Visual Studio C#中为Grasshopper组件添加底部信息

核心逻辑 #

Grasshopper组件底部显示的信息，是靠重写组件类里的Message属性实现的——这个属性直接控制组件下方的文本内容。

具体操作步骤 #

1. 定位组件类文件：在Visual Studio的GHA项目中，找到你编写的、继承自GH_Component的自定义组件.cs文件（比如MyCustomComponent.cs）。
2. 添加重写代码：在组件类内部插入以下代码：

public override string Message
{
    get
    {
        // 这里填写你要显示的固定文本，比如版本信息
        return "自定义组件 | v1.0";
    }
}

如果需要根据组件状态动态切换内容（比如输入为空时提示，正常运行显示就绪），可以改成：

public override string Message
{
    get
    {
        // 检查第一个输入端口是否有连接数据
        if (Params.Input[0].SourceCount == 0)
        {
            return "请先输入必要参数";
        }
        return "运行正常 | v1.0";
    }
}

要是想给消息加样式（比如警告黄色、错误红色），还可以额外重写MessageType属性：

public override GH_Message MessageType
{
    get
    {
        if (Params.Input[0].SourceCount == 0)
        {
            // 警告样式，文本显示为黄色
            return GH_Message.Warning;
        }
        // 普通默认样式
        return GH_Message.None;
    }
}

参考内容翻译 #

第一个论坛讨论内容 #

问题：在Visual Studio用C#开发GH组件，怎么添加底部消息？
解答：重写组件的Message属性即可。这个属性默认返回空字符串，你可以自定义返回的文本，甚至能根据组件的输入输出状态动态调整显示内容。

第二个论坛讨论内容 #

问题：GH组件的Message属性怎么实现？
解答：GH_Component基类自带Message虚属性，在自定义组件中重写它，返回你需要的文本就可以。如果需要不同样式的消息，还可以结合重写MessageType属性，指定消息类型（普通、警告、错误），对应不同的显示样式。

内容的提问来源于stack exchange，提问作者Abba