Pileus Git - ~andy/gtk/blob - gtk/gtkcalendar.h

   1 /* GTK - The GIMP Toolkit
   2  * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
   3  *
   4  * GTK Calendar Widget
   5  * Copyright (C) 1998 Cesar Miquel and Shawn T. Amundson
   6  *
   7  * This library is free software; you can redistribute it and/or
   8  * modify it under the terms of the GNU Lesser General Public
   9  * License as published by the Free Software Foundation; either
  10  * version 2 of the License, or (at your option) any later version.
  11  *
  12  * This library is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15  * Lesser General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU Lesser General Public
  18  * License along with this library; if not, write to the Free
  19  * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  20  */
  21
  22 /*
  23  * Modified by the GTK+ Team and others 1997-2000.  See the AUTHORS
  24  * file for a list of people on the GTK+ Team.  See the ChangeLog
  25  * files for a list of changes.  These files are distributed with
  26  * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
  27  */
  28
  29 #if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
  30 #error "Only <gtk/gtk.h> can be included directly."
  31 #endif
  32
  33 #ifndef __GTK_CALENDAR_H__
  34 #define __GTK_CALENDAR_H__
  35
  36
  37 #include <gtk/gtkwidget.h>
  38
  39
  40 G_BEGIN_DECLS
  41
  42 #define GTK_TYPE_CALENDAR                  (gtk_calendar_get_type ())
  43 #define GTK_CALENDAR(obj)                  (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_CALENDAR, GtkCalendar))
  44 #define GTK_CALENDAR_CLASS(klass)          (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_CALENDAR, GtkCalendarClass))
  45 #define GTK_IS_CALENDAR(obj)               (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_CALENDAR))
  46 #define GTK_IS_CALENDAR_CLASS(klass)       (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_CALENDAR))
  47 #define GTK_CALENDAR_GET_CLASS(obj)        (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_CALENDAR, GtkCalendarClass))
  48
  49
  50 typedef struct _GtkCalendar            GtkCalendar;
  51 typedef struct _GtkCalendarClass       GtkCalendarClass;
  52
  53 typedef struct _GtkCalendarPrivate     GtkCalendarPrivate;
  54
  55 /**
  56  * GtkCalendarDisplayOptions:
  57  * @GTK_CALENDAR_SHOW_HEADING: Specifies that the month and year should be displayed.
  58  * @GTK_CALENDAR_SHOW_DAY_NAMES: Specifies that three letter day descriptions should be present.
  59  * @GTK_CALENDAR_NO_MONTH_CHANGE: Prevents the user from switching months with the calendar.
  60  * @GTK_CALENDAR_SHOW_WEEK_NUMBERS: Displays each week numbers of the current year, down the
  61  * left side of the calendar.
  62  * @GTK_CALENDAR_WEEK_START_MONDAY: Since GTK+ 2.4, this option is deprecated and ignored by GTK+.
  63  * The information on which day the calendar week starts is derived from the locale.
  64  * @GTK_CALENDAR_SHOW_DETAILS: Just show an indicator, not the full details
  65  * text when details are provided. See gtk_calendar_set_detail_func().
  66  *
  67  * These options can be used to influence the display and behaviour of a #GtkCalendar.
  68  */
  69 typedef enum
  70 {
  71   GTK_CALENDAR_SHOW_HEADING             = 1 << 0,
  72   GTK_CALENDAR_SHOW_DAY_NAMES           = 1 << 1,
  73   GTK_CALENDAR_NO_MONTH_CHANGE          = 1 << 2,
  74   GTK_CALENDAR_SHOW_WEEK_NUMBERS        = 1 << 3,
  75   GTK_CALENDAR_WEEK_START_MONDAY        = 1 << 4,
  76   GTK_CALENDAR_SHOW_DETAILS             = 1 << 5
  77 } GtkCalendarDisplayOptions;
  78
  79 /**
  80  * GtkCalendarDetailFunc:
  81  * @calendar: a #GtkCalendar.
  82  * @year: the year for which details are needed.
  83  * @month: the month for which details are needed.
  84  * @day: the day of @month for which details are needed.
  85  * @user_data: the data passed with gtk_calendar_set_detail_func().
  86  *
  87  * This kind of functions provide Pango markup with detail information for the
  88  * specified day. Examples for such details are holidays or appointments. The
  89  * function returns %NULL when no information is available.
  90  *
  91  * Since: 2.14
  92  *
  93  * Return value: Newly allocated string with Pango markup with details
  94  * for the specified day, or %NULL.
  95  */
  96 typedef gchar* (*GtkCalendarDetailFunc) (GtkCalendar *calendar,
  97                                          guint        year,
  98                                          guint        month,
  99                                          guint        day,
 100                                          gpointer     user_data);
 101
 102 struct _GtkCalendar
 103 {
 104   GtkWidget widget;
 105
 106   GtkStyle  *GSEAL (header_style);
 107   GtkStyle  *GSEAL (label_style);
 108
 109   gint GSEAL (month);
 110   gint GSEAL (year);
 111   gint GSEAL (selected_day);
 112
 113   gint GSEAL (day_month[6][7]);
 114   gint GSEAL (day[6][7]);
 115
 116   gint GSEAL (num_marked_dates);
 117   gint GSEAL (marked_date[31]);
 118   GtkCalendarDisplayOptions  GSEAL (display_flags);
 119   GdkColor GSEAL (marked_date_color[31]);
 120
 121   GdkGC *GSEAL (gc);                    /* unused */
 122   GdkGC *GSEAL (xor_gc);                /* unused */
 123
 124   gint GSEAL (focus_row);
 125   gint GSEAL (focus_col);
 126
 127   gint GSEAL (highlight_row);
 128   gint GSEAL (highlight_col);
 129
 130   GtkCalendarPrivate *GSEAL (priv);
 131   gchar GSEAL (grow_space [32]);
 132
 133   /* Padding for future expansion */
 134   void (*_gtk_reserved1) (void);
 135   void (*_gtk_reserved2) (void);
 136   void (*_gtk_reserved3) (void);
 137   void (*_gtk_reserved4) (void);
 138 };
 139
 140 struct _GtkCalendarClass
 141 {
 142   GtkWidgetClass parent_class;
 143
 144   /* Signal handlers */
 145   void (* month_changed)                (GtkCalendar *calendar);
 146   void (* day_selected)                 (GtkCalendar *calendar);
 147   void (* day_selected_double_click)    (GtkCalendar *calendar);
 148   void (* prev_month)                   (GtkCalendar *calendar);
 149   void (* next_month)                   (GtkCalendar *calendar);
 150   void (* prev_year)                    (GtkCalendar *calendar);
 151   void (* next_year)                    (GtkCalendar *calendar);
 152
 153 };
 154
 155
 156 GType      gtk_calendar_get_type        (void) G_GNUC_CONST;
 157 GtkWidget* gtk_calendar_new             (void);
 158
 159 gboolean   gtk_calendar_select_month    (GtkCalendar *calendar,
 160                                          guint        month,
 161                                          guint        year);
 162 void       gtk_calendar_select_day      (GtkCalendar *calendar,
 163                                          guint        day);
 164
 165 gboolean   gtk_calendar_mark_day        (GtkCalendar *calendar,
 166                                          guint        day);
 167 gboolean   gtk_calendar_unmark_day      (GtkCalendar *calendar,
 168                                          guint        day);
 169 void       gtk_calendar_clear_marks     (GtkCalendar *calendar);
 170
 171
 172 void       gtk_calendar_set_display_options (GtkCalendar              *calendar,
 173                                              GtkCalendarDisplayOptions flags);
 174 GtkCalendarDisplayOptions
 175            gtk_calendar_get_display_options (GtkCalendar              *calendar);
 176 void       gtk_calendar_get_date        (GtkCalendar *calendar,
 177                                          guint       *year,
 178                                          guint       *month,
 179                                          guint       *day);
 180
 181 void       gtk_calendar_set_detail_func (GtkCalendar           *calendar,
 182                                          GtkCalendarDetailFunc  func,
 183                                          gpointer               data,
 184                                          GDestroyNotify         destroy);
 185
 186 void       gtk_calendar_set_detail_width_chars (GtkCalendar    *calendar,
 187                                                 gint            chars);
 188 void       gtk_calendar_set_detail_height_rows (GtkCalendar    *calendar,
 189                                                 gint            rows);
 190
 191 gint       gtk_calendar_get_detail_width_chars (GtkCalendar    *calendar);
 192 gint       gtk_calendar_get_detail_height_rows (GtkCalendar    *calendar);
 193
 194 G_END_DECLS
 195
 196 #endif /* __GTK_CALENDAR_H__ */