Object Properties

Property

Description

Value

Description

Data source

Select the method of determining the image data source, i.e. via file name, formula or variable name.

File name

Formula

Variable

Formula wizard

File name

Fixed file name: is evaluated if you have selected "File name" as the data source property. You then select the image file that you want by means of the file selection dialog. In this dialog, you can also insert the picture into the project by enabling the ("Embed image in project file" checkbox option. This option copies the image to the project thus making it available even without the external file. In this case, "(embedded)" will be shown as the file name.

Open file dialog

Relative path

The path is relative to the project path.

True

False

Yes

No

Formula

If you have selected "Formula" as the data source property, the file name is derived from a formula. The formula must return a "picture" value type. You can also enter a valid file name. However, this must first be converted to the "picture" type with the Drawing() function.

Formula

Formula wizard

Variable

If you have selected "Variable" as the data source property, the file name is taken from a variable.

Select the variable that you want from the drop-down box. The drop-down box lists all "picture" variables defined in your application.

Variable

Properties

Depending on your application, a dialog may open up at this point to allow you to define more properties.

Opens dialog

Save as JPEG

Embed the image as a JPEG file if possible (not all file types support this option).

True

False

Formula

Yes

No

Formula wizard

Original size

Specifies whether the picture is to be drawn in the original size (if it can be determined), or if the size of the picture�s frame is to be adjusted to fit.

True

False

Not defined

Yes

No

Not defined

Keep proportions

With this option you can specify whether the height/width proportions are to be kept (True) when inserting the picture or if the picture's frame is to be adjusted, possibly leading to distortion (False).

True

False

Formula

Yes

No

Formula wizard

Alignment

Describes how the image is to be arranged in the available area.

0

1

2

3

4

5

6

7

8

9

Centered

Next to each other (tiled)

Left top

Left bottom

Right top

Right bottom

Left

Right

Top

Bottom