Gauge

The Gauge control provides you with the capability to embed graphical gauges into your report.

The Gauge control

In the Property Grid, the Gauge control's properties are divided into the following groups:

Appearance

Property	Description
Background Color	Specifies the background color for the control.
Borders, Border Color, Border Dash Style and Border Width	Specify border settings for the control.
Formatting Rules	Opens 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. To learn more on this, see Conditionally change a control's appearance.
Padding	Specifies indent values which are used to render the contents of the control.
Style Priority	Allows you to define the priority of various style elements (such as background color, border color, etc.). For more information on style inheritance, see Understand styles concepts.
Styles	Assigns an existing (or newly created) style to control, and also specifies Use odd and even styles. For more information on style inheritance, see Understand styles concepts.
View Style	Specifies the style of the displayed gauge.
View Theme	Specifies the color theme of the displayed gauge.

View type

Specifies the type of the displayed gauge. The following view types are supported:

Circular and Linear gauges

Behaviour

Property	Description
Anchor Horizontally	Specifies the horizontal anchoring style of the control, so that after page rendering it stays attached to the left control, right control, or both.
Anchor Vertically	Specifies the vertical anchoring style of the control, so that after a page is rendered it stays attached to the top control, bottom control, or both.
Scripts	This property contains events, which you can handle by the required scripts. For more information on scripting, see Handle events via scripts.
Visible	Specifies whether the control should be visible in Print Preview.

Data

Property	Description
(Data Bindings)	This property allows you to bind some of a cell's properties (Bookmark, NavigateURL, Tag and Text) to a data field obtained from the report's data source, and to apply a format string to it.
Actual Value	Specifies the value displayed by a gauge.
Maximum	Specifies the gauge's maximum value.
Minimum	Specifies the gauge's minimum value.
Tag	This property allows you to add some additional information to the control; for example its id, by which it can then be accessible via scripts.
Target Value	Specifies the position of the target value marker.

Design

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

Layout

Property	Description
Location	Specifies the control's location, in report measurement units.
Size	Specifies the control's size, in report measurement units.
Snap Line Margin	Specifies 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.

Navigation

Property	Description
Bookmarkand Parent Bookmark	These properties are intended for the creation of a hierarchical structure within a report called a document map. For an explanation and help, see Add bookmarks. 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.
Navigate URLand Target	Use the Navigate 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 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 Navigate URL property, and setting the Target property to "_self". For more information, see Create hyperlinks. The Navigate 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 Navigate URL.Binding drop-down selector, select the required data field.

Property

Description

Bookmarkand Parent Bookmark

These properties are intended for the creation of a hierarchical structure within a report called a document map. For an explanation and help, see Add bookmarks.

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.

Navigate URLand Target

Use the Navigate 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 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 Navigate URL property, and setting the Target property to "_self". For more information, see Create hyperlinks.

The Navigate 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 Navigate URL.Binding drop-down selector, select the required data field.