Display_D_HP/TeamAAS-VM/Core/Lights/LightChannelEventArgs.cs

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace TeamAAS_VP.Core.Lights
{
    /// <summary>
    /// 提供有关单个灯光通道状态更改的事件数据。
    /// </summary>
    /// <remarks>
    /// 此类型封装了触发灯光通道相关事件时需要传递的基本信息，
    /// 包括通道实例、通道是否开启以及当前亮度值。
    /// </remarks>
    public class LightChannelEventArgs : EventArgs
    {
        /// <summary>
        /// 获取触发事件的灯光通道实例。
        /// </summary>
        /// <seealso cref="ILightChannel"/>
        public ILightChannel Channel { get; }

        /// <summary>
        /// 获取通道当前的开/关状态；若为 <c>true</c> 则表示已开启。
        /// </summary>
        public bool IsOn { get; }

        /// <summary>
        /// 获取通道当前的亮度值（具体取值范围由实现决定）。
        /// </summary>
        public int Brightness { get; }

        /// <summary>
        /// 使用指定的通道、开关状态和亮度初始化 <see cref="LightChannelEventArgs"/> 的新实例。
        /// </summary>
        /// <param name="channel">触发事件的灯光通道实例。</param>
        /// <param name="isOn">通道的开/关状态；为 <c>true</c> 表示已开启。</param>
        /// <param name="brightness">通道的亮度值（实现决定其有效范围）。</param>
        public LightChannelEventArgs(ILightChannel channel, bool isOn, int brightness)
        {
            Channel = channel;
            IsOn = isOn;
            Brightness = brightness;
        }
    }
}