ColorFormat Object
ColorFormat Object
This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.
![]() ![]() ![]() |
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