[Expand]General Information
[Collapse]WinForms Controls
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
   [Expand]Product Information
   [Expand]Getting Started
   [Collapse]Fundamental Concepts
    [Collapse]Graphical User Interface
     [Expand]Snap Application Elements
     [Expand]Main Toolbar
     [Collapse]Data Visualization Tools
       Bar Code
       Check Box
       Row Index
     Supported Formats
    [Expand]Developer Guidelines
    [Expand]Data Acquisition
    [Expand]Data Shaping
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)


This document describes report elements that allow you to provide Snap reports with either static or dynamic graphics.

The document consists of the following sections.

Expanded General Information

Snap provides several different report elements for displaying graphics using one of the supported graphical data formats. These elements can be divided into two categories:

The following image file formats are supported:

  • Bitmap (*.bmp, *.dib);

  • JPEG File Interchange Format (*.jpg, *.jpeg);

  • Portable Network Graphics (*.png);

  • Graphics Interchange Format (*.gif);

  • Tagged Image Format (*.tif, *.tiff);

  • Microsoft Enhanced Metafile (*.emf);

  • Windows Metafile (*.wmf).

Expanded Static Pictures

A static picture obtains image data from an image file and stores it in the reports file. The image data of a static picture never changes, and does not depend on the file from which the picture was added.

Snap provides two kinds of static pictures:

  • Inline Picture;

  • Floating Picture.

An Inline Picture is similar to an ordinary text symbol. Inline pictures are not affected by the options in the Picture Tools: Format tab of the main toolbar. To add an inline picture to a report, do the following.

  • In the document, place the caret in the position in which you wish to insert an inline picture.

  • Click the Inline Picture command in the General Tools: Insert tab of the main toolbar.

    The newly created inline picture will be inserted in the current caret position.

A Floating Picture can be freely resized and relocated using drag-and-drop. Unlike inline pictures, floating pictures are affected by the options in the Picture Tools: Format tab of the main menu.

To add a floating picture to a report, do the following.

  1. Place the caret in the paragraph to which the picture should be anchored.

  2. Click the Picture command in the General Tools: Insert tab of the main toolbar.

  3. In the invoked Open dialog, select an image file of a supported format and click Open.

    The newly added floating picture is placed next to the selected paragraph.

  4. A floating picture automatically anchors to the nearest text paragraph. The paragraph to which the selected picture is anchored is marked with an anchor icon (). You can anchor a picture to another paragraph using drag-and-drop.


There is no way to convert between floating and inline pictures.

Expanded Dynamic Pictures

Dynamic pictures in Snap are represented by image document fields, which are replaced with image data obtained from the data source when the Snap document is generated.

Typically, image fields are created automatically when a data field containing image data is added to a report from the Data Explorer.

The properties for the image field are available via the Properties command from the Data Tools: Field tab, which becomes active when an image field is selected.

The following properties are available for an image field.

  • Update Mode - specifies whether to preserve the image box size or the ratio of the original image;
  • Sizing - specifies how an image is resized to fit the size of the box.

Expanded See Also

Is this topic helpful?​​​​​​​