1. On the "Creation" pane, in the "Usual controls" group, click "Image".
2. Click at the desired location to create the control. The control appears in the editor.

"General" tab

Choosing the image displayed in the control:
The image displayed by the control is selected via the button, "Browse" option.

If the Image control allows displaying a PDF file, simply select the file to display. The following properties are available:

• ImageMode: Used to find out and change the display mode of an image.
• NumberPage: Used to find out the number of pages in a PDF file displayed in an Image control.
• PageNumber: Used to find out and change the page number of a PDF file displayed in an Image control.

Caution: Displaying a PDF file in an image requires the GDI+ framework.

Versions 20 and later

To manage the DPIs of different devices, the name of image file must follow a specific format. For more details, see Android/iOS: Providing an image per DPI.

New in version 20

To manage the DPIs of different devices, the name of image file must follow a specific format. For more details, see Android/iOS: Providing an image per DPI.

To manage the DPIs of different devices, the name of image file must follow a specific format. For more details, see Android/iOS: Providing an image per DPI.

• the use of 9-slice scaling.
• the display mode, the transparency, the position and the symmetry of images. See Choosing the image display mode for more details.

"UI" tab

• the initial control status,
• Versions 21 and later
  whether the crosshair must be displayed (or not) in the control. The crosshair corresponds to the thumbnail displayed by default in the Image control in the editor.
  

  

  Image with crosshair

  

  Image without crosshair

  This option can also be enabled/disabled for all Image controls in the options of window editor. For more details, see Options of the window editor.
  New in version 21
  whether the crosshair must be displayed (or not) in the control. The crosshair corresponds to the thumbnail displayed by default in the Image control in the editor.
  

  

  Image with crosshair

  

  Image without crosshair

  This option can also be enabled/disabled for all Image controls in the options of window editor. For more details, see Options of the window editor.
  whether the crosshair must be displayed (or not) in the control. The crosshair corresponds to the thumbnail displayed by default in the Image control in the editor.
  
  

  Image with crosshair
  

  Image without crosshair
  This option can also be enabled/disabled for all Image controls in the options of window editor. For more details, see Options of the window editor.
• the action performed during a right click,
• the popup menu associated with the control,
• ...

"Details" tab

• The display parameters
  • Load in the background: This option is used to avoid locking the application if the image must be loaded from a site. An animation is automatically displayed in the Image control if necessary.
    Remark: If the Image control is found in a Looper control, the image is always loaded in background task (no matter whether the option is enabled or not).
  • Versions 18 and later
    Orientate according to the Exif data of image: If this option is enabled, a photo will be automatically displayed in the proper direction (portrait or landscape) according to the Exif data of photo.
    New in version 18
    Orientate according to the Exif data of image: If this option is enabled, a photo will be automatically displayed in the proper direction (portrait or landscape) according to the Exif data of photo.
    Orientate according to the Exif data of image: If this option is enabled, a photo will be automatically displayed in the proper direction (portrait or landscape) according to the Exif data of photo.
  • Automatic scrollbars and zoom: This option is required to display the PDF files in the Image controls. If the PDF file cannot be entirely displayed in the Image control, scrollbars are displayed and the zoom is available by pressing Ctrl + mouse wheel. The zoom can also be handled by programming with ..Zoom.
  • Zoom and scroll with finger: This option is used to manage the multi-touch in the mobile applications. For more details, see Multi-touch in an Image control.
• The animation options
  See Animating an image for more details.
• The options of click area
  For more details, see Clickable image in a window.

"Style" tab

• Versions 21 and later
  An animation when changing the image displayed in the control ("Control animation" element). The "Parameters" button is used to define the duration of animation.
  New in version 21
  An animation when changing the image displayed in the control ("Control animation" element). The "Parameters" button is used to define the duration of animation.
  An animation when changing the image displayed in the control ("Control animation" element). The "Parameters" button is used to define the duration of animation.
• A border ("Outside border" element).
• A soft shade ("soft shade" element).

1. Select the "Outside border" element.
2. Expand the "Border" list. The available borders are displayed.
   • The "Round xxx" options are used to define a round border. If these options are selected, a blue arrow allows you to open the window for style configuration in the "Style" tab.
   • The "Image (9-slice scaling)" option allows you to choose an image for the border and to configure it via 9-slice scaling.
   • The "Custom" option is used to define a custom border. If this option is selected, a blue arrow allows you to open the window for configuring the custom shape.
   • Versions 21 and later
     The "Round" option is used to create a round image. If these options are selected, a blue arrow allows you to open the configuration window (line thickness and style)
     Caution: To avoid being distorted, the display mode of the image must be homothetic.
     New in version 21
     The "Round" option is used to create a round image. If these options are selected, a blue arrow allows you to open the configuration window (line thickness and style)
     Caution: To avoid being distorted, the display mode of the image must be homothetic.
     The "Round" option is used to create a round image. If these options are selected, a blue arrow allows you to open the configuration window (line thickness and style)
     Caution: To avoid being distorted, the display mode of the image must be homothetic.