HildonPickerDialog

HildonPickerDialog — A utility widget that shows a HildonTouchSelector widget

Synopsis


#include <hildon/hildon.h>

                    HildonPickerDialog;
GtkWidget*          hildon_picker_dialog_new            (GtkWindow *parent);
gboolean            hildon_picker_dialog_set_selector   (HildonPickerDialog *dialog,
                                                         HildonTouchSelector *selector);
void                hildon_picker_dialog_set_done_label (HildonPickerDialog *dialog,
                                                         const gchar *label);
const gchar*        hildon_picker_dialog_get_done_label (HildonPickerDialog *dialog);
HildonTouchSelector* hildon_picker_dialog_get_selector  (HildonPickerDialog *dialog);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin
                                 +----GtkWindow
                                       +----GtkDialog
                                             +----HildonDialog
                                                   +----HildonPickerDialog

Implemented Interfaces

HildonPickerDialog implements AtkImplementorIface and GtkBuildable.

Properties

  "center-on-show"           gboolean              : Read / Write / Construct
  "done-button-text"         gchar*                : Read / Write / Construct

Style Properties

  "max-height-landscape"     guint                 : Read / Write
  "max-height-portrait"      guint                 : Read / Write

Description

HildonPickerDialog is a dialog that is used to show a HildonTouchSelector widget and a 'Done' button to allow users to finish their selections.

The HildonPickerDialog will show a 'Done' button in case the HildonTouchSelector allows multiple selection. The label of the button can be set using hildon_picker_dialog_set_done_label() and retrieved using hildon_picker_dialog_get_done_label()

HildonPickerDialog will emit "response" when a selection is completed, with the response id set to GTK_RESPONSE_OK (or GTK_RESPONSE_DELETE_EVENT if the selection was cancelled).

Note that in most cases developers don't need to deal directly with this widget. HildonPickerButton is designed to pop up a HildonPickerDialog and manage the interaction with it.

Details