Table of Contents

Struct Color

Namespace
Kook
Assembly
Kook.Net.Core.dll

表示 KOOK 中使用的颜色。

public readonly struct Color : IEquatable<Color>
Implements
Inherited Members

Constructors

Color(byte, byte, byte)

使用指定的 RGB 通道值初始化一个 Color 结构的新实例。

public Color(byte r, byte g, byte b)

Parameters

r byte

红色通道的强度。

g byte

绿色通道的强度。

b byte

蓝色通道的强度。

Examples

创建 #607D8B(http://www.color-hex.com/color/607d8b)所表示的颜色:

Color darkGrey = new Color((byte)0x60, (byte)0x7D, (byte)0x8B);

Exceptions

ArgumentException

所提供的三个通道的强度值所组成的颜色的原始值超过了 MaxDecimalValue

Color(int, int, int)

使用指定的 RGB 通道值初始化一个 Color 结构的新实例。

public Color(int r, int g, int b)

Parameters

r int

红色通道的强度。

g int

绿色通道的强度。

b int

蓝色通道的强度。

Examples

创建 #607D8B(http://www.color-hex.com/color/607d8b)所表示的颜色:

Color darkGrey = new Color(96, 125, 139);

Exceptions

ArgumentException

所提供的三个通道的强度值所组成的颜色的原始值超过了 MaxDecimalValue

Color(float, float, float)

使用指定的 RGB 通道值初始化一个 Color 结构的新实例。

public Color(float r, float g, float b)

Parameters

r float

红色通道的强度。

g float

绿色通道的强度。

b float

蓝色通道的强度。

Examples

创建 #607D8B(http://www.color-hex.com/color/607d8b)所表示的颜色:

Color darkGrey = new Color(0.38f, 0.49f, 0.55f);

Exceptions

ArgumentException

所提供的三个通道的强度值所组成的颜色的原始值超过了 MaxDecimalValue

Color(uint)

使用指定的 24 位无符号整型值初始化一个 Color 结构的新实例。

public Color(uint rawValue)

Parameters

rawValue uint

颜色的 24 位无符号整型原始值。

Examples

创建 #607D8B(http://www.color-hex.com/color/607d8b)所表示的颜色:

Color darkGrey = new Color(0x607D8B);

Exceptions

ArgumentException

颜色原始值超过了 MaxDecimalValue

Fields

Blue

获取天蓝色。

public static readonly Color Blue

Field Value

Color

Remarks

天蓝色 #3498DB(http://www.color-hex.com/color/3498db)。

DarkBlue

获取深蓝色。

public static readonly Color DarkBlue

Field Value

Color

Remarks

深蓝色 #206694(http://www.color-hex.com/color/206694)。

DarkGreen

获取深绿色。

public static readonly Color DarkGreen

Field Value

Color

Remarks

深绿色 #1F8B4C(http://www.color-hex.com/color/1f8b4c)。

DarkGrey

获取钢蓝色。

public static readonly Color DarkGrey

Field Value

Color

Remarks

钢蓝色 #607D8B(http://www.color-hex.com/color/607d8b)。

DarkMagenta

获取深粉色。

public static readonly Color DarkMagenta

Field Value

Color

Remarks

深粉色 #AD1457(http://www.color-hex.com/color/ad1457)。

DarkOrange

获取深橙色。

public static readonly Color DarkOrange

Field Value

Color

Remarks

深橙色 #A84300(http://www.color-hex.com/color/a84300)。

DarkPurple

获取深紫色。

public static readonly Color DarkPurple

Field Value

Color

Remarks

深紫色 #71368A(http://www.color-hex.com/color/71368a)。

DarkRed

获取深红色。

public static readonly Color DarkRed

Field Value

Color

Remarks

深红色 #992D22(http://www.color-hex.com/color/992d22)。

DarkTeal

获取深青绿色。

public static readonly Color DarkTeal

Field Value

Color

Remarks

深青绿色 #11806A(http://www.color-hex.com/color/11806a)。

DarkerGrey

获取深青色。

public static readonly Color DarkerGrey

Field Value

Color

Remarks

深青色 #3A4B53(http://www.color-hex.com/color/3a4b53)。

Default

获取默认颜色。

public static readonly Color Default

Field Value

Color

Gold

获取金黄色。

public static readonly Color Gold

Field Value

Color

Remarks

金黄色 #F1C40F(http://www.color-hex.com/color/f1c40f)。

Green

获取绿色。

public static readonly Color Green

Field Value

Color

Remarks

绿色 #2ECC71(http://www.color-hex.com/color/2ecc71)。

Grey

获取暗灰色。

public static readonly Color Grey

Field Value

Color

Remarks

暗灰色 #666D71(http://www.color-hex.com/color/666d71)。

LightGrey

获取浅灰色。

public static readonly Color LightGrey

Field Value

Color

Remarks

浅灰色 #95A5A6(http://www.color-hex.com/color/95a5a6)。

LightOrange

获取褐橙色。

public static readonly Color LightOrange

Field Value

Color

Remarks

褐橙色 #C27C0E(http://www.color-hex.com/color/c27c0e)。

Magenta

获取玫瑰红。

public static readonly Color Magenta

Field Value

Color

Remarks

玫瑰红 #E91E63(http://www.color-hex.com/color/e91e63)。

MaxDecimalValue

获取一个 KOOK 颜色的最大值的原始值。

public const uint MaxDecimalValue = 16777215

Field Value

uint

Orange

获取橙色。

public static readonly Color Orange

Field Value

Color

Remarks

橙色 #E67E22(http://www.color-hex.com/color/e67e22)。

Purple

获取紫色。

public static readonly Color Purple

Field Value

Color

Remarks

紫色 #9B59B6(http://www.color-hex.com/color/9b59b6)。

Red

获取猩红色。

public static readonly Color Red

Field Value

Color

Remarks

猩红色 #E74C3C(http://www.color-hex.com/color/e74c3c)。

Teal

获取青绿色。

public static readonly Color Teal

Field Value

Color

Remarks

青绿色 #1ABC9C(http://www.color-hex.com/color/1abc9c)。

Properties

B

获取此颜色的蓝色通道的强度。

public byte B { get; }

Property Value

byte

G

获取此颜色的绿色通道的强度。

public byte G { get; }

Property Value

byte

R

获取此颜色的红色通道的强度。

public byte R { get; }

Property Value

byte

RawValue

获取此颜色的原始值。

public uint RawValue { get; }

Property Value

uint

Remarks

颜色以 24 位无符号整型值 RGB 格式进行编码,由高至低的每 8 位分别表示红色、绿色和蓝色通道的强度。

Methods

Equals(Color)

Indicates whether the current object is equal to another object of the same type.

public bool Equals(Color other)

Parameters

other Color

An object to compare with this object.

Returns

bool

true if the current object is equal to the other parameter; otherwise, false.

Equals(object?)

Indicates whether this instance and a specified object are equal.

public override bool Equals(object? obj)

Parameters

obj object

The object to compare with the current instance.

Returns

bool

true if obj and this instance are the same type and represent the same value; otherwise, false.

GetHashCode()

Returns the hash code for this instance.

public override int GetHashCode()

Returns

int

A 32-bit signed integer that is the hash code for this instance.

Parse(string)

将颜色的字符串表示形式转换为颜色对象。

public static Color Parse(string rawValue)

Parameters

rawValue string

要解析为颜色的字符串。

Returns

Color

颜色对象。

Exceptions

ArgumentOutOfRangeException

值必须是有效长度的数字。

ToString()

获取此颜色带有 # 前缀的 RGB 十六进制字符串表示形式(例如 #000CCC)。

public override string ToString()

Returns

string

此颜色带有 # 前缀的 RGB 十六进制字符串表示形式(例如 #000CCC)。

TryParse(string, out Color)

将颜色的字符串表示形式转换为颜色对象。

public static bool TryParse(string rawValue, out Color color)

Parameters

rawValue string

要解析为颜色的字符串。

color Color

如果转换成功,则为颜色对象;否则为默认颜色。

Returns

bool

如果转换成功,则为 true;否则为 false

Operators

operator ==(Color, Color)

判定两个 Color 是否相等。

public static bool operator ==(Color lhs, Color rhs)

Parameters

lhs Color
rhs Color

Returns

bool

如果两个 Color 相等,则为 true;否则为 false

explicit operator Color(Color)

将由 .NET 定义的 Color 颜色转换为由 Kook.Net 定义的 Color 颜色。

public static explicit operator Color(Color color)

Parameters

color Color

要进行转换的 .NET Color 颜色。

Returns

Color

与该 .NET Color 颜色具有相同色值的 Color 颜色。

implicit operator Color(Color)

将由 Kook.Net 定义的 Color 颜色转换为由 .NET 定义的 Color 颜色。

public static implicit operator Color(Color color)

Parameters

color Color

要进行转换的 Color 颜色。

Returns

Color

与该 Color 颜色具有相同色值的 .NET Color 颜色。

implicit operator uint(Color)

获取此颜色的原始值。

public static implicit operator uint(Color color)

Parameters

color Color

Returns

uint

Remarks

颜色以 24 位无符号整型值 RGB 格式进行编码,由高至低的每 8 位分别表示红色、绿色和蓝色通道的强度。

implicit operator Color(uint)

使用指定的 24 位无符号整型值初始化一个 Color 结构的新实例。

public static implicit operator Color(uint rawValue)

Parameters

rawValue uint

颜色的 24 位无符号整型原始值。

Returns

Color

Examples

创建 #607D8B(http://www.color-hex.com/color/607d8b)所表示的颜色:

Color darkGrey = 0x607D8B;

Exceptions

ArgumentException

颜色原始值超过了 MaxDecimalValue

operator !=(Color, Color)

判定两个 Color 是否不相等。

public static bool operator !=(Color lhs, Color rhs)

Parameters

lhs Color
rhs Color

Returns

bool

如果两个 Color 不相等,则为 true;否则为 false