# Gradient

Learn the parameters, syntax, and usage for the Gradient data visualization in ActiveReports.

## Content



The Gradient data visualization displays a gradient of color that transitions from one color to another.

When you select a Shape control on your report, in the Properties window, drop down the BackGroundImage - Value property and select \<Data Visualizer...> to launch the dialog. The same is true if you select an Image control and drop down the Value property. To build the data visualizer expression, select the appropriate values for each of the options in the dialog.

![Gradient Data Visualizer](https://cdn.mescius.io/document-site-files/images/b298aea2-8cb8-4a0f-be88-4f54aa263ebd/images/design-reports/datavisualier-gradient-dialog.png)

## Parameters

*   **Gradient type**. The available gradient types are Horizontal, Vertical, DiagonalUp, DiagonalDown, FromCenter, and FromCorner.
*   **Color1**. The start (primary) color of the gradient.
*   **Color2**. The end (secondary) color of the gradient.

## Syntax

```
=Gradient(Gradient type, Color1, Color2)
```

## Usage

Using Data Visualizers, the gradient can be applied in TextBox, Shape, CheckBox, and Container controls from **BackgroundImage - Value** property and in Image control from **Value** property. The following example shows how Gradient background style can be simply applied to a control.

**Example**

Set the following expression in the BackgroundImage.Value property of the Shape .

```plaintext
=Gradient("Vertical","LightCyan","BlueVoilet")
```

![Data Visualizers Dialog for Gradient type with Settings](https://cdn.mescius.io/document-site-files/images/b298aea2-8cb8-4a0f-be88-4f54aa263ebd/images/design-reports/gradient-shape.png)