Specifies the name of the image file for display on a mobile device. If you are developing your project to run on Windows, define your file in the Image File Name property.
When this property has a value, the control will appear as several image buttons (not radio buttons) during Runtime. The image will not be displayed in the Studio's Form Editor.
The image format is the same as for image button. Refer to the Image button section in Button Style. Out of the four or six images, only the Pressed, Disabled and Normal images are used.
If the Radio control has a value in the Display list property, that value will be seen over the image. Unlike desktop, if the Display list value is blank, the value is not copied from the Items list property, so only the image will be shown.
If the Radio control has more than one value in the Items list property, the control width will be divided according to the number of items. The Choice columns property is ignored and will behave as if the value is equal to the number of items. For example, if the Items list property has two items, the control will show two image buttons, one next to the other. The same image will be displayed for each of the items.
To display both text and images, the text needs to be set in the Display list property.
Recommended usage: If you have the same image for all the items, you should use a single Radio control with the image defined. If, however, you want more control over the image location or if you need to have different images for the different items, you should define several Radio controls and attach them to the same variable.
Exceptions: Controls with this value set cannot be used in a Table control.
See also:
The Rich Client Samples project (program RMO06)
How Do I Define a Two-State Image?
|