Edit

FillFormat.GradientVariant property (Word)

  • Article

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

Syntax

expression.GradientVariant

expression A variable that represents a FillFormat object.

Remarks

If the gradient style is 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 tab in the Fill Effects dialog box.

Use the OneColorGradient or TwoColorGradient method to set the gradient variant for the fill.

Example

This example adds a rectangle to the active document 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.

Dim lngGradient As Long 
 
With ActiveDocument.Shapes 
 lngGradient = .Item("rect1").Fill.GradientVariant 
 With .AddShape(msoShapeRectangle, 0, 0, 40, 80).Fill 
 .ForeColor.RGB = RGB(128, 0, 0) 
 .OneColorGradient msoGradientHorizontal, _ 
 lngGradient, 1 
 End With 
End With

See also

FillFormat Object

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.