zoom

Type: Integer

Availability: Read or write at any time

The zoom property of the MultiMedia class contains the zoom factor of the video image. As not all devices support this facility, its use raises an exception when it is not supported. The zoom default value is 100 percent.

A zoom factor of 50 percent halves the size of the control and a factor of 200 percent doubles the control size, and so on. Setting the zoom property to zero (0) when the value of the autoSize property is false stretches the media image to the current size of the client area of the control.

MultiMedia controls are sized as follows.

• When the value of the autoSize property is true, the size of the control is set to the size of the displayed image (multiplied by the value of the zoom property divided by 100) plus the size of any playbar and caption. If the device or file being played does not involve a playback image, the control is not visible. If the value of the zoom property is zero (0), 100 is used.

• When the value of the autoSize property is false and the value of the zoom property is not zero, the control size is not affected by the size of the displayed image. Only as much of the displayed image that fits in the client area of the control is displayed.

• When the value of the autoSize property is false and the value of the zoom property is zero (0), the displayed image is stretched to fit the client area of the control.

For the JadeRichText class, the zoom property contains the factor by which the contents of the control are zoomed. This is a scale factor in the range 2 percent through 6,400 percent. A value of zero (0) indicates no zooming. The zoom default value is 100 percent; that is, this property is set to zero (0). A zoom factor of 50 percent halves the size of the control and a factor of 200 percent doubles the control size, and so on. For a rich text control, the zoom property requires a scalable font; for example, the Microsoft Sans Serif font is not a True Type font and therefore it cannot be scaled.

The zoom property of the JadeTextEdit control, which is read and write at run time only, contains the current zoom factor.

The zoom factor, which defaults to zero (0), enables you to increase or decrease the font size of text in the text editor in steps of one point. The point size is added to or removed from the font size. Although you can specify a value in the range -10 points through 150 points, the displayed point size never decreases below two points.

The numeric keypad plus (+), minus (-), and divide (/) character keys in conjunction with the Ctrl key set the zoom value up by one, down by one, and to zero (0), respectively.