Description

A property used to change the magnification of the image so that the image fits the display window.

Property type

A mcAutoZoomMode enumeration.  

Syntax

object.AutoZoomMode [= value]

The AutoZoomMode Property syntax has these parts:

PartDescription
objectAn expression evaluating to an object of type McDisplay.
valueA mcAutoZoomMode enumeration, as described in settings.

Settings

The settings for value are:

ConstantValueDescription
 mazmNone0

The image is displayed using the current McView.Magnification settings

 mazmBestFit1

McView.Magnification is adjusted so that the entire image fits the display window, while preserving its aspect ratio.

 mazmFitToWidth2

McView.Magnification is adjusted so that the width of the image matches the width of the display window. The aspect ratio of the image is preserved, so part of it may be cut off at the bottom of the display or there may be a section undisplayed at the bottom.

 mazmFitToHeight3

McView.Magnification is adjusted so that the height of the image matches the height of the display window. The aspect ratio of the image is preserved, so part of it may be cut off at the right of the display or there may be a section undisplayed at the right.

Remarks

When setting this property, the image is resized to fit the display window. If the window is later resized, the viewer will again resize the image according to this property.

When the WhichSourceRegion property is set to mcwsrWholeImage or mcwsrImageAoi or when the Magnification property is set to any value (even the current value), then AutoZoomMode is automatically set to FALSE.

Refer to the mcAutoZoomMode enumeration for details on each resize option.

Exceptions

This property should not be set directly for an McView.Display property, use the corresponding “mirrored” McView property instead.