Skip to main content
Close announcements banner
PixelPerfect common properties

ON THIS PAGE

PixelPerfect common properties

This page describes the properties for the most commonly used PixelPerfect objects. Some properties are also available in the Formatting toolbar.

You can use this information to do the following:

  • Search for the property that you want to change under Property Name, and then check for the objects for which it is available.
  • Find which properties are customizable for each object.
  • Learn precisely what each specific property controls.

Appearance

Appearance properties
Property name Property explanation Label Table Table rows Table cells Charts
Appearance Name Specifies one of the available appearances, to be used to draw the chart's elements (Diagram, Axes, Legend, etc.). No No No No Yes
Background Color Specifies the background color for the control. Yes Yes Yes Yes Yes
Background Image Allows you to load a background image to a chart (or define its URL), and also define whether it should be stretched to fit the entire chart's area. No No No No Yes
Borders, Border Color, Dash Style and Border Width Specifies the border settings for the control. Yes Yes Yes Yes Yes
Fill Style Specifies the fill style of a chart's background (Empty, Solid, Gradient, or Hatch) and define other fill options as required. No No No No Yes
Font Specifies the font settings for the control. Yes Yes Yes Yes No
Foreground Color Specifies the text color for the control. Yes Yes Yes Yes No
Formatting Rules Invokes the Formatting Rules editor, allowing you to choose which rules should be applied to the control during report generation, and define the precedence of the applied rules. Yes Yes Yes Yes Yes
Image Type Specifies whether a chart should be internally rendered as a meta file in a report (the quality of the rendered image is always good, but in particular cases some details of the control may be lost), or as a bitmap (the quality of the rendered image is sometimes poor, but it allows a control to be drawn more precisely). No No No No Yes
Indicators Palette Name Specifies the palette that is used to paint all indicators that exist in a chart. No No No No Yes
Padding Specifies the indent values which are used to render the contents of a label. Yes Yes Yes Yes Yes
Palette Name Specifies one of the built-in palettes to be used to draw a chart's series. No No No No Yes
Palette's Base Color Number Specifies an integer index determining the base color for the palette defined by the chart's palette name property. No No No No Yes
Style Priority Specifies the priority of various style elements (such as Background color, Border color, etc.). Yes Yes Yes Yes Yes
Styles Specifies odd and even styles for the control, as well as assigns an existing style to the control (or a newly created one). Yes Yes Yes Yes No
Text Alignment Specifies the alignment of the control's text. Yes Yes Yes Yes No

Data

Data properties
Property name Property explanation Label Table Table rows Table cells Charts
(Data Bindings) If the current report is bound to data, this property allows you to bind some of the control properties (Bookmark, Navigation URL, Tag, and Text) to a data field obtained from the data source for a report, and to apply a format string to it. Yes Yes No Yes Yes
Data Member Specifies the data source member which supplies data to a chart. No No No No Yes
Data Source Specifies the data source for a chart. No No No No Yes
Lines Provides access to the text property of a label in the multiline mode. Yes No No Yes No
Series Data Member

Specifies the name of the data field whose values are used to generate and populate a series for a chart. The template settings for the created series are defined by the properties in the SeriesTemplate property of a chart. In particular, the Argument Data Member and Value Data Members properties specify the data fields from which the arguments and data values of the series data points are obtained.

Each series gets its name from the data field specified by the Series Data Member property. For example, this name is used to identify a series within the legend for a chart control. The names of all generated series can be supplemented with the same prefix and suffix defined by the settings which are available via the series name template property.

When chart binding is used to generate series within a chart control based upon the data obtained from the associated data source (defined by the data source property), a rule needs to be defined that helps the chart recognize the data records whose values are used to construct individual series objects. To do this, the Series Data Member property, which specifies the data field whose values are used when series objects are created and populated, can be used.

No No No No Yes
Series name template Specifies the settings used to name data bound series, defining the prefix and suffix texts for the names of series which are dynamically created as a result of binding a chart to data (using the Data Source, Series Data Member, Argument Data Member and Value Data Members properties). The names of series, to which these prefixes and suffixes are added, are taken by each series from the data field defined by the Series Data Member property. No No No No Yes
Series sorting Specifies the sort mode of a series for a chart (None by default, Descending or Ascending). No No No No Yes
Series template Allows you to customize a template for series which are created dynamically as a result of binding a chart to data (via the Data Source and Series Data Member properties). The settings, which are available via the series template property, are common to all such data bound series. These settings allow you to provide centralized customization of all dynamically created data bound series. No No No No Yes
Summary Allows you to perform calculations (Summary, Max, Min, Average, etc.) over a data field. Yes No No Yes No
Tag Allows you to add additional information to the control; for example its id, by which it can then be accessible via scripts. If the current report has a data source, the Tag property can be bound to a data field obtained from the data source. To do this, expand the (Data Bindings) property, and then select the required data field in the Tag.Binding drop-down list. Yes Yes Yes Yes Yes
Text Allows you to define a line of static text to be displayed. When a label is selected in the designer, you may simply start typing the text, and it will be automatically entered into the In-place editor. If the current report has a data source, the text property can be bound to a data field obtained from the data source. To do this, expand the (Data Bindings) property and in the Text.Binding drop-down list, and then select the required data field. Yes No No Yes No
Xlsx Format String Specifies the native XLSX format string for the content of a control, which is preserved when the report is being exported to XLSX. This format string is independent from the general value formatting. Yes No No Yes No

Design

Design properties
Property name Property explanation Label Table Table rows Table cells Charts
(Name) Specifies the name for a control, by which it can be accessed in the Report Explorer, Property Grid, or via scripts. Yes Yes Yes Yes Yes

Layout

Layout properties
Property name Property explanation Label Table Table rows Table cells Charts
Height Specifies the height of a row, in report measurement units. No No Yes No No
Location Specifies the location of a control, in report measurement units. Yes Yes No No Yes
Size Specifies the size of a control, in report measurement units. Yes Yes No No Yes
Snap Line Margin Specifies the margin (in report measurement units) that is preserved around the control when it is aligned using Snap Lines, or when other controls are aligned next to it. Yes Yes Yes Yes Yes
Width Specifies the width of a cell, in report measurement units. No No No Yes No

Elements

Elements properties
Property name Property explanation Label Table Table rows Table cells Charts
Annotation repository Provides centralized access to all annotations that are present in the chart. No No No No Yes
Annotations Provides access to the annotations collection of the chart. No No No No Yes
Diagram Allows you to customize the diagram elements for the main and secondary axes and panes. By default, a chart is displayed in the Default Pane, but if necessary, you can display the series for each chart in a separate pane. To do this, click the Pane's ellipsis button to invoke the Pane Collection editor, allowing you to manage and customize panes. Then, select the required series within the chart and set its View.Pane property to the required pane. No No No No Yes
Legend Allows you to customize the legend for a chart by defining such properties as Text alignment and Antialiasing, Font style, Background color or Image, Border options, Markers' size and Visibility, Shadow options, and so on. No No No No Yes
Series Invokes the Series Collection editor, which allows you to manage and customize the series for a chart. Note that series which are bound to data at the level of a chart control (in particular, using the Data Source, Series Data Member, and both the Argument Data Member and Value Data Members properties), are created dynamically, based upon the data obtained from the specified data source, and they are not presented within the Series collection. To perform a centralized customization of such a series, use the settings which are available via the Series Template property. No No No No Yes
Titles Invokes the Chart Title Collection editor, which allows you to manage and customize the titles for a chart. No No No No Yes

Navigation

Navigation properties
Property name Property explanation Label Table Table rows Table cells Charts
Bookmark and Parent bookmark Allows you to create a hierarchical structure within a report called a document map. If the current report has a data source, the Bookmark property can be bound to a data field, obtained from the data source. To do this, expand the (Data Bindings) property, and then select the required data field in the Bookmark.Binding drop-down list. Yes Yes No Yes Yes
Navigation URL and Navigation Target

Navigation URL allows you to specify a URL for web browser navigation when a user clicks a label. The web browser displays a page in a window or a frame as specified by the Navigation Target property. A URL should have an appropriate prefix (e.g. "http://").

You can create cross-references within the report by assigning the name of the target control to the Navigation URL property, and setting the Navigation Target property to _self. If the current report has a data source, the Navigation URL property can be bound to a data field obtained from the data source. To do this, expand the (Data Bindings) property, and then select the required data field in the Navigation URL.Binding drop-down list.

Yes No No Yes Yes