Placement of the scale objects

There are 2 ways of placing the objects over the scale:

  1. Placement using value along the scale.
  2. Placement using object’s location over the scale.

The only 1 approach can be used in a time.

Not all objects support both approaches. The tick marks, labels, ranges, bar indicators, markers and needles can be placed using its value along the scale only. The state indicator and custom elements (the framework elements from CustomItemsList) can use both approaches.

Placement using value along the scale.
There are 3 parameters which have an effect when placing the object using its value along the scale:

  1. Value along the scale.
  2. Object’s baseline.
  3. Offset of the object from the baseline.

When the first parameter (value along the scale) is quite self-descriptive the second (object’s baseline) and third (offset of the object from the baseline) require an explanation.

Baseline
All scales (Horizontal, Radial and Vertical) have a scale bar. Width of the scale bar is controlled by StartWidth and EndWidth properties. Object’s baseline is defined as one of the scale bar borders and offset direction. Also the offset direction specifies initial position of the object relative to the baseline. There are 3 baselines and 2 offset directions:

Baselines:.

  1. Outer
  2. Center
  3. Inner

Offset directions:.

  1. Outwards
  2. Towards

These values have a different meaning for the different scale types.

Horizontal scale

Manco Gauge control - Horizontal scale beselines

Outer, outwards

Manco Gauge control - Horizontal scale outer, outwards

Outer, towards

Manco Gauge control - Horizontal scale outer, towards

Center, outwards

Manco Gauge control - Horizontal scale center, outwards

Center

Manco Gauge control - Horizontal scale center

Center, towards

Manco Gauge control - Horizontal scale center, towards

Inner, outwards

Manco Gauge control - Horizontal scale inner, outwards

Inner, towards

Manco Gauge control - Horizontal scale inner, towards

Radial scale

Manco Gauge control - Radial scale beselines

Outer, outwards

Manco Gauge control - Radial scale outer, outwards

Outer, towards

Manco Gauge control - Radial scale outer, towards

Center, outwards

Manco Gauge control - Radial scale center, outwards

Center

Manco Gauge control - Radial scale center

Center, towards

Manco Gauge control - Radial scale center, towards

Inner, outwards

Manco Gauge control - Radial scale inner, outwards

Inner, towards

Manco Gauge control - Radial scale inner, towards

Vertical scale

Manco Gauge control - Vertical scale beselines

Outer, outwards

Manco Gauge control - Vertical scale outer, outwards

Outer, towards

Manco Gauge control - Vertical scale outer, towards

Center, outwards

Manco Gauge control - Vertical scale center, outwards

Center

Manco Gauge control - Vertical scale center

Center, towards

Manco Gauge control - Vertical scale center, towards

Inner, outwards

Manco Gauge control - Vertical scale inner, outwards

Inner, towards

Manco Gauge control - Vertical scale inner, towards

Offset
The offset specify distance of the object from its baseline. The offset’s direction depends on the object’s baseline as it is described early in this topic. To set offset of any scale element (tick mark, label, range and so on) you should use Manco.DataVisualization.Common.ObjectMeasure class. For example:

[XAML]
[C#]
[Visual Basic]

Properties which handle baseline and offset
Every scale (Horizontal, Radial and Vertical) provides set of properties which can be used to set baseline and offset of the tick marks and labels:

Baseline and offset for all other scale elements like indicators, ranges, and custom elements are controlled by the attachable properties of the Manco.DataVisualization.Scales.ObjectArrangement class:

Value of the custom elements is controlled using ObjectArrangement.ScaleValue attachable property.

[XAML]

Placement using object’s location over the scale.
With this approach you can place some scale objects at the arbitrary place on the scale using Relative Measurements feature. Not all objects support this approach. The tick marks, labels, ranges, bar indicators, markers and needles can be placed using its value along the scale only. The state indicator and custom elements (the framework elements from CustomItemsList) can use this approach.

To specify location of the framework element over the scale you should use ObjectArrangement.Location. It is property of type Manco.DataVisualization.Common.ObjectLocation class:

[XAML]
[C#]
[Visual Basic]