Share via


ColorMap Class

Defines the ColorMap Class.When the object is serialized out as xml, its qualified name is a:clrMap.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlCompositeElement
      DocumentFormat.OpenXml.Drawing.ColorMappingType
        DocumentFormat.OpenXml.Drawing.ColorMap

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

Syntax

'Declaration
Public Class ColorMap _
    Inherits ColorMappingType
'Usage
Dim instance As ColorMap
public class ColorMap : ColorMappingType

Remarks

The following table lists the possible child types:

  • ExtensionList <a:extLst>

[ISO/IEC 29500-1 1st Edition]

20.1.6.1 clrMap (Color Map)

This element specifics the color mapping layer which allows a user to define colors for background and text. This allows for swapping out of light/dark colors for backgrounds and the text on top of the background in order to maintain readability of the text On a deeper level, this specifies exactly which colors the first 12 values refer to in the color scheme.

[Example: Consider the following example of a color map in use:

<clrMap bg1="lt1" tx1="dk1" bg2="lt2" tx2="dk2" accent1="accent1"
accent2="accent2" accent3="accent3" accent4="accent4" accent5="accent5"
accent6="accent6" hlink="hlink" folHlink="folHlink"/>

In this example, we see that bg1 is mapped to lt1, tx1 is mapped to dk1, and so on. end example]

Parent Elements

extraClrScheme (§20.1.6.4)

Child Elements

Subclause

extLst (Extension List)

§20.1.2.2.15

Attributes

Description

accent1 (Accent 1)

Specifies a color defined which is associated as the accent 1 color.

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

accent2 (Accent 2)

Specifies a color defined which is associated as the accent 2 color.

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

accent3 (Accent 3)

Specifies a color defined which is associated as the accent 3 color.

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

accent4 (Accent 4)

Specifies a color defined which is associated as the accent 4 color.

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

accent5 (Accent 5)

Specifies a color defined which is associated as the accent 5 color.

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

accent6 (Accent 6)

Specifies a color defined which is associated as the accent 6 color.

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

bg1 (Background 1)

A color defined which is associated as the first background color.

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

bg2 (Background 2)

Specifies a color defined which is associated as the second background color.

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

folHlink (Followed Hyperlink)

Specifies a color defined which is associated as the color for a followed hyperlink.

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

hlink (Hyperlink)

Specifies a color defined which is associated as the color for a hyperlink.

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

tx1 (Text 1)

Specifies a color defined which is associated as the first text color.

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

tx2 (Text 2)

Specifies a color defined which is associated as the second text color.

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

[Note: The W3C XML Schema definition of this element’s content model (CT_ColorMapping) 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

ColorMap Members

DocumentFormat.OpenXml.Drawing Namespace