Salesforce

Image Appearance Control Properties (Magic xpa 4.x)

« Go Back

Information

 
Created BySalesforce Service User
Approval Process StatusPublished
Objective
Description

Image Appearance Control Properties (Magic xpa 4.x)

Property

Description

Mobile Support

Color

The color of the control taken from the Application Color repository.

Android devices require two colors: normal and pressed. Since we can only define one color per a control in Magic xpa, then if a color is defined for the control, then this color will be used for the normal (not pressed) state. The system native pressed color will be used as the press color of the control. So for example, when using a theme when the default colors of a push button control is normal=gray and pressed=blue, and Magic xpa sends a red color for the control, then the control will appear red when not pressed and blue (system default) when pressed.

This property is not available in Web Client tasks.

Android and iOS

Tooltip

Specifies whether a ToolTip is associated with this control. A number specifies the number of the ToolTip Help in the Help list.

You can enter an expression for a Tooltip so that the Tooltip is dynamic. You can create the expression in Unicode format.

Visible

Specifies whether the control will be visible to the user.

Android and iOS

Enabled

Specifies whether the control will be active.

Android and iOS

Style

The appearance of controls. The options are:

  • 2-D

  • 3-D Sunken

  • No Border (default)

This property is not available in Web Client tasks.

Image Style

Specifies the way an image fits into an Image control. The options are:

Copied – The image is copied onto the control as is. If the image is larger than the control, it is cropped. If it is smaller than the control, the uncovered part of the control is painted with the background color.

Distorted Scaling – The image is shrunk or stretched to fill the entire area of the control. The resulting image will be distorted, unless the aspect ratios of the image and the control are identical.

Scaled to Fill – The image is scaled to fill the entire control while maintaining the original aspect ratio of the image. This may result in only part of the image being seen on the control, unless the aspect ratios of the image and the control are identical.

Scaled to Fit – The entire image is scaled onto the control while maintaining the original aspect ratio of the image. This may result in part of the control remaining uncovered, unless the aspect ratios of the image and the control are identical.

Tiled – The image is copied onto the control as many times as needed to fill its entire area.

Since version: 1.5

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

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

Platform specific:

On Android and iOS:

  • It is not recommended to use an image defined with the Copied style since it is not factored according to the device DPI, so it will have different sizes in different devices.

  • In the Scaled to Fit style, the image is placed at the center of the Image control.

On Android only:

  • In the Scaled to Fill style, the image is placed at the center of the Image control.

This property is not available in Web Client tasks.

Android and iOS

Reference
Attachment 
Attachment