Gradient Brush - Spread Property

Defines brush behavior outside the bounds of the specified color range

Member of Gradient Brush (PRIM_VS.GradientBrush)

Data Type - Enumeration


The Spread property defines the appearance of the brush beyond the extent of the brush colors or the logical start and end of the specific brush.
If the BrushColors are defined to occupy the whole of the gradient, Spread will have no effect.
If the At property for the first color is greater than 0 or the last color is less than 100, the gradient will not occupy the whole of the control.

Allowed Values

Enum ValueDescription
PadAny space before the start or end of the brush colors will be filled with the colors specified as the first and last colors respectively.
ReflectAny space before the start or end of the brush will be filled with a reflection of the brush
RepeatAny space before the start or end of the brush will be filled with a repeat of the brush


In this example, the transition from red to blue starts at 30% and finishes at 70%. Outside of the range that space is padded with the two colors.
Begin_Com Role(*EXTENDS #PRIM_WEB) Height(457) Width(1169) Style(#Style1)
   Define_Com Class(#PRIM_VS.Style) Name(#Style1) Backgroundbrush(#LinearBrush2)
   Define_Com Class(#PRIM_VS.LinearBrush) Name(#LinearBrush2) Colors(#BrushColors1) Endtop(0) Endleft(100)
   Define_Com Class(#PRIM_VS.BrushColors) Name(#BrushColors1)
   Define_Com Class(#PRIM_VS.BrushColor) Name(#BrushColor1) Color(255:0:0) Parent(#BrushColors1) At(30)
   Define_Com Class(#PRIM_VS.BrushColor) Name(#BrushColor2) At(70) Color(0:0:255) Parent(#BrushColors1)

See also

All Component Classes

Technical Reference

Febuary 18 V14SP2