The Image element acts as a placeholder for images. It as bindable element which can be only bound to a byte[] object. The binding value is always interpreted as an image.

An Image element must wrap an image in order to be valid. Before inserting an Image element, first place a dummy picture to a desired position and adjust its size as you see fit. You can select the picture and click the "Image" button on the Docentric Ribbon tab to wrap the picture into the Image element. You can bind the Image element as you would any bindable element, except you must bind it to a value representing a picture. This way you designate the dummy picture as a template for picture(s) rendered on the generated report.

This element has several properties that can be set in the Properties pane:

  • Name: Name of the element. You will only want to set the name when this is an unbound Image element. The name of an element provides a means of referencing an element from code when setting the value manually for it.
  • Bound: If checked, this element is an unbound element which means the value will be provided in code. In this case the "Value" binding can't be set.
  • Value: This must be a valid Data Binding. This binding must always result in a value of type byte[] when binding to a .Net object, and a value of Base64 string when binding to XML fragment. In all cases the resulting data must contain the image data in one of the formats supportd by MS Word.
Image element