Help & Support
Contents
Display Legacy Contents

Search:

Home > Report Designer > Getting Started > Report Controls

Report Controls

Home > Report Designer > Getting Started > Report Controls

Report Controls

This document introduces report controls used to display various information in a report. All these controls can be added to a report in the report designer, as well as programmatically added to a runtime created report. In this topic you can find the list of controls available in XtraReports, along with some basic recommendations on their use.


Report Designer


What is a Report Control?

A Report Control represents a specific report element (e.g. static or bound text, line, picture, check box, etc.) that can be inserted into a report. Report controls can reside either inside Report Bands or inside other report controls that may serve as control containers (e.g. a panel).

The appearance and behavior of a report control is defined by its type. 

Control Types

The following table lists the available controls . For each control's options description, refer to the corresponding document.


Label 

The most basic Label control is intended to display text in your report. It can represent static or dynamic text, or both. In addition, it can be used to calculate standard summary functions across a data field. The Label's text can only be formatted as a whole. So, if it's required to differently format parts of text, use the Rich Text  control.


Check Box 

The Check Box control is intended to display True/False or Checked/Unchecked/Indeterminate states in a report, by displaying (or not) a check mark, which can be accompanied by a text description.

      Rich Text 

The Rich Text control allows you to display formatted text in your report. It can represent static or dynamic text, or both. You can load content to the Rich Text from an external TXT or RTF file (which can also contain images) and then format any part of it. The formatting options include font face, styles and sizes, and color.


Picture Box

The Picture Box control is intended to display images of numerous formats in a report. An image can be loaded from an external file, from a field, or from a web location using the specified URL.


Panel

The Panel control is a container that frames separate report controls to allow them to be easily moved, copied and pasted, and visually unite them in the report's preview (with borders or a uniform color background).


Table

The Table control is designed to arrange information in a tabular layout It may contain any number of rows comprised of individual cells. Both Rows and Cells can be selected and customized individually. In most aspects, a Cell is similar to a Label , but can also contain other controls (e.g.Picture Box or Rich Text ).


Line

The Line control draws a line of a specified direction, style, width and color. It can be used for both decoration and visual separation of a report's sections. The Line cannot cross bands, as opposed to the Cross-band Line control.


Shape

The Shape control allows you to embed simple graphic objects into your report. You can choose one of multiple predefined shapes (e.g. rectangles, ellipses, arrows, polygons, crosses and brackets of various kinds).


Bar Code

The Bar Code control transforms its content into a bar code of the specified type. Multiple standard bar code symbologies are supported.


Zip Code

The Zip Code control transforms its content into a zip code. The width of a zip code's segment is adjustable.


Chart

The Chart is a sophisticated control used to embed graphs into your report. It graphically represents a series of points using numerous 2D or 3D chart types. A Chart can be populated with points both manually (by specifying arguments and values for each point) and dynamically (by connecting it to the report's data source, or binding it to a separate one).


Pivot Grid

The Pivot Grid control represents dynamic data (obtained from an underlying data source) in a cross-tabulated form to create cross-tab reports , similar to Pivot Tables in Microsoft Excel®. Column headers display unique values from one data field, and row headers - from another field. Each cell displays a summary for the corresponding row and column values. By specifying different data fields, you can see different totals. This allows you to get a compact layout for a complex data analysis.


Page Info

The Page Info control is intended to add page numbers and system information (the current date and time or the current user name) into your report. As with many other controls, you can format this control's content.


Page Break

The Page Break control's sole purpose is to insert a page delimiter at any point within a report.


Cross-band Line

The Cross-band Line control allows you to draw a line through several bands. This can be useful if it is required to visually emphasize a section consisting of multiple band areas. In other aspects, it is similar to a regular line.


Cross-band Box

The Cross-band Box control allows you to draw a rectangle through several bands. This can be useful if it is required to visually encompass a section consisting of multiple band areas.


Subreport          

The Subreport control allows you to include other reports in your current report.




See also



Properties
Article ID:
report_controls1
Views: 161
Created By: jimdurkin
Modified By: [Modified By]
Created Date: 3/24/2014 12:31 PM
Last Modified: 3/24/2014 12:31 PM
Actions
Print This Article
Bookmark
Email This Article
Previous Article
Next Article