Expands or contracts the image (zooms in or out) uniformly.

A Double value.  

object.Magnification [= value]

The Magnification Property syntax has these parts:

Assignment to this property sets both the MagnificationX and MagnificationY properties to the assigned value. When this property is accessed, it returns the lesser of either MagnificationX or MagnificationY. When MagnificationX and MagnificationY are the same, then the display preserves the aspect ratio of the image.

Although this property accepts any positive valued real number within its limits, the viewer can only approximate the magnification desired by duplicating individual image pixels for display so that the size of the displayed image approaches the magification desired. Due to the nature of digital display, individual pixels are always replicated an integral number of times.

As an example, assume a magnification of 3.5. most pixels will be replicated three times in both the x and y directions. However, every 3rd pixel, as well as every third row, will be replicated four times.

Setting this property will also force the AutoZoomMode property to be set to “mazmNone”.

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

This property and the corresponding McView.Display property, are the same but send different PropertyChnaged notifications. Assigning to this property will avoid recording the assignment, which may be useful if you are making many intermediate changes.

If the client application supports the OnPropertyChanged(ID_McDisplay_Magnification) event, the client application may choose to retrieve the ZoomedImageWidth and ZoomedImageHeight properties and resize itself.

Magnification is limited to the range from 1/64 (skip 63th pixels) to 64 (each displayed image pixel occupies 64 screen pixels). If you wish to exceed these limits, assign separately to MagnificationX and MagnificationY.