The Picture component allows you to add an image to your report or label. You can import any GIF, JPEG, or PNG image file.

 

 

To add a Picture, click Insert – Picture, then click the location on the report or  label where you want the Picture to appear. A standard Browse-For-File dialog box opens; use this dialog box to locate and select the picture you want to add from your local or network drive. The picture you select here will become the Sample Value for this component. You can later set the Value for this component (that is, the specific pictures listed in a table that you want to use in the report or label) when configuring the component’s properties. The following Picture properties can be configured:

 

Name

A unique, assigned name, consisting of the word “Picture” plus the first available number (for example, Picture 1, Picture 2, and so on), by default. You can also give your own, unique name to the component for ease of reference when using event methods.

 

X

The exact horizontal co-ordinate for the top left corner of the Picture.

 

Y

The exact vertical co-ordinate for the top left corner of the Picture.

 

Width

The width of the bounding box surrounding the Picture.

 

Height

The height of the bounding box surrounding the Picture.

 

Hide Duplicates

If you set this field to Yes duplicate entries will not be repeated.

 

Value

The value bound to the Picture component. This can be set to a field in one of your project’s tables that contains full paths to GIF, JPEG, or PNG images on your local or network drive; for example, c:\my documents\my pictures\apple.gif, c:\my documents\my pictures\lemon.gif, c:\my documents\my pictures\banana.gif, and so on.

 

Sample Value

The sample value that displays in the component during design time.

 

Scale Option

A rescaling option that allows you to select either Actual Size or Best Fit for your Picture.

 

Keep Aspect

If you set this field to Yes you will ensure that any resizing of the component, either vertical or horizontal, will resize the entire Picture proportionally.

 

Border Color

The border color for this component. To show the border, ensure Border Thickness is set a value larger then 0.  Click the button to go to the Color Chooser and select a border color.

 

Border Thickness

The thickness of this component's border. A border thickness of 0 produces no border.

 

Fill Style

The fill setting for this component (Opaque or Transparent).

 

Fill Color

The fill color for this component. To show the fill color, ensure Fill Style is set to Opaque. Click the button to go to the Color Chooser and select a fill color.

 

Horizontal Align

Indicates the alignment of the picture within the bounding box of this component in the horizontal direction.

 

Vertical Align

Indicates the alignment of the picture within the bounding box of this component in the vertical direction.

 

Rotated

Indicates whether the picture within the bounding box of this component is rotated 0, 90, 180 or 270 degrees.

 

X Shear

Indicates the amount of x shear to be applied to the picture.  A positive x shear cause the picture to be tilted to the left where a negative x shear cause the picture to be tilted to the right within the bounding box of this component.

 

Y Shear

Indicates the amount of y shear to be applied to the picture.  A positive y shear cause the picture to be tilted to the downward where a negative x shear cause the picture to be tilted to the upward within the bounding box of this component.

 

X Resolution

The x resolution is important when scaling pictures to actual size.   It the picture contains this information, this property will be ignored otherwise it represents the number of pixels within a the picture that is equivalent to moving one inch in the x direction (horizontally).

 

Y Resolution

The y resolution is important when scaling pictures to actual size.   It the picture contains this information, this property will be ignored otherwise it represents the number of pixels within a the picture that is equivalent to moving one inch in the y direction (vertically).

 

Print Quality

The property is used as hint to indicated whether the picture must be printed may be printed using a lossy picture format such as JPEG.

 

Can Grow

If you set this field to Yes the component will be automatically resized if its value is larger than its bounding box. Other components will be shifted to accommodate the size increase. If you set this field to No the component’s value may appear truncated in the bounding box.

 

Can Shrink

If you set this field to Yes the component will be automatically resized if its value is smaller than its bounding box. Other components will be shifted to occupy any created space. If you set this field to No the component’s bounding box may include empty space.

 

Propagate Change

The controls the behaviour of the Can Grow and Can Shrink properties and how this component propagates changes caused by another component.  When set To the right and below a change in the size/position of this component will affect the position of components to the right and below this component.   When set To the right only a change in the size/position of this component will only affect the position of components to the right and will not affect components below this component.  When set Below only a change in the size/position of this component will only affect the position of components below this component and will not affect components to the right of this component. When set No a change in the size/position of this component will not affect any other component.

 

Visible

If you set this field to No the Picture will be hidden.

 

Locked

If you set this field to Locked you will not be able to move the Picture by dragging.