Property

Description

Mobile Support

Color

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.

Windows Mobile devices do not support transparent background colors. If a control has a transparent background color, it will show up as white.

All

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

All

Enabled

All

Style

The appearance of controls. The options are:

• 2-D

• 3-D Sunken

• No Border (default)

Platform specific: For Android and iOS devices, all of the border styles (except for none) look the same.

Android and iOS

Image Style

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

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

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.

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.

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.

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.

Note: (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.

Android and iOS