ImgArea Properties

The plug-in area has the following public properties, accessible via the ImgArea_GetProperty and ImgArea_SetProperty methods.

Plug-in Area Properties
Property name Type Default Description
SelectionVisible Boolean   True if the marquee selection is currently visible, False otherwise. Read-only.
ZoomFactorRange object   The option’s value specifies the minimum and maximum zoom factors. See the table below for details on the object contents of this property.
DefaultZoom object   The option’s value specifies the default zoom mode and factor when an image document is assigned to the plug-in area. See the table below for details on the object contents of this property.
ZoomToolRate Real 1.25

The option’s value specifies the zoom tool rate.

The zoom tool rate is the number with which the current zoom factor is multiplied when zooming in with the zoom tool. Conversely, the current zoom factor is divided by the zoom rate when zooming out.

UseHorzScrollbar Boolean True Whether to use the horizontal scrollbar or not.
UseVertScrollbar Boolean True Whether to use the vertical scrollbar or not.
AutoHideScrollbars Boolean True Whether to hide the scrollbars when the displayed image size fits the usable space on the corresponding axis.
DefaultHorzAlignment Longint 0

How to align the image in the display area when the image width is greater that the area width.

Set to -1 to align to the left, 0 for center, and 1 for right.

DefaultVertAlignment Longint 0

How to align the image in the display area when the image height is greater that the area height.

Set to -1 to align to the top, 0 for middle, and 1 for bottom.

The contents of the ZoomFactorRange property object are described in the following table.

The ZoomFactorRange Object
Property name Type Default Description
Minimum Real 0.02 The option’s value specifies the minimum zoom factor of the plug-in area.
Maximum Real 50.0 The option’s value specifies the maximum zoom factor of the plug-in area.

The contents of the DefaultZoom property object are described in the following table.

The DefaultZoom Object
Property name Type Default Description
ZoomFactor Real 1.0

The option’s value specifies the plug-in area’s default zoom factor.

If the AutoZoom property is set to 0 or to an invalid auto-zoom mode, this zoom factor is applied to the plug-in area when a document is assigned to it.

AutoZoom Longint 0

The option’s value specifies the plug-in area’s default auto-zoom mode.

If set to a valid auto-zoom mode, the specified mode is applied to the plug-in area when a document is assigned to it. If set to 0 or to an invalid auto-zoom mode, the zoom factor specified with the ZoomFactor property is applied.