OLE Container Auto Size Options

The painter supports the four automatic sizing ("AutoSize") options "Clip", "Stretch", "Proportional" and "Default". All visual objects have an inherent size. This is called the "image size". The size of the OLE Container form field object itself is called the "object size". The autosize options enable you to size an OLE Container form field object in terms of none, either, or a combination of both of these two sizes. The effect of the different autosize options is shown in the following table.

Clip (no sizing)

This option results in the top-left corner of the image being displayed at the top-left corner of the OLE Container. If the image size is greater (in either the horizontal or vertical directions) than the object, then the image is clipped such that it is contained within the object. This option enables the object to be resized in the painter.

Stretch (image to object)

This option results in the top-left corner of the image being displayed at the top-left corner of the OLE Container object. If the image size (in either the horizontal or vertical directions) is not the same as the object size, then the image has its aspect ratio altered such that the image completely fills the internal dimensions of the object (i.e. the image is distorted). This option enables the object to be resized in the painter.

Proportional (Image proportional)

This option results in the image being scaled such that the image is centered within the object and the aspect ratio of the image is preserved. This option enables the object to be resized in the painter.

Default (Object to image)

This option results in the object expanding in size in the horizontal direction, the vertical direction, or both, such that the object fully contains the image, and the aspect ratio of the image is preserved. This option does not enable the object to be resized.