Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TdxGaugeCustomCaptionOptionsLayout.CenterPositionFactorY Property

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

#Declaration

Delphi
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.

See Also