Table of Contents

Class VisualBuilder

Namespace
ReportWright.Design.Visuals
Assembly
ReportWright.Design.dll

Builds the data-visualisation items exactly as the engine draws them without a refusal diagnostic (proved by rendering each through the engine and the oracle): charts, sparklines, data bars, radial and linear gauges, indicators and barcodes. Every scale, tick-mark, label, cap and frame element the engine would otherwise name as left out is written.

public sealed class VisualBuilder
Inheritance
VisualBuilder
Inherited Members

Constructors

VisualBuilder(DesignerDocument)

Initializes a builder for a document.

Fields

ChartSubtypes

The subtypes the engine draws (Smooth on a line only).

ChartTypes

The series types the engine draws.

ErrorCorrections

The QR error-correction levels.

Palettes

The chart palettes the engine knows.

Symbologies

The barcode symbologies the engine encodes.

Methods

Aggregate(string?, string)

The aggregate expression a visual plots for a field: =Sum(Fields!X.Value), or a literal when there is no field.

Barcode(string, string, string, int, int)

A barcode custom report item the built-in drawer draws.

CategoryMember(string, string?)

A category member: a group on a field with a sort and a label, or one static member with an empty label.

Chart(string, string?, string, string, string?, IReadOnlyList<string>, string?, int, int)

A chart with its chrome: one category hierarchy (a group on a field, or one static category), one static series member and one series per field, both axes visible with value gridlines, a legend and a title.

DataBar(string, string?, string?, int, int)

A data bar: one horizontal bar for the value, both axes hidden, the value axis from zero, filling its box.

FieldValue(string)

The field expression =Fields!X.Value.

Indicator(string, string?, string?, IndicatorIconSet, int, int)

An indicator: one state per icon of the set over equal shares of the value's percentage of the dataset's total.

IndicatorStates(IndicatorIconSet)

The IndicatorStates of an icon set: equal shares of 0–100, lowest first.

LinearGauge(string, string?, string?, int, int)

A linear gauge: a horizontal scale with a bar pointer, major tick marks, labels and no frame.

Map(string, int, int)

A map to start from: a world in Mercator with the map's default grid of meridians and parallels, which both DocWright (1.4.0 and later) and Microsoft's engine draw before any layer is added.

RadialGauge(string, string?, string?, int, int)

A radial gauge: a 320° dial with a needle (its cap hidden), a green range over the top third, major tick marks, labels and no frame.

Series(string, string?, string, string)

A chart series plotting Sum of a field (or zero), with the given type and subtype.

Sparkline(string, string?, string?, string?, bool, int, int)

A sparkline: a line over a category group with both axes hidden, filling its box, no legend or title.