Picture Box Control

Description

The Picture Box control can display an image populated by a file source or an image populated by a data source.

Properties Common to Most Controls

For more information about the properties listed below, see Properties Common to Most Controls.

For more information regarding each of the property groups, see the Control Reference.

Actions

Image Source

Can be configured using the Expressions panel.

Specifies the image that is displayed.

Supported image formats include: BMP, JPG, JPEG, GIF, TIF, TIFF, PNG, ICO, DIB, RLE, JPE, JFIF, EMF, WMF, and SVG.

Image URL

Type: String

Can be configured in the Expressions panel.

Specifies a path to the image that is displayed. Use the Expression editor to specify all or part of a path using a field from a data source.

Supported image formats include: BMP, JPG, JPEG, GIF, TIF, TIFF, PNG, ICO, DIB, RLE, JPE, JFIF, EMF, WMF, and SVG.

For a SAAS deployment, images must be placed in a location that is accessible to the public internet. On-premises deployments can access images anywhere in the organization’s intranet and make use of file paths.

Sizing

Specifies how the image is proportioned within the bounds of the control.

Options for sizing include:

  • Normal: The image is displayed using its original dimensions and the bounds of the control remain unchanged. The image is clipped if it is larger than the bounds of the control. If the image is smaller than the control, it is aligned using the configuration set in the Alignment property.
  • This is the default.

  • Stretch Image: The bounds of the control remain the same size and the image is stretched or shrunk to fill the control's height and width.
  • Auto Size: The image is displayed using its original dimensions and the control's dimensions are adjusted to that of the image.
  • Zoom Image: The image is proportionately resized so that it fits the bounds of the control.
  • Squeeze: When the control is larger than the original dimensions of the image, the image is displayed using its original dimensions and aligned using the configuration set in the Alignment property. When the image is larger than the control's dimensions, the image is proportionately resized to fit the control's dimensions and aligned using the configuration set in the Alignment property.
  • Tile: The image is replicated within the control starting from the upper-left corner. The replicated image is clipped if it does not fit within the bounds of the control.

Alignment

Sets the alignment of the image within the control.

Behavior

Anchor Vertically

Sets the location of the control in relation to the parent container. When the parent container changes size, the control may move or resize to maintain its position.

The options for vertically anchoring include:

  • None: The control's size and location are not affected when the container size changes.
  • Top: The distance between the top of the control and the top of the container remains fixed when the container size changes.
  • Bottom: The distance between the bottom of the control and the bottom of the container remains fixed when the container size changes.
  • Both: The distance from the top and bottom of the control from the top and bottom of the container remains fixed when the container size changes. This means that control is resized to maintain these fixed distances.

Anchor Horizontally

Sets the location of the control in relation to the parent container. When the parent container changes size, the control may move or resize to maintain its position.

The options for horizontally anchoring include:

  • None: When the parent container changes size, the control's size and location are not affected when the container size changes.
  • Left: The distance between the left edge of the control and the left side of the container remains fixed when the container size changes.
  • Right: The distance between the right edge of the control and the right side of the container remains fixed when the container size changes.
  • Both: The distance from the left and right edges of the control from the left and right sides of the container remains fixed when the container size changes. This means that control is resized to maintain these fixed distances.

Process Duplicates Mode

Sets how report controls with duplicate records should be processed. The data type that is processed must be set in the Process Duplicates Target property.

Methods for processing duplicate data include:

  • Leave: The duplicate control is always printed.
  • Merge: The identical data values are merged into a single column.
  • Suppress: A blank space is printed in place of the duplicate data.
  • Suppress and Shrink: The control that contains duplicate data is not printed.
  • This setting has no effect on intersecting controls or in vertical bands.

If there are no controls in a band after duplicates are removed, VertiGIS Studio Reporting does not print the band.

Process Duplicates Target

Sets what data is processed by the Process Duplicates Mode property.

Options include:

  • Value: The value of the control.
  • Tag: The data in the control's Tag property.

For the Picture Box control, the Image Source property or Image URL property is used to assigned a value to the Value property, depending upon which one has been configured.

Process Null Values

Specifies how a report item containing a null value should be processed.

Methods of processing the null values include:

  • Leave: The report item is always printed.
  • Suppress: A blank space is printed in place of the null data.
  • Suppress and Shrink: The report item that contains null data is not printed.
  • This setting has no effect on intersecting controls or in vertical bands.

If there are no controls in a band after duplicates are removed, VertiGIS Studio Reporting does not print the band.

Sizing

Specifies how the image is proportioned within the bounds of the control.

Options for sizing include:

  • Normal: The image is displayed using its original dimensions and the bounds of the control remain unchanged. The image is clipped if it is larger than the bounds of the control. If the image is smaller than the control, it is aligned using the configuration set in the Alignment property.
  • This is the default.

  • Stretch Image: The bounds of the control remain the same size and the image is stretched or shrunk to fill the control's height and width.
  • Auto Size: The image is displayed using its original dimensions and the control's dimensions are adjusted to that of the image.
  • Zoom Image: The image is proportionately resized so that it fits the bounds of the control.
  • Squeeze: When the control is larger than the original dimensions of the image, the image is displayed using its original dimensions and aligned using the configuration set in the Alignment property. When the image is larger than the control's dimensions, the image is proportionately resized to fit the control's dimensions and aligned using the configuration set in the Alignment property.
  • Tile: The image is replicated within the control starting from the upper-left corner. The replicated image is clipped if it does not fit within the bounds of the control.

Alignment

Sets the alignment of the image within the control.

Data

Image Source

Can be configured using the Expressions panel.

Specifies the image that is displayed.

Supported image formats include: BMP, JPG, JPEG, GIF, TIF, TIFF, PNG, ICO, DIB, RLE, JPE, JFIF, EMF, WMF, and SVG.

Image URL

Type: String

Can be configured in the Expressions panel.

Specifies a path to the image that is displayed. Use the Expression editor to specify all or part of a path using a field from a data source.

Supported image formats include: BMP, JPG, JPEG, GIF, TIF, TIFF, PNG, ICO, DIB, RLE, JPE, JFIF, EMF, WMF, and SVG.

For a SAAS deployment, images must be placed in a location that is accessible to the public internet. On-premises deployments can access images anywhere in the organization’s intranet and make use of file paths.

Related Tutorials

Refer to the following resources for additional help on implementing this control: