TdxGaugeScaleOptionsCustomLayout.WidthFactor Property

Specifies the relative width of the scale‘s bounding box.

Declaration

property WidthFactor: Single read; write;

Property Value

Type
Single

Remarks

The HeightFactor and WidthFactor properties are used collectively to specify the relative dimensions (in factor values) of bounding boxes that determine the actual size of all scales. The WidthFactor property specifies the maximum relative width of the scale regardless of its current visual style. The actual area occupied by a scale does not necessarily match the size of its bounding box, since the selected style determines the scale’s height-to-width ratio. If the Stretch property is set to True, the actual scale area is stretched to the specified HeightFactor and WidthFactor values. The actual width of the scale’s bounding box is the result of multiplying the WidthFactor property value by the absolute width (in pixels) of the parent object.

The values of the HeightFactor and WidthFactor properties can exceed 1. The WidthFactor property values greater than 1 specify the number of times in which the width of the scale’s bounding box is greater than the parent object’s width. The actual width of the scale’s bounding box is calculated in the same manner as if the WidthFactor property value was within the range between 0 and 1.

Note

If the Width property value is changed from the default, the WidthFactor property’s value is ignored. Also, you can simultaneously specify both absolute and relative dimensions for scale boundaries by using the Height and WidthFactor or HeightFactor and Width combinations of properties.