ActiveReports 19 .NET Edition
Report Authors / Report Controls / Report Controls in Page/RDLX Report / Shape
Shape

The Shape report control is used to display one of the available shape types on a report. You can add a shape report control to a report by dragging it from the toolbox and dropping it onto the report design surface. 

In the ShapeStyle property of the Shape report control, you can select Rectangle, RoundRect or Ellipse, or you can use an expression to assign fields, datasets, parameters, constants, operations or common values to it. 

You can highlight different sections or parts of a report using a shape report control. For example, you can use a Rectangle as border around different report controls or the entire page or you can use an Ellipse to highlight a note on your report.

Important Properties

By clicking on the Shape control, you can set its properties in the Properties window.

Property Description
AccessibleDescription Enter the alternative description of the control for use by accessibility client application. The property on exporting the report adds the ‘alternative text’ in PDF and ‘alt’ attribute in HTML.
BackgroundColor Choose a color for the background from the Color Picker.
BackgroundImage Add a background image from External, Embedded, or Database as Source. You can also select the MIME type of the image.
BorderColor Choose a color for the border from the Color Picker.
BorderStyle Select a style for the border.
BorderWidth Enter a value to set the width of the border.
RoundingRadius Enter a value in points to round the corner of the outer border edge of the RoundRect shape style.
ShapeStyle Choose a shape style from Rectangle, RoundRect, or Ellipse.
Size Enter the Width and Height of the shape.

Shape Dialog Properties

You can set the Shape properties in the Shape dialog. To open it, with the Shape selected on the report, under the Properties window, click the Property dialog link.

Name: Enter a name for the image that is unique within the report. This name can be called in code. You can only use underscore (_) as a special character in the Name field. Other special characters such as period (.), space ( ), forward slash (/), backslash (\), exclamation (!), and hyphen (-) are not supported.

Shape Style: Choose Rectangle, RoundRect or Ellipse from the dropdown list, or select the <Expression...> option to open the Expression Editor.

Rectangle RoundRect Ellipse
Rectangle Shape style Rounded Rectangle Shape style Ellipse Shape style

Rounded Rectangle: When the Shape type is set to RoundRect, you can specify the radius for each corner of the shape independently. Drag the handlers Handleravailable at each corner of the shape to set the value of the radius at each corner.

Note: To enable specific corners, select the checkbox available near each corner of the Shape control.
See Also