HowTo: Using SD MultiWheel Control for Smart Devices

SD Multiwheel is a control that allows the user to set multiple values by swiping up and down.

This allows you to minimize the number of Tap Gesture and group values corresponding to a single concept.

MultiWheel Example

This article explains few concepts of the control. Do it yourself, follow the steps below or check this video.

How it works

In order to use the MultiWheel control, a Structured Data Type (SDT) with the following structure has to be created:


Load the Structured Data Type with a Data Provider object adding the values ​​that will appear in the Multiwheel.

Load Example

DP - SDMultiWheel

To show the control:

a) Create two variables:

&var1 Based on  Wheel type (SDT) and with the property Collection property in True.
&var2 Based on Character.


b) In the Layout section, add the variable &var2 and set the Control Type Property = "SD MultiWheel".

c) In the Event section, add the following code:

&var1 = DataProviderWheel()
&var2 = &var1.ToJson()

How to load the Wheel SDT

The field values ​​of the SDT members must be:

  • "Name" and "Title" have the name and title of the column.
  • "Type" supports "int" for numeric ranges and "char" for strings.
  • "Value" is where GeneXus reads and writes the current value of the field, always handled as string.
  • "Range" is a vector of strings with the range of values ​​to show in the wheel, this value is always required.
     For numeric type, the vector has the beginning and end of the range of numbers that will be shown on the picker.
     For character type, it has each of the values ​​you want to appear on the picker.
  • "Unit" is the unit of the column (this is used to format the string shown in the field in the device after choosing a value).

Examples of use

Blood pressure:


     { "Name":"Systolic", "Title":"Systolic", "Unit":"/", "Type":"int", "Range":["8","18"], "Value":"12"},
     { "Name":"Diastolic", "Title":"Diastolic", "Unit":"mmHg", "Type":"int", "Range":["4","14"], "Value":"8"}


Medicine dose:


    { "Name":"Dose", "Title":"Dose", "Type":"char", "Value":"1", "Unit":"",
    { "Name":"Measure", "Title":"Measure", "Type":"char", "Value":"tablet", "Unit":"\/",
    { "Name":"Period", "Title":"Period", "Type":"string", "Value":"week", "Unit":"",
             "Range":["4 hours","6 hours","8 hours","12 hours","day"]}




Control SD Multi Wheel for iOS was released within GeneXus X Evolution 2 Upgrade 2.
Android version of the control was released within GeneXus X Evolution 2 Upgrade 3.


See Also

HowTo: Using the Wheel Control for Smart Devices
Collection property
Control Type Property