LinearGradientFill class

Office 2013 and later

Linear Gradient Fill. When the object is serialized out as xml, its qualified name is a:lin.

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

public class LinearGradientFill : OpenXmlLeafElement

[ISO/IEC 29500-1 1st Edition]

lin (Linear Gradient Fill)

This element specifies a linear gradient.

Parent Elements

gradFill (§20.1.8.33)

Attributes

Description

ang (Angle)

Specifies the direction of color change for the gradient. To define this angle, let its value be x measured clockwise. Then ( -sin x, cos x ) is a vector parallel to the line of constant color in the gradient fill.

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

scaled (Scaled)

Whether the gradient angle scales with the fill region. Mathematically, if this flag is true, then the gradient vector ( cos x , sin x ) is scaled by the width (w) and height (h) of the fill region, so that the vector becomes ( w cos x, h sin x ) (before normalization). Observe that now if the gradient angle is 45 degrees, the gradient vector is ( w, h ), which goes from top-left to bottom-right of the fill region. If this flag is false, the gradient angle is independent of the fill region and is not scaled using the manipulation described above. So a 45-degree gradient angle always give a gradient band whose line of constant color is parallel to the vector (1, -1).

The possible values for this attribute are defined by the W3C XML Schema boolean datatype.

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

© ISO/IEC29500: 2008.

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