HildonNumberEditor

HildonNumberEditor — A widget used to enter a number within a pre-defined range.

Synopsis


#include <hildon/hildon.h>

enum                HildonNumberEditorErrorType;
                    HildonNumberEditor;
GtkWidget*          hildon_number_editor_new            (gint min,
                                                         gint max);
void                hildon_number_editor_set_range      (HildonNumberEditor *editor,
                                                         gint min,
                                                         gint max);
gint                hildon_number_editor_get_value      (HildonNumberEditor *editor);
void                hildon_number_editor_set_value      (HildonNumberEditor *editor,
                                                         gint value);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----HildonNumberEditor

Implemented Interfaces

HildonNumberEditor implements AtkImplementorIface and GtkBuildable.

Properties

  "value"                    gint                  : Read / Write

Signals

  "range-error"                                    : Run Last

Description

HildonNumberEditor is used to enter a number from a specific range. There are two buttons to scroll the value in number field. Manual input is also possible.

Note

HildonNumberEditor has been deprecated since Hildon 2.2 See Migrating Number Widgets section to know how to migrate this deprecated widget.

Example 23. HildonNumberEditor example

number_editor = hildon_number_editor_new (-250, 500);
hildon_number_editor_set_range (number_editor, 0, 100);


Details

enum HildonNumberEditorErrorType

typedef enum
{
    HILDON_NUMBER_EDITOR_ERROR_MAXIMUM_VALUE_EXCEED,
    HILDON_NUMBER_EDITOR_ERROR_MINIMUM_VALUE_EXCEED,
    HILDON_NUMBER_EDITOR_ERROR_ERRONEOUS_VALUE
}                                               HildonNumberEditorErrorType;

Warning

HildonNumberEditorErrorType is deprecated and should not be used in newly-written code.


HildonNumberEditor

typedef struct _HildonNumberEditor HildonNumberEditor;

Warning

HildonNumberEditor is deprecated and should not be used in newly-written code.


hildon_number_editor_new ()

GtkWidget*          hildon_number_editor_new            (gint min,
                                                         gint max);

Warning

hildon_number_editor_new is deprecated and should not be used in newly-written code.

Creates new number editor

min : minimum accepted value
max : maximum accepted value
Returns : a new HildonNumberEditor widget

hildon_number_editor_set_range ()

void                hildon_number_editor_set_range      (HildonNumberEditor *editor,
                                                         gint min,
                                                         gint max);

Warning

hildon_number_editor_set_range is deprecated and should not be used in newly-written code.

Sets accepted number range for editor

editor : a HildonNumberEditor widget
min : minimum accepted value
max : maximum accepted value

hildon_number_editor_get_value ()

gint                hildon_number_editor_get_value      (HildonNumberEditor *editor);

Warning

hildon_number_editor_get_value is deprecated and should not be used in newly-written code.

Gets the current value of the number editor.

editor : a HildonNumberEditor
Returns : the current value

hildon_number_editor_set_value ()

void                hildon_number_editor_set_value      (HildonNumberEditor *editor,
                                                         gint value);

Warning

hildon_number_editor_set_value is deprecated and should not be used in newly-written code.

Sets numeric value for number editor

editor : a HildonNumberEditor
value : numeric value for number editor

Property Details

The "value" property

  "value"                    gint                  : Read / Write

The current value of the number editor.

Default value: 0

Signal Details

The "range-error" signal

gboolean            user_function                      (HildonNumberEditor         *hildonnumbereditor,
                                                        HildonNumberEditorErrorType arg1,
                                                        gpointer                    user_data)               : Run Last

hildonnumbereditor : the object which received the signal.
arg1 :
user_data : user data set when the signal handler was connected.
Returns :