VML Colors Attribute

This topic describes VML, a feature that is deprecated as of Windows Internet Explorer 9. Webpages and applications that rely on VML should be migrated to SVG or other widely supported standards.


As of December 2011, this topic has been archived. As a result, it is no longer actively maintained. For more information, see Archived Content. For information, recommendations, and guidance regarding the current version of Windows Internet Explorer, see Internet Explorer Developer Center.


Defines multiple colors for a gradient fill. Read/write. IVgGradientColorArray.

Applies To


Tag Syntax

<v: element colors=" expression ">

Script Syntax

element .colors="expression"



Used to define an array consisting of paired values of percentages (VgFraction) and color (VgColor). The array creates a blended fill using each point in the array, starting at 0% (defined by Color) and ending at 100% (defined by Color2). Intermediate colors along the way can be defined by assigning a color value to a percentage. The percent and color pair are not separated by a comma, but pairs are separated from each other by commas.

VML Standard Attribute


The shape has a gradient fill consisting of four colors, starting with red, blending to yellow, then green, and finallyblue.

   <v:shape id="rect01"
   coordorigin="0 0" coordsize="200 200"
   path="m 1,1 l 1,200, 200,200, 200,1 x e">
   <v:fill type="gradient" color="red" color2="blue"
   colors="30% yellow,70% green"/>