ScaleHeight Property

Object List Next Object

Defined By: Printer

Description:

Determines the internal vertical measurement of a form. Often used in combination with the ScaleWidth property, which determines the horizontal measurement.

Details:

The internal measurement reflects the usable area of the form, which excludes its title bar and borders. The unit used to measure the height is determined by the ScaleMode property setting.

Setting a value for the ScaleHeight property allows you to create a custom coordinate system for drawing or printing operations. This value provides for proportional measurements of the Form. Each control or graphics object can then be expressed as a fraction of the object's height on which it is placed. This is helpful in ensuring that the control size changes proportional to the form.

Using ScaleHeight and the related ScaleWidth, ScaleLeft, and ScaleTop properties, you can create a coordinate system complete with both positive and negative coordinates. The values of these properties essentially impose size limits on the objects placed on the form. Setting a "Scale" property to a positive value makes coordinates increase from top to bottom, and left to right. Setting it to a negative value makes coordinates increase in the opposite direction; bottom to top, and right to left. You can change these values as needed.

Both the ScaleMode and ScaleHeight properties directly affect each other. Specifically, setting the ScaleHeight property to any value automatically changes the ScaleMode value to 0. Setting the ScaleMode to any number greater than 0 changes ScaleHeight (and ScaleWidth) to this new unit of measurement. ScaleLeft and ScaleTop are set to 0. The Current X and Current Y settings will also change to reflect the new coordinates of the current point.

To set the "Scale" properties in one only statement, you can use the Scale method.

---

Note: Do not confuse the ScaleHeight and ScaleWidth properties with the Height and Width properties; they perform very different functions.

Data Type: Single

See Also:

CurrentX, Current Y properties, DrawMode property, DrawStyle property, FillColor property; ScaleMethod, ScaleLeft, ScaleTop properties; ScaleMode property