1. On the "Creation" tab, 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 WLanguage properties are used to configure the displayed PDF page:

• 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.

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. For more details, see Choosing the image display mode.

"UI" tab

• the initial state of the control,
• whether or not a representation symbol is displayed in the control. This symbol is a thumbnail displayed by default to represent the Image control in the the editor.
  
  

  Image with representation symbol
  

  Image without representation symbol
  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 context 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).
  • 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 through 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
  For more details, see Animating an image.
• Click options
  For more details, see Clickable image in a window.

"Style" tab

• 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 custom shape settings.
   • 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.

Remark: The icon (to the right of the "Border" option) allows you to configure the shadow of the border. When a shadow is used, you can choose:

• the X and Y offset of the shadow,
• the percentage of opacity,
• the blur radius,
• the color of the shadow.