• Login

DataSoft Corporation

Appearance Properties

This document describes the purpose and implementation of the appearance properties - a special set of properties that allow you to customize the appearance of a report or any of its elements.

Properties Overview

Every report element (control or band), and a report itself has a set of properties that specify its appearance. They are listed in the following table.

Property NameDescription
Background Color Gets or sets a background color to a report element and its child controls.
Border Color Gets or sets a border color to a report element and its child controls.
Border Dash Style Gets or sets a border dash style to a report element and its child controls.
Borders Gets or sets borders (top, right, bottom, left), which should be visible for a report element and its child controls.
Border Width Gets or sets a border width to a report element and its child controls.
Font Gets or sets the font options (its name, size, etc.) to a report element and its child controls.
Foreground Color Gets or sets the foreground color to a report element and its child controls.
Padding Gets or sets the indent values which are used to render the contents of a report element and its child controls.
Text Alignment Gets or sets the text alignment to a report element and its child controls.

Access Appearance Properties

Use the Report Designer's Toolbar to access the appearance properties.

eurd-win-appearance-properties-on-toolbar

More appearance properties are available in the Property Grid's Appearance tab.

eurd-win-appearance-properties-in-property-grid

Property Value Inheritance

By default, appearance properties for every control or a band are set to empty values, which means that their real values are obtained from a control's parent, or a parent of its parent and so on.

AppearanceProperties_0

NOTE

The appearance properties may not be used by all descendants of the current report element for which they are defined. For example, the Page Break element ignores the Back Color property.

To reset values of these properties, click the property marker in the Property Grid, and select Reset in the invoked menu. Then, the control's actual appearance will be determined by the appropriate properties settings of its parent.

AppearanceProperties_1

If a report element has a style assigned to it, the priority of the properties defined by this style is determined by the StylePriority property. Note that when conditional formatting is involved, the appearance it defines is of greater priority than the properties described above.

Sunday, 13 January 2019 Posted in Customize Appearance