TdxGaugeCustomCaptionOptionsLayout.CenterPositionFactorY Property

Specifies the relative vertical position of the custom inscription within a scale.

Declaration

property CenterPositionFactorY: Single read; write;

Property Value

Type
Single

Remarks

The CenterPositionFactorX and CenterPositionFactorY properties are used collectively to specify the custom label’s position within the scale’s boundaries. The distance between the center of the custom inscription’s bounding box and the scale’s top border is the result of multiplying the CenterPositionFactorY property value by the scale’s height.

Negative values of the CenterPositionFactorX and CenterPositionFactorY properties are valid as well. The negative value of the CenterPositionFactorY property specifies how far the center of the custom inscription’s bounding box is shifted up from the scale’s top border. The actual difference between the center of the label’s bounding box and the scale’s top border is calculated in the same manner as if the CenterPositionFactorY property value was positive.

If either the scale’s boundaries match the Gauge Control‘s bounds or the CenterPositionFactorY property value is low enough, the custom label can be shifted beyond the visible area.

The values of the CenterPositionFactorX and CenterPositionFactorY properties can exceed 1. The CenterPositionFactorY property values beyond 1 specify how far the center of the custom inscription’s bounding box is shifted down from the scale’s bottom border, possibly beyond the visible area. The actual difference between the center of the custom inscription’s bounding box and the scale’s bottom border is calculated in the same manner as if the CenterPositionFactorY property value was within range between 0 and 1.

If the CenterPositionFactorY property is set to 0 or 1, the center of the custom label’s bounding box is located on the scale’s top or bottom border, respectively.