Control Bar
3
Hildon Library
Control Bar
How to migrate Control Bars
Migrating Control Bars
ControlBar widgets are deprecated since Hildon 2.2 and a GtkScale
should be used to accomplish the same functionality.
To make a GtkScale have the same functionality as a control
bar you'll need to change some properties of the widget's Adjustment
so it has a range equal to the control bar's as well as the step
increment.
The following example shows a control bar with the range of
0 to 4.
A Typical Control Bar
To accomplish the same functionality as the previous control
bar example, one could use something like in the following example.
A Replacement for the Control Bar
Volume Bar
3
Hildon Library
Volume Bar
How to migrate Volume Bars
Migrating Volume Bars
VolumeBar widgets are deprecated since Hildon 2.2 and the way
to exactly reproduce their functionality is to use a GtkScale together
with a toggle button. Instead of the toggle button, a Hildon picker
button could be used or two radio buttons or any other widgets that
allow the user to choose from two options. The toggle button is used
in this example since it is the very similar with the deprecated
volume bar's button.
The deprecated volume bar is shown on the example bellow.
A Typical Volume Bar
A very similar widget can be done like the following example
shows.
A Replacement for the Volume Bar
Date Widgets
3
Hildon Library
Date Bar
How to migrate Date widgets
Migrating Date Widgets
Being deprecated since Hildon 2.2, the calendar popup and
date editor can be substituded by a HildonDateButton.
Examples of a typical calendar popup and a date editor are
presented bellow.
A Typical Calendar Popup
A Typical Date Editor
vbox), gtk_label_new ("Choose a date"), FALSE, FALSE, 10);
gtk_box_pack_start (GTK_BOX (dialog->vbox), GTK_WIDGET (date_editor), FALSE, FALSE, 10);
gtk_dialog_add_button (dialog, "Close", GTK_RESPONSE_CANCEL);
g_signal_connect (G_OBJECT (date_editor), "date_error", G_CALLBACK (on_error), NULL);
gtk_widget_show_all (GTK_WIDGET (dialog));
gtk_dialog_run (dialog);
hildon_date_editor_get_date (date_editor, &y, &m, &d);
]]>
The following example accomplishes equivalent functionality
using a HildonDateButton.
A Replacement for the Calendar Popup
vbox), GTK_WIDGET (date_button), FALSE, FALSE, 0);
gtk_widget_show_all (GTK_WIDGET (dialog));
gtk_dialog_run (dialog);
hildon_date_button_get_date (date_button, &y, &m, &d);
]]>
Weekday Picker
A weekday picker (deprecated since Hildon 2.2) can be easily
replaced by a HildonPickerButton.
The following example presents the deprecated weekday picker
in a dialog.
A Typical Weekday Picker
vbox), picker, TRUE, TRUE, 0);
gtk_dialog_add_button (dialog, "Close", GTK_RESPONSE_CLOSE);
gtk_widget_show_all (GTK_WIDGET (dialog));
gtk_dialog_run (dialog);
]]>
With a HildonPickerButton it is easy to add the weekdays to its
TouchSelector and thus having the same functionality.
A Replacement for the Weekday Picker
vbox), picker, TRUE, TRUE, 0);
gtk_widget_show_all (GTK_WIDGET (dialog));
gtk_dialog_run (dialog);
]]>
Time Widgets
3
Hildon Library
Time Widgets
How to migrate Time Widgets
Migrating Time Widgets
A HildonTimeButton is the way to replace the time picker and
time editor widgets (deprecated
since Hildon version 2.2).
A time picker and time editor are shown in the examples bellow.
A Typical Time Picker
A Typical Time Editor
vbox), GTK_WIDGET (time_editor), FALSE, FALSE, 0);
gtk_dialog_add_button (dialog, "Close", GTK_RESPONSE_CANCEL);
gtk_widget_show_all (GTK_WIDGET (dialog));
gtk_dialog_run (dialog);
]]>
The same functionality can be achieved as the following example
shows.
A Replacement for the Time Picker
vbox), GTK_WIDGET (time_button), FALSE, FALSE, 0);
gtk_widget_show_all (GTK_WIDGET (dialog));
gtk_dialog_run (dialog);
]]>
Number Widgets
3
Hildon Library
Number Widgets
How to migrate Number Widgets
Migrating Number Widgets
To achieve the same functionlity of HildonNumberEditor you
can use a HildonPickerButton with a HildonTouchSelectorEntry assigned
to it. With these widgets you can also easily have the functionality
of a HildonRangeEditor (not covered in this example). Both the
HildonNumberEditor and the HildonRangeEditor are deprecated since
Hildon 2.2.
The following example shows a typical NumberEditor.
A Typical Number Editor
vbox), hbox, TRUE, TRUE, 0);
gtk_widget_show_all (GTK_WIDGET (dialog));
gtk_dialog_run (dialog);
]]>
The functionality of the example above is shown on the example
bellow using by validating the HildonPickerButton's value every time
it's changed. The choices given in the HildonTouchSelectorShould be
the most common choices.
A Replacement for the Number Editor
vbox), picker, TRUE, TRUE, 0);
gtk_widget_show_all (GTK_WIDGET (dialog));
gtk_dialog_run (dialog);
]]>
Hildon Dialogs
3
Hildon Library
Hildon Dialogs
How to migrate Hildon Dialogs
Migrating Hildon Dialogs
The substitution of a HildonDialog should be easy. Since version
2.2, dialogs in Hildon should be used as normal GtkDialog objects.
Sort Dialogs
3
Hildon Library
Sort Dialogs
How to migrate Sort Dialogs
Migrating Sort Dialogs
HildonSortDialog is deprecated since Hildon 2.2. The correct way
to let the user sort contents is with menu filters.
The following example shows a typical NumberEditor.
A Typical Number Editor
The functionality of the example above is shown on the example
bellow using by validating the HildonPickerButton's value every time
it's changed. The choices given in the HildonTouchSelectorShould be
the most common choices.
A Replacement for the Number Editor