ColorFormat Object

Multiple objects ColorFormat ColorCMYK

Represents the color of a one-color object or the foreground or background color of an object with a gradient or patterned fill. You can set colors to an explicit red-green-blue value by using the RGB property.

Using the ColorFormat object

Use one of the properties listed in the following table to return a ColorFormat object.

Use this property	With this object	To return a ColorFormat object that represents this
BackColor	FillFormat	Background fill color (used in a shaded or patterned fill)
ForeColor	FillFormat	Foreground fill color (or simply the fill color for a solid fill)
BackColor	LineFormat	Background line color (used in a patterned line)
ForeColor	LineFormat	Foreground line color (or just the line color for a solid line)
ForeColor	ShadowFormat	Shadow color
ExtrusionColor	ThreeDFormat	Color of the sides of an extruded object

Use the RGB property to set a color to an explicit red-green-blue value. The following example adds a rectangle to the active publication and then sets the foreground color, background color, and gradient for the rectangle's fill.

Sub GradientFill()
    With ActiveDocument.Pages(1).Shapes _
            .AddShape(Type:=msoShapeRectangle, _
            Left:=90, Top:=90, Width:=90, Height:=50).Fill
        .ForeColor.RGB = RGB(128, 0, 0)
        .BackColor.RGB = RGB(170, 170, 170)
        .TwoColorGradient msoGradientHorizontal, 1
    End With
End Sub