GnomeDateEdit

Name

GnomeDateEdit -- 

Synopsis


#include <libgnomeui/libgnomeui.h>


enum        GnomeDateEditFlags;
struct      GnomeDateEdit;
GtkWidget*  gnome_date_edit_new             (time_t the_time,
                                             gboolean show_time,
                                             gboolean use_24_format);
GtkWidget*  gnome_date_edit_new_flags       (time_t the_time,
                                             GnomeDateEditFlags flags);
void        gnome_date_edit_construct       (GnomeDateEdit *gde,
                                             time_t the_time,
                                             GnomeDateEditFlags flags);
void        gnome_date_edit_set_time        (GnomeDateEdit *gde,
                                             time_t the_time);
time_t      gnome_date_edit_get_time        (GnomeDateEdit *gde);
void        gnome_date_edit_set_popup_range (GnomeDateEdit *gde,
                                             int low_hour,
                                             int up_hour);
void        gnome_date_edit_set_flags       (GnomeDateEdit *gde,
                                             GnomeDateEditFlags flags);
int         gnome_date_edit_get_flags       (GnomeDateEdit *gde);
time_t      gnome_date_edit_get_initial_time
                                            (GnomeDateEdit *gde);
time_t      gnome_date_edit_get_date        (GnomeDateEdit *gde);


Object Hierarchy


  GObject
   +----GtkObject
         +----GtkWidget
               +----GtkContainer
                     +----GtkBox
                           +----GtkHBox
                                 +----GnomeDateEdit

Properties


  "time"                 gulong               : Read / Write
  "dateedit-flags"       GnomeDateEditFlags   : Read / Write
  "lower-hour"           gint                 : Read / Write
  "upper-hour"           gint                 : Read / Write
  "initial-time"         gulong               : Read / Write

Signal Prototypes


"date-changed"
            void        user_function      (GnomeDateEdit *dateedit,
                                            gpointer user_data);
"time-changed"
            void        user_function      (GnomeDateEdit *dateedit,
                                            gpointer user_data);

Description

Details

enum GnomeDateEditFlags

typedef enum {
	GNOME_DATE_EDIT_SHOW_TIME             = 1 << 0,
	GNOME_DATE_EDIT_24_HR                 = 1 << 1,
	GNOME_DATE_EDIT_WEEK_STARTS_ON_MONDAY = 1 << 2
} GnomeDateEditFlags;


struct GnomeDateEdit

struct GnomeDateEdit;


gnome_date_edit_new ()

GtkWidget*  gnome_date_edit_new             (time_t the_time,
                                             gboolean show_time,
                                             gboolean use_24_format);

Creates a new GnomeDateEdit widget which can be used to provide an easy to use way for entering dates and times. If the_time is 0 then current time is used.


gnome_date_edit_new_flags ()

GtkWidget*  gnome_date_edit_new_flags       (time_t the_time,
                                             GnomeDateEditFlags flags);

Creates a new GnomeDateEdit widget with the specified flags. If the_time is 0 then current time is used.


gnome_date_edit_construct ()

void        gnome_date_edit_construct       (GnomeDateEdit *gde,
                                             time_t the_time,
                                             GnomeDateEditFlags flags);

For language bindings and subclassing only


gnome_date_edit_set_time ()

void        gnome_date_edit_set_time        (GnomeDateEdit *gde,
                                             time_t the_time);

Changes the displayed date and time in the GnomeDateEdit widget to be the one represented by the_time. If the_time is 0 then current time is used.


gnome_date_edit_get_time ()

time_t      gnome_date_edit_get_time        (GnomeDateEdit *gde);


gnome_date_edit_set_popup_range ()

void        gnome_date_edit_set_popup_range (GnomeDateEdit *gde,
                                             int low_hour,
                                             int up_hour);

Sets the range of times that will be provide by the time popup selectors.


gnome_date_edit_set_flags ()

void        gnome_date_edit_set_flags       (GnomeDateEdit *gde,
                                             GnomeDateEditFlags flags);

Changes the display flags on an existing date editor widget.


gnome_date_edit_get_flags ()

int         gnome_date_edit_get_flags       (GnomeDateEdit *gde);

Queries the display flags on a date editor widget.


gnome_date_edit_get_initial_time ()

time_t      gnome_date_edit_get_initial_time
                                            (GnomeDateEdit *gde);

Queries the initial time that was set using the gnome_date_edit_set_time or during creation


gnome_date_edit_get_date ()

time_t      gnome_date_edit_get_date        (GnomeDateEdit *gde);

Warning

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

Deprecated, use gnome_date_edit_get_time

Properties

"time" (gulong : Read / Write)

The time currently selected

"dateedit-flags" (GnomeDateEditFlags : Read / Write)

Flags for how DateEdit looks

"lower-hour" (gint : Read / Write)

Lower hour in the time popup selector

"upper-hour" (gint : Read / Write)

Upper hour in the time popup selector

"initial-time" (gulong : Read / Write)

The initial time

Signals

The "date-changed" signal

void        user_function                  (GnomeDateEdit *dateedit,
                                            gpointer user_data);


The "time-changed" signal

void        user_function                  (GnomeDateEdit *dateedit,
                                            gpointer user_data);