Image Controls (Magic xpa 2.x)

« Go Back


Created ByKnowledge Migration User
Approval Process StatusPublished

Image Controls (Magic xpa 2.x)

In Image controls, you can insert images by specifying a file name, by mapping a variable that is an image, or by defining an expression that evaluates to yield an image.

The image can be used in two modes:

  • Static control – The control is static when the Data property is left empty and a file name and path are specified in the Default image file property.

  • Dynamic control – The control is dynamic when a variable or expression is set in the Data property, containing a file name value.


  • When using animated gif files, the animation will only be seen if the Image Style is set to Copied. Since version: 1.5

  • When the control size on the form is different than the image size, the image may look distorted since it has been stretched. In order to have a more accurate control size, it is recommended to use a high value in the horizontal and vertical factors and then use the Fit Size option in the Command palette.

  • The following images types are supported for the Rich Client Image control: BMP, GIF, JPEG, and PNG.

  • Once an image is loaded to the Image control, it will remain in the memory cache, so an update will only be seen after restarting the task.

The Image control properties are listed by categories:


  • In Display forms, to make a control transparent on its background, the control needs to be a two-dimensional (2-D) control and its color has to be a color that has a transparent background. Since version: 1.5

  • In Output forms, transparent images are not supported.

Platform Specific

  • For Android and iOS devices, animated gifs are not supported.

  • For Windows Mobile deployment, instead of localhost, the machine name or IP address should be used in the URL.

  • The Android and iOS RIA mobile clients support alternative images for different screen densities. For more information, see: Alternative Images – Android and iOS.

Related Topics