Table of contents
Collapse the table of content
Expand the table of content

FillFormat.GradientVariant Property (PowerPoint)

office 365 dev account|Last Updated: 6/12/2017
1 Contributor

Returns the gradient variant for the specified fill as an integer value from 1 to 4 for most gradient fills. Read-only.


expression. GradientVariant

expression A variable that represents a FillFormat object.

Return Value



If the gradient style is msoGradientFromTitle or msoGradientFromCenter, this property returns either 1 or 2.

The values for this property correspond to the gradient variants (numbered from left to right and from top to bottom) on the Gradient subtab in the Shape Fill tab. Long.

This property is read-only. Use the OneColorGradient, PresetGradient, or TwoColorGradient method to set the gradient variant for the fill.


This example adds a rectangle to myDocument and sets its fill gradient variant to match that of the shape named "rect1." For the example to work, rect1 must have a gradient fill.

Set myDocument = ActivePresentation.Slides(1)

With myDocument.Shapes

    gradVar1 = .Item("rect1").Fill.GradientVariant

    With .AddShape(msoShapeRectangle, 0, 0, 40, 80).Fill

        .ForeColor.RGB = RGB(128, 0, 0)

        .OneColorGradient msoGradientHorizontal, gradVar1, 1

    End With

End With

See also


FillFormat Object

© 2018 Microsoft