Skip to main content
A newer version of this page is available. .

Designer

  • 3 minutes to read

This document briefly describes how the Gauge Designer can be invoked and briefly explains its structure.

The Gauge designer is an integrated visual editing tool that provides you with the ability to quickly and easily customize gauges. It contains all the necessary instruments for editing gauges and its elements including Label and Range editors.

The designer can be invoked for a gauge or for any of its elements using the corresponding smart tags. This makes it possible for you to edit not only the whole gauge, but also the separate gauge elements you really need.

To open the designer for a gauge or its element, do the following:

  • locate the Gauge control’s smart tag and click Customize Gauge Control….
  • select the gauge / element in the Visual Gauge Control Designer;
  • locate the smart tag and click it;
  • select Run Designer.

The following image demonstrates this approach for the Effect Layer element.

Customize-ASPxGaugeControl

Run Effect Layer Designer

After that, you will see the Effect Layers editor.

Design-Time Features - Effect Layers Editor

As you see, this editor contains all necessary settings to customize an element’s appearance, geometry and the scale position.

Let’s consider the common designer structure.

The typical designer view consists of the navigation pane on the left and the working area. The navigation pane is divided into three main categories, providing access to gauge properties grouped by features.

  • Main
  • Elements
  • Bindings

These panes are described below using an example of the Circular Gauge editor.

Main

The Main category’s working area demonstrates the structure of the selected gauge and marks its main elements.

Circular Gauge Designer

Elements

The Elements category allows creation and removal of elements, and the changing of their properties as required.

Designer - Needles Settings

Supported gauge element types are listed under the category’s name. To get access to a specific element, click the required gauge element type.

If the gauge does not contain an element of a specific type, then the corresponding item in the navigation pane is grayed out (see the image above). In this instance, you can create the first element of this type by clicking the DesignerPlusButton icon at the right of the group’s name.

Then, choose the required element via the Selected Element combo box at the top of the working area.

DesignerSelectElement

If an element of a specific type already exists, the DesignerPlusButton icon is hidden. In this instance you can add more elements of this type by clicking the Clone button. This creates a new element, copying the currently selected element’s properties.

To remove an existing element, first select it via the Selected Element combo box and then click the Remove button.

Bindings

This feature is not supported for the ASPxGauge control at design time. So, the Bindings section is not available in the designer.

For information on data binding at runtime, see the Data Binding document.