Get/sets a value that specifies whether to take into account the content resolution (DPI) during displaying.

Namespace: Aurigma.GraphicsMill.AjaxControls
Assembly:   Aurigma.GraphicsMill.AjaxControls (in Aurigma.GraphicsMill.AjaxControls.dll)

Syntax

Visual Basic (Declaration)
<BrowsableAttribute(True)> _
<DefaultValueAttribute(False)> _
Public Property ScaleToActualSize As Boolean
C#
[BrowsableAttribute(true)]
[DefaultValueAttribute(false)]
public bool ScaleToActualSize { get; set; }
Visual C++
[BrowsableAttribute(true)]
[DefaultValueAttribute(false)]
public:
property bool ScaleToActualSize {
	bool get ();
	void set (bool value);
}

Property Value

The value that specifies whether to take into account the content resolution (DPI) during displaying.

Remarks

The BitmapViewer supports displaying image in its physical size. Actual physical size of the image is measured in metrical units (inches, centimeters) and depends on image resolution. To apply this functionality you should set ScaleToActualSize property to true. In this mode the control takes into account the resolution of the image, that allows you to display it in actual physical size when image resolution differs from monitor resolution. Also, this feature is useful for images with different vertical and horizontal resolutions, e.g. faxes.

Note: When the ScaleToActualSize is true the BitmapViewer will resize the image in memory before displaying it. Therefore it may cause unnecessary performance overhead if you do not care about physical resolution. That is why we recommend to use this feature only when it is actually needed.

See Also