LinearGradientFill Class

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

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlLeafElement
      DocumentFormat.OpenXml.Drawing.LinearGradientFill

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

Syntax

'Declaration
Public Class LinearGradientFill _
    Inherits OpenXmlLeafElement
'Usage
Dim instance As LinearGradientFill
public class LinearGradientFill : OpenXmlLeafElement

Remarks

[ISO/IEC 29500-1 1st Edition]

20.1.8.41 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.

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

LinearGradientFill Members

DocumentFormat.OpenXml.Drawing Namespace