Properties of PixelPerfect Labels, Table and Charts

    Description: This document shows the properties for the most commonly used PixelPerfect objects. You’ll find a detailed description of each property and a “Yes” indicates that the property is available for the object specified in the column heading. Some properties are also available in the Formatting Toolbar. You can use this article to do the following:

    • search for the property you want to change under “Property Name” and check in which objects it’s available for
    • find which properties are customizable for each object
    • learn precisely what each specific property controls

    Appearance

     

    Property NameProperty ExplanationLabelTableTable RowsTable CellsCharts
    Appearance NameAllows you to choose one of the available appearances, to be used to draw the Chart's elements (Diagram, Axes, Legend, etc.).Yes
    Background ColorSpecifies the background color for the control.YesYesYesYesYes
    Background ImageAllows 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, or not.Yes
    Borders, Border Color and Border WidthSpecify border settings for the control.YesYesYesYesYes
    Fill StyleDetermines the fill style of a Chart's background (Empty, Solid, Gradient or Hatch) and define other fill options if required.Yes
    FontSpecifies the font settings for the control.YesYesYesYes
    Foreground ColorSpecifies the text color for the control.YesYesYesYesYes
    Formatting RulesInvokes 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.YesYesYesYesYes
    Image TypeDetermines whether a Chart should be internally rendered as a metafile in a report (in this case 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 (in this case the quality of the rendered image is sometimes poor, but it allows a control to be drawn more precisely).Yes
    Indicators Palette NameSpecifies the palette that is used to paint all indicators that exist in a Chart.Yes
    PaddingSpecifies indent values which are used to render the contents of a Label.YesYesYesYesYes
    Palette NameAllows you to choose one from the built-in palettes to be used to draw a Chart's series.Yes
    Palette's Base Color NumberAllows you to define an integer index determining the base color for the palette defined by the Chart's Palette Name property.Yes
    Style PrioritySpecifies the priority of various style elements (such as background color, border color, etc.).YesYesYesYesYes
    StylesSpecifies odd and even styles for the control, as well as to assign an existing style to the control (or a newly created one).YesYesYesYes
    Text AlignmentSpecifies the alignment of the control's text.YesYesYesYes

     

    Data

     

    Property NameProperty ExplanationLabelTableTable RowsTable CellsCharts
    (Data Bindings)If the current report is bound to data, this property allows you to bind some of the control's properties (Bookmark, Navigation URL, Tag and Text) to a data field obtained from the report's data source, and to apply a format string to it.YesYesYes
    Data AdapterDetermines a data adapter that will populate a Chart's data source which is assigned via the Data Source property. It is automatically set to the appropriate value, when the Data Member property is defined.Yes
    Data MemberDetermines the data source member which supplies data to a Chart.Yes
    Data SourceDetermines a Chart's data source.Yes
    LinesProvides access to the Text property of a Label in the Multiline mode.YesYes
    Series Data MemberDetermines the name of the data field whose values are used to automatically generate and populate a Chart's series. The template settings for the dynamically created series are defined by the specific properties which are available via 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 automatically generated 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 chart control's legend. The names of all automatically generated series can be supplemented with the same prefix and postfix defined by the settings which are available via the Series Name Template property. When Chart binding is used to automatically 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 taken into account when series objects are automatically created and populated, can be used.Yes
    Series Name TemplateDetermines the settings used to name data bound series defining the prefix and postfix 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 series names, to which these prefixes and postfixes are added, are taken by each series from the data field defined by the Series Data Member property.Yes
    Series SortingAllows you to define the sort mode of a Chart's series (None by default, Descending or Ascending).Yes
    Series TemplateAllows 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.Yes
    SummaryAllows you to perform calculations (summary, max, min, average, etc.) over a data field.YesYes
    TagThis property allows you to add some 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 in the Tag.Binding drop-down selector, select the required data field.YesYesYesYesYes
    TextAllows 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 selector, select the required data field.YesYes
    Xlsx Format StringSpecifies the native XLSX format string for the control's content, which is to be preserved when the report is being exported to XLSX. This format string is independent from the general value formatting.YesYes

     

    Design

     

    Property NameProperty ExplanationLabelTableTable RowsTable CellsCharts
    (Name)Determines a control's name, by which it can be accessed in the Report Explorer, Property Grid or via scripts.YesYesYesYesYes

     

    Layout

     

    Property NameProperty ExplanationLabelTableTable RowsTable CellsCharts
    HeightSpecifies the Row's height, in report measurement units.Yes
    LocationSpecifies the control's location, in report measurement units.YesYesYes
    SizeSpecifies the control's size, in report measurement units.YesYesYes
    Snap Line MarginSpecifies the margin (in report measurement units), which is to be preserved around the control when it is aligned using Snap Lines, or when other controls are aligned next to it.YesYesYesYesYes
    WidthSpecifies the Cell's width, in report measurement units.Yes

     

    Elements

     

    Property NameProperty ExplanationLabelTableTable RowsTable CellsCharts
    Annotation RepositoryProvides centralized access to all annotations that are present in the Chart.Yes
    AnnotationsProvides access to the annotations collection of the Chart.Yes
    DiagramAllows you to customize a Chart's diagram elements: main and secondary axes and panes. By default, a Chart is displayed in the Default Pane, but if necessary, you can display each Chart's series 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.Yes
    LegendAllows you to customize a Chart's legend, by defining such properties as text alignment and antialiasing, font style, background color or image, border options, markers' size and visibility, shadow options, etc.Yes
    SeriesInvokes the Series Collection Editor, which allows you to manage and customize a Chart's series. 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 series, use the settings which are available via the Series Template property.Yes
    TitlesInvokes the Chart Title Collection Editor, which allows you to manage and customize a Chart's titles.Yes

     

    Navigation

     

    Property NameProperty ExplanationLabelTableTable RowsTable CellsCharts
    Bookmark and Parent BookmarkThese properties are intended for the creation of 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 in the Bookmark.Binding drop-down selector, select the required data field.YesYesYesYes
    Navigation URL and Navigation TargetUse the Navigation URL property 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. Note that 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". For more information, refer to Create Hyperlinks. 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 in the Navigation URL.Binding drop-down selector, select the required data field.YesYesYes