SemiEquip.UI.WinForms 1.0.0

SemiEquip.UI.WinForms

面向半导体自动化设备软件的 WinForms 自定义控件库。

项目目标为 C# / .NET Framework 4.0+ / WinForms，当前保留 FoupMapControl、FourColorLightControl、ActionSensorButtonControl 三个控件。控件说明、属性和使用实例统一维护在本文档中。

项目结构

• src/SemiEquip.UI.WinForms：可复用自定义控件库。
• src/SemiEquip.UI.WinForms/Controls/FoupMap：FOUP Map 控件及其辅助类型。
• src/SemiEquip.UI.WinForms/Controls/FourColorLight：四色灯控件。
• src/SemiEquip.UI.WinForms/Controls/ActionSensorButton：动作传感器按钮控件。
• samples/SemiEquip.UI.WinForms.Demo：WinForms Demo 示例程序。
• tests/SemiEquip.UI.WinForms.Tests：兼容 net40 的自动化验证程序。

安装和引用

当前项目以源码方式维护，其他 WinForms 项目可引用构建输出的 DLL，也可在同一解决方案中使用项目引用。

using SemiEquip.UI.WinForms.Controls;

FoupMapControl

FoupMapControl 用于绘制 FOUP / Cassette 的 Slot Map，通过颜色、文字和选片状态展示每个槽位的 wafer 状态。

核心行为

• 最大 Slot 数量为 25。
• SlotCount 范围为 1 到 25；控件 Handle 创建后不允许修改。
• 控件宽高可自由设置，内部 Slot 会按可用空间自动布局。
• 扣除 ContentPadding 后，横向区域按 Slot 编号、Slot 主体、选片勾选框约 1:8:1 分配。
• Slot 高度按可用内容总高度除以 SlotCount 计算。
• Slots 提供只读槽位快照，槽位数据应通过公开方法修改。
• Slot 内文字统一使用 SlotText，提示文字统一使用 SlotTipText。
• Slot 内文字字体可通过 SlotTextFont 设置；默认 AutoScaleSlotTextFont = true，空间不足时自动缩小。
• 默认字体为 Times New Roman。
• 默认不填充控件底色，背景跟随父容器。
• 左侧 Slot 编号默认黑色显示。

Slot 状态

主要属性

方法

事件

基本示例

var foupMap = new FoupMapControl();
foupMap.Location = new Point(32, 32);
foupMap.Size = new Size(180, 360);
foupMap.SlotCount = 25;
foupMap.ShowSlotNumbers = true;
foupMap.ShowSelectionCheckBoxes = true;
foupMap.ShowSlotText = true;
foupMap.ShowSlotTip = true;

foupMap.SetSlotState(1, FoupSlotState.Empty);
foupMap.SetSlotState(2, FoupSlotState.BeforeProcess);
foupMap.SetSlotState(3, FoupSlotState.AfterProcess);
foupMap.SetSlotState(4, FoupSlotState.Abnormal);
foupMap.SetSlotColor(5, Color.Gold);
foupMap.SetSlotText(2, "S02");
foupMap.SetSlotTipText(2, "Slot 02 当前为制程前状态。");
foupMap.SetSlotSelected(25, true);

Controls.Add(foupMap);

Slot 内字体示例

固定字体大小：

foupMap.SlotTextFont = new Font("Times New Roman", 9f, FontStyle.Regular);
foupMap.AutoScaleSlotTextFont = false;

以 9pt 为基准，空间不足时自动缩小：

foupMap.SlotTextFont = new Font("Times New Roman", 9f, FontStyle.Regular);
foupMap.AutoScaleSlotTextFont = true;

选片数据示例

foupMap.ChooseMapData = "1000000000000000000000001";

bool slot1Selected = foupMap.GetSlotSelected(1);
bool slot25Selected = foupMap.GetSlotSelected(25);
string chooseMapData = foupMap.ChooseMapData;

点击事件示例

foupMap.SlotClick += delegate(object sender, FoupSlotClickEventArgs e)
{
    int slotNumber = e.SlotNumber;
    FoupSlotState state = foupMap.GetSlotState(slotNumber);
    string slotText = foupMap.GetSlotText(slotNumber);
    string slotTipText = foupMap.GetSlotTipText(slotNumber);
};

ActionSensorButtonControl

ActionSensorButtonControl 是一个左侧带状态灯的 Button 控件，用于同时显示 PLC 动作 BOOL 状态和 0/1/2 个 IO Sensor 状态，适合气缸、夹爪、挡停、门锁、轴定位等设备动作点位。

控件不绑定固定业务颜色。动作状态、传感器状态、边框和阴影均通过属性配置，Demo 中的颜色只作为预览示例。

核心行为

• 按钮主体显示 ButtonText。
• 按钮底色通过 CommandState 和配置颜色表达 PLC 动作 BOOL。
• 左侧按 SensorMode 显示 0、1 或 2 个传感器状态灯。
• 状态灯固定上下排列；单灯时垂直居中。
• 状态灯形状、左边距、与文字距离和按钮圆角均可配置。
• 控件继承 Control 并复用标准 Click 事件，第一版不区分点击区域。
• 控件支持缩放绘制，小尺寸下文字使用省略和自动缩小避免明显重叠。

属性

基本示例

var actionButton = new ActionSensorButtonControl();
actionButton.Location = new Point(32, 32);
actionButton.Size = new Size(180, 58);
actionButton.ButtonText = "顶升气缸";
actionButton.CommandState = plcLiftCommand;
actionButton.SensorMode = SensorDisplayMode.Two;
actionButton.Sensor1State = ioLiftUpSensor;
actionButton.Sensor2State = ioLiftDownSensor;

actionButton.CommandOnBackColor = Color.FromArgb(226, 64, 64);      // CommandState = true
actionButton.DefaultBack = Color.FromArgb(225, 236, 251);           // 默认底色
actionButton.BackHover = Color.FromArgb(43, 125, 211);              // 鼠标悬浮
actionButton.BackActive = Color.FromArgb(32, 104, 184);             // 鼠标按下 / CommandState = true
actionButton.CommandOnForeColor = Color.White;
actionButton.CommandOffForeColor = Color.Black;
actionButton.ForeHover = Color.White;
actionButton.SensorOnColor = Color.FromArgb(40, 112, 210);
actionButton.SensorOffColor = Color.White;
actionButton.SensorBorderColor = Color.FromArgb(40, 112, 210);
actionButton.Radius = 8;
actionButton.SensorShape = SensorIndicatorShape.Rectangle;
actionButton.SensorLeftPadding = 10;
actionButton.SensorTextSpacing = 8;
actionButton.Shadow = 4;
actionButton.ShadowOffsetY = 1;
actionButton.ShadowOpacity = 0.18f;

actionButton.Click += delegate
{
    // 在业务代码中下发 PLC 动作或打开操作确认。
};

Controls.Add(actionButton);

单传感器示例

var axisButton = new ActionSensorButtonControl();
axisButton.ButtonText = "X 轴定位";
axisButton.SensorMode = SensorDisplayMode.One;
axisButton.SensorShape = SensorIndicatorShape.RoundedRectangle;

FourColorLightControl

FourColorLightControl 用于绘制竖向四色灯，从上到下依次为红、黄、绿、蓝四个相连灯段。控件适合设备运行、等待、报警、人工介入等状态提示。

核心行为

• 每个灯段通过独立 bool 属性控制亮暗。
• true 显示亮色，false 显示暗色。
• 默认保持高度:宽度为 4:1。
• 默认四段相连，LightGap = 0。
• 支持横向细纹，模拟磨砂或棱纹塑料效果。
• 支持配置每个灯段的亮色、暗色、阴影色和高光色。

属性

方法

基本示例

var fourColorLight = new FourColorLightControl();
fourColorLight.Location = new Point(32, 32);
fourColorLight.Size = new Size(80, 320);
fourColorLight.RedLightOn = false;
fourColorLight.YellowLightOn = false;
fourColorLight.GreenLightOn = true;
fourColorLight.BlueLightOn = false;
fourColorLight.ShowFrostedLines = true;

Controls.Add(fourColorLight);

状态切换示例

// 运行中：绿灯亮
fourColorLight.SetLightStates(false, false, true, false);

// 报警：红灯和黄灯亮
fourColorLight.SetLightStates(true, true, false, false);

// 全部关闭
fourColorLight.SetLightStates(false, false, false, false);

自定义颜色示例

fourColorLight.RedOnColor = Color.FromArgb(255, 70, 70);
fourColorLight.RedOffColor = Color.FromArgb(80, 24, 24);
fourColorLight.LightGap = 2;
fourColorLight.FrostedLineSpacing = 4;

自动化验证

在 SemiEquip.UI.WinForms 目录执行：

dotnet build SemiEquip.UI.WinForms.sln -c Release
.\tests\SemiEquip.UI.WinForms.Tests\bin\Release\net40\SemiEquip.UI.WinForms.Tests.exe

当前验证覆盖 FoupMapControl 的 SlotCount 锁定、只读 Slots、ChooseMapData、SlotText 与 SlotTipText 等核心行为；覆盖 ActionSensorButtonControl 的基础属性、颜色配置和绘制路径；FourColorLightControl 通过解决方案构建覆盖编译验证。