共用方式為


HslColor Class

Hue, Saturation, Luminance Color Model.When the object is serialized out as xml, its qualified name is a:hslClr.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlCompositeElement
      DocumentFormat.OpenXml.Drawing.HslColor

Namespace:  DocumentFormat.OpenXml.Drawing
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

Syntax

'Declaration
<ChildElementInfoAttribute(GetType(Tint))> _
<ChildElementInfoAttribute(GetType(Shade))> _
<ChildElementInfoAttribute(GetType(Complement))> _
<ChildElementInfoAttribute(GetType(Inverse))> _
<ChildElementInfoAttribute(GetType(Gray))> _
<ChildElementInfoAttribute(GetType(Alpha))> _
<ChildElementInfoAttribute(GetType(AlphaOffset))> _
<ChildElementInfoAttribute(GetType(AlphaModulation))> _
<ChildElementInfoAttribute(GetType(Hue))> _
<ChildElementInfoAttribute(GetType(HueOffset))> _
<ChildElementInfoAttribute(GetType(HueModulation))> _
<ChildElementInfoAttribute(GetType(Saturation))> _
<ChildElementInfoAttribute(GetType(SaturationOffset))> _
<ChildElementInfoAttribute(GetType(SaturationModulation))> _
<ChildElementInfoAttribute(GetType(Luminance))> _
<ChildElementInfoAttribute(GetType(LuminanceOffset))> _
<ChildElementInfoAttribute(GetType(LuminanceModulation))> _
<ChildElementInfoAttribute(GetType(Red))> _
<ChildElementInfoAttribute(GetType(RedOffset))> _
<ChildElementInfoAttribute(GetType(RedModulation))> _
<ChildElementInfoAttribute(GetType(Green))> _
<ChildElementInfoAttribute(GetType(GreenOffset))> _
<ChildElementInfoAttribute(GetType(GreenModulation))> _
<ChildElementInfoAttribute(GetType(Blue))> _
<ChildElementInfoAttribute(GetType(BlueOffset))> _
<ChildElementInfoAttribute(GetType(BlueModulation))> _
<ChildElementInfoAttribute(GetType(Gamma))> _
<ChildElementInfoAttribute(GetType(InverseGamma))> _
Public Class HslColor _
    Inherits OpenXmlCompositeElement
'Usage
Dim instance As HslColor
[ChildElementInfoAttribute(typeof(Tint))]
[ChildElementInfoAttribute(typeof(Shade))]
[ChildElementInfoAttribute(typeof(Complement))]
[ChildElementInfoAttribute(typeof(Inverse))]
[ChildElementInfoAttribute(typeof(Gray))]
[ChildElementInfoAttribute(typeof(Alpha))]
[ChildElementInfoAttribute(typeof(AlphaOffset))]
[ChildElementInfoAttribute(typeof(AlphaModulation))]
[ChildElementInfoAttribute(typeof(Hue))]
[ChildElementInfoAttribute(typeof(HueOffset))]
[ChildElementInfoAttribute(typeof(HueModulation))]
[ChildElementInfoAttribute(typeof(Saturation))]
[ChildElementInfoAttribute(typeof(SaturationOffset))]
[ChildElementInfoAttribute(typeof(SaturationModulation))]
[ChildElementInfoAttribute(typeof(Luminance))]
[ChildElementInfoAttribute(typeof(LuminanceOffset))]
[ChildElementInfoAttribute(typeof(LuminanceModulation))]
[ChildElementInfoAttribute(typeof(Red))]
[ChildElementInfoAttribute(typeof(RedOffset))]
[ChildElementInfoAttribute(typeof(RedModulation))]
[ChildElementInfoAttribute(typeof(Green))]
[ChildElementInfoAttribute(typeof(GreenOffset))]
[ChildElementInfoAttribute(typeof(GreenModulation))]
[ChildElementInfoAttribute(typeof(Blue))]
[ChildElementInfoAttribute(typeof(BlueOffset))]
[ChildElementInfoAttribute(typeof(BlueModulation))]
[ChildElementInfoAttribute(typeof(Gamma))]
[ChildElementInfoAttribute(typeof(InverseGamma))]
public class HslColor : OpenXmlCompositeElement

Remarks

The following table lists the possible child types:

  • Tint <a:tint>

  • Shade <a:shade>

  • Complement <a:comp>

  • Inverse <a:inv>

  • Gray <a:gray>

  • Alpha <a:alpha>

  • AlphaOffset <a:alphaOff>

  • AlphaModulation <a:alphaMod>

  • Hue <a:hue>

  • HueOffset <a:hueOff>

  • HueModulation <a:hueMod>

  • Saturation <a:sat>

  • SaturationOffset <a:satOff>

  • SaturationModulation <a:satMod>

  • Luminance <a:lum>

  • LuminanceOffset <a:lumOff>

  • LuminanceModulation <a:lumMod>

  • Red <a:red>

  • RedOffset <a:redOff>

  • RedModulation <a:redMod>

  • Green <a:green>

  • GreenOffset <a:greenOff>

  • GreenModulation <a:greenMod>

  • Blue <a:blue>

  • BlueOffset <a:blueOff>

  • BlueModulation <a:blueMod>

  • Gamma <a:gamma>

  • InverseGamma <a:invGamma>

[ISO/IEC 29500-1 1st Edition]

20.1.2.3.13 hslClr (Hue, Saturation, Luminance Color Model)

This element specifies a color using the HSL color model. A perceptual gamma of 2.2 is assumed.

Hue refers to the dominant wavelength of color, saturation refers to the purity of its hue, and luminance refers to its lightness or darkness.

As with all colors, colors defined with the HSL color model can have color transforms applied to it.

[Example:

The color blue having RGB value RRGGBB = (00, 00, 80) is equivalent to

<a:solidFill>
  <a:hslClr hue="14400000" sat="100.000%" lum="50.000%">
</a:solidFill>

end example]

Parent Elements

accent1 (§20.1.4.1.1); accent2 (§20.1.4.1.2); accent3 (§20.1.4.1.3); accent4 (§20.1.4.1.4); accent5 (§20.1.4.1.5); accent6 (§20.1.4.1.6); alphaInv (§20.1.8.4); bgClr (§20.1.8.10); bgRef (§19.3.1.3); buClr (§21.1.2.4.4); clrFrom (§20.1.8.17); clrMru (§19.2.1.4); clrRepl (§20.1.8.18); clrTo (§20.1.8.19); clrVal (§19.5.27); contourClr (§20.1.5.6); custClr (§20.1.4.1.8); dk1 (§20.1.4.1.9); dk2 (§20.1.4.1.10); duotone (§20.1.8.23); effectClrLst (§21.4.4.7); effectRef (§20.1.4.2.8); extrusionClr (§20.1.5.7); fgClr (§20.1.8.27); fillClrLst (§21.4.4.8); fillRef (§20.1.4.2.10); folHlink (§20.1.4.1.15); fontRef (§20.1.4.1.17); from (§19.5.43); glow (§20.1.8.32); gs (§20.1.8.36); highlight (§21.1.2.3.4); hlink (§20.1.4.1.19); innerShdw (§20.1.8.40); linClrLst (§21.4.4.9); lnRef (§20.1.4.2.19); lt1 (§20.1.4.1.22); lt2 (§20.1.4.1.23); outerShdw (§20.1.8.45); penClr (§19.2.1.23); prstShdw (§20.1.8.49); solidFill (§20.1.8.54); tcTxStyle (§20.1.4.2.30); to (§19.5.90); txEffectClrLst (§21.4.4.12); txFillClrLst (§21.4.4.13); txLinClrLst (§21.4.4.14)

Child Elements

Subclause

alpha (Alpha)

§20.1.2.3.1

alphaMod (Alpha Modulation)

§20.1.2.3.2

alphaOff (Alpha Offset)

§20.1.2.3.3

blue (Blue)

§20.1.2.3.4

blueMod (Blue Modification)

§20.1.2.3.5

blueOff (Blue Offset)

§20.1.2.3.6

comp (Complement)

§20.1.2.3.7

gamma (Gamma)

§20.1.2.3.8

gray (Gray)

§20.1.2.3.9

green (Green)

§20.1.2.3.10

greenMod (Green Modification)

§20.1.2.3.11

greenOff (Green Offset)

§20.1.2.3.12

hue (Hue)

§20.1.2.3.14

hueMod (Hue Modulate)

§20.1.2.3.15

hueOff (Hue Offset)

§20.1.2.3.16

inv (Inverse)

§20.1.2.3.17

invGamma (Inverse Gamma)

§20.1.2.3.18

lum (Luminance)

§20.1.2.3.19

lumMod (Luminance Modulation)

§20.1.2.3.20

lumOff (Luminance Offset)

§20.1.2.3.21

red (Red)

§20.1.2.3.23

redMod (Red Modulation)

§20.1.2.3.24

redOff (Red Offset)

§20.1.2.3.25

sat (Saturation)

§20.1.2.3.26

satMod (Saturation Modulation)

§20.1.2.3.27

satOff (Saturation Offset)

§20.1.2.3.28

shade (Shade)

§20.1.2.3.31

tint (Tint)

§20.1.2.3.34

Attributes

Description

hue (Hue)

Specifies the angular value describing the wavelength. Expressed in 1/6000ths of a degree.

The possible values for this attribute are defined by the ST_PositiveFixedAngle simple type (§20.1.10.44).

lum (Luminance)

Specifies the luminance referring to the lightness or darkness of the color. Expressed as a percentage with 0% referring to maximal dark (black) and 100% referring to maximal white.

The possible values for this attribute are defined by the ST_Percentage simple type (§20.1.10.40).

sat (Saturation)

Specifies the saturation referring to the purity of the hue. Expressed as a percentage with 0% referring to grey, 100% referring to the purest form of the hue.

The possible values for this attribute are defined by the ST_Percentage simple type (§20.1.10.40).

[Note: The W3C XML Schema definition of this element’s content model (CT_HslColor) is located in §A.4.1. end note]

© ISO/IEC29500: 2008.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

HslColor Members

DocumentFormat.OpenXml.Drawing Namespace