diff options
Diffstat (limited to 'calendar/gui/e-meeting-time-sel.h')
| -rw-r--r-- | calendar/gui/e-meeting-time-sel.h | 418 |
1 files changed, 233 insertions, 185 deletions
diff --git a/calendar/gui/e-meeting-time-sel.h b/calendar/gui/e-meeting-time-sel.h index 30c1abefa7..109c36a296 100644 --- a/calendar/gui/e-meeting-time-sel.h +++ b/calendar/gui/e-meeting-time-sel.h @@ -1,41 +1,35 @@ -/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */ - -/* - * Author : - * Damon Chaplin <damon@gtk.org> - * - * Copyright 1999, Ximian, Inc. - * - * This program is free software; you can redistribute it and/or - * modify it under the terms of version 2 of the GNU General Public - * License as published by the Free Software Foundation. +/* + * This program is free software; you can redistribute it and/or + * modify it under the terms of the GNU Lesser General Public + * License as published by the Free Software Foundation; either + * version 2 of the License, or (at your option) version 3. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU General Public License for more details. + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public + * License along with the program; if not, see <http://www.gnu.org/licenses/> + * + * + * Authors: + * Damon Chaplin <damon@gtk.org> + * + * Copyright (C) 1999-2008 Novell, Inc. (www.novell.com) * - * You should have received a copy of the GNU General Public License - * along with this program; if not, write to the Free Software - * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 - * USA */ -#ifndef _E_MEETING_TIME_SELECTOR_H_ -#define _E_MEETING_TIME_SELECTOR_H_ - -#include <glib.h> -#include <gtk/gtkaccelgroup.h> -#include <gtk/gtktable.h> -#include <gtk/gtkwidget.h> -#include <libgnomeui/gnome-canvas.h> -#include <gal/e-text/e-text.h> -#include <gal/e-table/e-table-model.h> -#include <gal/e-table/e-table.h> -#include "e-meeting-model.h" - -#ifdef __cplusplus -extern "C" { -#endif /* __cplusplus */ + +#ifndef E_MEETING_TIME_SELECTOR_H +#define E_MEETING_TIME_SELECTOR_H + +#include <gtk/gtk.h> +#include <libgnomecanvas/libgnomecanvas.h> + +#include <e-util/e-util.h> + +#include "e-meeting-store.h" +#include "e-meeting-list-view.h" /* * EMeetingTimeSelector displays a list of attendees for a meeting and a @@ -43,6 +37,25 @@ extern "C" { * user to select an appropriate time for a meeting. */ +/* Standard GObject macros */ +#define E_TYPE_MEETING_TIME_SELECTOR \ + (e_meeting_time_selector_get_type ()) +#define E_MEETING_TIME_SELECTOR(obj) \ + (G_TYPE_CHECK_INSTANCE_CAST \ + ((obj), E_TYPE_MEETING_TIME_SELECTOR, EMeetingTimeSelector)) +#define E_MEETING_TIME_SELECTOR_CLASS(cls) \ + (G_TYPE_CHECK_CLASS_CAST \ + ((cls), E_TYPE_MEETING_TIME_SELECTOR, EMeetingTimeSelectorClass)) +#define E_IS_MEETING_TIME_SELECTOR(obj) \ + (G_TYPE_CHECK_INSTANCE_TYPE \ + ((obj), E_TYPE_MEETING_TIME_SELECTOR)) +#define E_IS_MEETING_TIME_SELECTOR_CLASS(cls) \ + (G_TYPE_CHECK_CLASS_TYPE \ + ((cls), E_TYPE_MEETING_TIME_SELECTOR)) +#define E_MEETING_TIME_SELECTOR_GET_CLASS(obj) \ + (G_TYPE_INSTANCE_GET_CLASS \ + ((obj), E_TYPE_MEETING_TIME_SELECTOR)) + /* Define this to include the debugging functions. */ #undef E_MEETING_TIME_SELECTOR_DEBUG @@ -52,22 +65,22 @@ extern "C" { #define E_MEETING_TIME_SELECTOR_TEXT_Y_PAD 3 #define E_MEETING_TIME_SELECTOR_TEXT_X_PAD 2 +G_BEGIN_DECLS /* This is used to specify the format used when displaying the dates. - The full format is like 'Sunday, September 12, 1999'. The abbreviated format - is like 'Sun 12/9/99'. The short format is like '12/9/99'. The actual - format used is determined in e_meeting_time_selector_style_set(), once we - know the font being used. */ + * The abbreviated format is like 'Sun 12/9/99'. + * The short format is like '12/9/99'. + * The actual format used is determined in e_meeting_time_selector_style_set (), + * once we know the font being used. + */ typedef enum { - E_MEETING_TIME_SELECTOR_DATE_FULL, E_MEETING_TIME_SELECTOR_DATE_ABBREVIATED_DAY, E_MEETING_TIME_SELECTOR_DATE_SHORT } EMeetingTimeSelectorDateFormat; - /* This is used to specify a position regarding the vertical bars around the - current meeting time, so we know which one is being dragged. */ + * current meeting time, so we know which one is being dragged. */ typedef enum { E_MEETING_TIME_SELECTOR_POS_NONE, @@ -75,9 +88,8 @@ typedef enum E_MEETING_TIME_SELECTOR_POS_END } EMeetingTimeSelectorPosition; - /* This is used to specify the autopick option, which determines how we choose - the previous/next appropriate meeting time. */ + * the previous/next appropriate meeting time. */ typedef enum { E_MEETING_TIME_SELECTOR_ALL_PEOPLE_AND_RESOURCES, @@ -91,54 +103,57 @@ extern const gchar *EMeetingTimeSelectorHours[24]; /* An array of hour strings for 12 hour time, "12:00am" .. "11:00pm". */ extern const gchar *EMeetingTimeSelectorHours12[24]; +typedef struct _EMeetingTimeSelector EMeetingTimeSelector; +typedef struct _EMeetingTimeSelectorClass EMeetingTimeSelectorClass; +typedef struct _EMeetingTimeSelectorPrivate EMeetingTimeSelectorPrivate; -#define E_MEETING_TIME_SELECTOR(obj) GTK_CHECK_CAST (obj, e_meeting_time_selector_get_type (), EMeetingTimeSelector) -#define E_MEETING_TIME_SELECTOR_CLASS(klass) GTK_CHECK_CLASS_CAST (klass, e_meeting_time_selector_get_type (), EMeetingTimeSelectorClass) -#define IS_E_MEETING_TIME_SELECTOR(obj) GTK_CHECK_TYPE (obj, e_meeting_time_selector_get_type ()) - - -typedef struct _EMeetingTimeSelector EMeetingTimeSelector; -typedef struct _EMeetingTimeSelectorClass EMeetingTimeSelectorClass; - -struct _EMeetingTimeSelector -{ +struct _EMeetingTimeSelector { /* We subclass a GtkTable which makes it easy to add extra widgets - if neccesary. */ + * if neccesary. */ GtkTable table; + EMeetingTimeSelectorPrivate *priv; + /* * User Interface stuff - widgets, colors etc. */ /* This contains our keyboard accelerators, which need to be added to - the toplevel window. */ + * the toplevel window. */ GtkAccelGroup *accel_group; /* The vbox in the top-left corner, containing the 'All Attendees' - title bar packed at the end. Extra widgets can be added here - with PACK_START if necessary. */ + * title bar packed at the end. Extra widgets can be added here + * with PACK_START if necessary. */ GtkWidget *attendees_vbox; GtkWidget *attendees_vbox_spacer; - + /* The etable and model */ - EMeetingModel *model; - GtkWidget *etable; - + EMeetingStore *model; + EMeetingListView *list_view; + /* The canvas displaying the dates, times, and the summary - 'All Attendees' free/busy display. */ + * 'All Attendees' free/busy display. */ GtkWidget *display_top; + GnomeCanvasItem *item_top; /* The canvas containing the free/busy displays of individual - attendees. This is separate from display_top since it also scrolls - vertically. */ + * attendees. This is separate from display_top since it also scrolls + * vertically. */ GtkWidget *display_main; + GnomeCanvasItem *item_main; + + /* The 'Add attendees from addressbook' button */ + GtkWidget *add_attendees_button; /* This is the 'Options' button & menu. */ GtkWidget *options_button; GtkWidget *options_menu; /* This is the 'Autopick' button, menu & radio menu items. */ + GtkWidget *autopick_down_button; GtkWidget *autopick_button; + GtkWidget *autopick_up_button; GtkWidget *autopick_menu; GtkWidget *autopick_all_item; GtkWidget *autopick_all_people_one_resource_item; @@ -156,22 +171,17 @@ struct _EMeetingTimeSelector GtkWidget *end_date_edit; /* Colors. */ - GdkColorContext *color_context; GdkColor bg_color; GdkColor all_attendees_bg_color; GdkColor meeting_time_bg_color; - GdkColor stipple_bg_color; GdkColor attendee_list_bg_color; GdkColor grid_color; GdkColor grid_shadow_color; GdkColor grid_unused_color; GdkColor busy_colors[E_MEETING_FREE_BUSY_LAST]; - /* The stipple used for attendees with no data. */ - GdkPixmap *stipple; - - /* GC for drawing the color key. */ - GdkGC *color_key_gc; + /* The pattern used for attendees with no data. */ + cairo_pattern_t *no_info_pattern; /* Width of the hours strings (e.g. "1:00") in the current font. */ gint hour_widths[24]; @@ -185,9 +195,9 @@ struct _EMeetingTimeSelector /* True if we are selecting all day events */ gboolean all_day; - + /* If this is TRUE we only show hours between day_start_hour and - day_end_hour, defaults to TRUE (9am-6pm). */ + * day_end_hour, defaults to TRUE (9am-6pm). */ gboolean working_hours_only; gint day_start_hour; gint day_start_minute; @@ -195,16 +205,15 @@ struct _EMeetingTimeSelector gint day_end_minute; /* If TRUE, view is compressed, with one cell for every 3 hours rather - than every hour. Defaults to FALSE. */ + * than every hour. Defaults to FALSE. */ gboolean zoomed_out; - /* * Internal Data. */ /* These are the first & last dates shown in the current scroll area. - We show E_MEETING_TIME_SELECTOR_DAYS_SHOWN days at a time. */ + * We show E_MEETING_TIME_SELECTOR_DAYS_SHOWN days at a time. */ GDate first_date_shown; GDate last_date_shown; @@ -213,25 +222,25 @@ struct _EMeetingTimeSelector EMeetingTime meeting_end_time; /* These are the x pixel coordinates in the entire scroll region of - the start and end times. Set to meeting_positions_valid to FALSE to - invalidate. They will then be recomputed when needed. Always access - with e_meeting_time_selector_get_meeting_time_positions(). */ + * the start and end times. Set to meeting_positions_valid to FALSE to + * invalidate. They will then be recomputed when needed. Always access + * with e_meeting_time_selector_get_meeting_time_positions (). */ gint meeting_positions_valid; gint meeting_positions_in_scroll_area; gint meeting_start_x; gint meeting_end_x; /* These are the width and height of the cells, including the grid - lines which are displayed on the right and top or bottom of cells.*/ + * lines which are displayed on the right and top or bottom of cells.*/ gint row_height; gint col_width; /* This is the width of a day in the display, which depends on - col_width, working_hours_only and zoomed_out. */ + * col_width, working_hours_only and zoomed_out. */ gint day_width; /* These are the first and last hour of each day we display, depending - on working_hours_only and zoomed_out. */ + * on working_hours_only and zoomed_out. */ gint first_hour_shown; gint last_hour_shown; @@ -239,105 +248,130 @@ struct _EMeetingTimeSelector guint auto_scroll_timeout_id; /* This specifies if we are dragging one of the vertical bars around - the meeting time. */ + * the meeting time. */ EMeetingTimeSelectorPosition dragging_position; /* The last x coordinate of the mouse, relative to either the left or - right edge of the canvas. Used in the auto_scroll_timeout function - to determine which way to scroll and how fast. */ + * right edge of the canvas. Used in the auto_scroll_timeout function + * to determine which way to scroll and how fast. */ gint last_drag_x; /* This is used to determine the delay between scrolls. */ gint scroll_count; -}; + /* The notification function id for Free/Busy refreshes */ + gboolean fb_refresh_not; -struct _EMeetingTimeSelectorClass -{ + GdkCursorType last_cursor_set; + + guint style_change_idle_id; +}; + +struct _EMeetingTimeSelectorClass { GtkTableClass parent_class; void (* changed) (EMeetingTimeSelector *mts); }; - /* * PUBLIC INTERFACE - note that this interface will probably change, when I * know where the data is coming from. This is mainly just for testing for now. */ -GtkType e_meeting_time_selector_get_type (void); -GtkWidget* e_meeting_time_selector_new (EMeetingModel *emm); -void e_meeting_time_selector_construct (EMeetingTimeSelector * mts, EMeetingModel *emm); +GType e_meeting_time_selector_get_type (void); +GtkWidget * e_meeting_time_selector_new (EMeetingStore *ems); +void e_meeting_time_selector_construct + (EMeetingTimeSelector *mts, + EMeetingStore *ems); +gboolean e_meeting_time_selector_get_use_24_hour_format + (EMeetingTimeSelector *mts); +void e_meeting_time_selector_set_use_24_hour_format + (EMeetingTimeSelector *mts, + gboolean use_24_hour_format); /* This returns the currently selected meeting time. - Note that months are 1-12 and days are 1-31. The start time is guaranteed to - be before or equal to the end time. You may want to check if they are equal - if that if it is a problem. */ -void e_meeting_time_selector_get_meeting_time (EMeetingTimeSelector *mts, - gint *start_year, - gint *start_month, - gint *start_day, - gint *start_hour, - gint *start_minute, - gint *end_year, - gint *end_month, - gint *end_day, - gint *end_hour, - gint *end_minute); + * Note that months are 1-12 and days are 1-31. The start time is guaranteed to + * be before or equal to the end time. You may want to check if they are equal + * if that if it is a problem. */ +void e_meeting_time_selector_get_meeting_time + (EMeetingTimeSelector *mts, + gint *start_year, + gint *start_month, + gint *start_day, + gint *start_hour, + gint *start_minute, + gint *end_year, + gint *end_month, + gint *end_day, + gint *end_hour, + gint *end_minute); /* This sets the meeting time, returning TRUE if it is valid. */ -gboolean e_meeting_time_selector_set_meeting_time (EMeetingTimeSelector *mts, - gint start_year, - gint start_month, - gint start_day, - gint start_hour, - gint start_minute, - gint end_year, - gint end_month, - gint end_day, - gint end_hour, - gint end_minute); - -void e_meeting_time_selector_set_all_day (EMeetingTimeSelector *mts, - gboolean all_day); -void e_meeting_time_selector_set_working_hours_only (EMeetingTimeSelector *mts, - gboolean working_hours_only); -void e_meeting_time_selector_set_working_hours (EMeetingTimeSelector *mts, - gint day_start_hour, - gint day_start_minute, - gint day_end_hour, - gint day_end_minute); - -void e_meeting_time_selector_set_zoomed_out (EMeetingTimeSelector *mts, - gboolean zoomed_out); - -EMeetingTimeSelectorAutopickOption e_meeting_time_selector_get_autopick_option (EMeetingTimeSelector *mts); -void e_meeting_time_selector_set_autopick_option (EMeetingTimeSelector *mts, - EMeetingTimeSelectorAutopickOption autopick_option); - -void e_meeting_time_selector_attendee_set_send_meeting_to (EMeetingTimeSelector *mts, - gint row, - gboolean send_meeting_to); +gboolean e_meeting_time_selector_set_meeting_time + (EMeetingTimeSelector *mts, + gint start_year, + gint start_month, + gint start_day, + gint start_hour, + gint start_minute, + gint end_year, + gint end_month, + gint end_day, + gint end_hour, + gint end_minute); + +void e_meeting_time_selector_set_all_day + (EMeetingTimeSelector *mts, + gboolean all_day); +void e_meeting_time_selector_set_working_hours_only + (EMeetingTimeSelector *mts, + gboolean working_hours_only); +void e_meeting_time_selector_set_working_hours + (EMeetingTimeSelector *mts, + gint day_start_hour, + gint day_start_minute, + gint day_end_hour, + gint day_end_minute); + +void e_meeting_time_selector_set_zoomed_out + (EMeetingTimeSelector *mts, + gboolean zoomed_out); + +EMeetingTimeSelectorAutopickOption + e_meeting_time_selector_get_autopick_option + (EMeetingTimeSelector *mts); +void e_meeting_time_selector_set_autopick_option + (EMeetingTimeSelector *mts, + EMeetingTimeSelectorAutopickOption autopick_option); + +void e_meeting_time_selector_attendee_set_send_meeting_to + (EMeetingTimeSelector *mts, + gint row, + gboolean send_meeting_to); + +void e_meeting_time_selector_set_read_only + (EMeetingTimeSelector *mts, + gboolean read_only); /* Clears all busy times for the given attendee. */ -void e_meeting_time_selector_attendee_clear_busy_periods (EMeetingTimeSelector *mts, - gint row); +void e_meeting_time_selector_attendee_clear_busy_periods + (EMeetingTimeSelector *mts, + gint row); /* Adds one busy time for the given attendee. */ -gboolean e_meeting_time_selector_attendee_add_busy_period (EMeetingTimeSelector *mts, - gint row, - gint start_year, - gint start_month, - gint start_day, - gint start_hour, - gint start_minute, - gint end_year, - gint end_month, - gint end_day, - gint end_hour, - gint end_minute, - EMeetingFreeBusyType busy_type); - - +gboolean e_meeting_time_selector_attendee_add_busy_period + (EMeetingTimeSelector *mts, + gint row, + gint start_year, + gint start_month, + gint start_day, + gint start_hour, + gint start_minute, + gint end_year, + gint end_month, + gint end_day, + gint end_hour, + gint end_minute, + EMeetingFreeBusyType busy_type); /* * INTERNAL ROUTINES - functions to communicate with the canvas items within @@ -345,40 +379,54 @@ gboolean e_meeting_time_selector_attendee_add_busy_period (EMeetingTimeSelector */ /* This returns the x pixel coordinates of the meeting start and end times, - in the entire canvas scroll area. If it returns FALSE, then the meeting - time isn't in the current scroll area (which shouldn't really happen). */ -gboolean e_meeting_time_selector_get_meeting_time_positions (EMeetingTimeSelector *mts, - gint *start_x, - gint *end_x); - -void e_meeting_time_selector_drag_meeting_time (EMeetingTimeSelector *mts, - gint x); - -void e_meeting_time_selector_remove_timeout (EMeetingTimeSelector *mts); - -void e_meeting_time_selector_fix_time_overflows (EMeetingTime*mtstime); - -void e_meeting_time_selector_calculate_day_and_position (EMeetingTimeSelector *mts, - gint x, - GDate *date, - gint *day_position); -void e_meeting_time_selector_convert_day_position_to_hours_and_mins (EMeetingTimeSelector *mts, gint day_position, guint8 *hours, guint8 *minutes); -void e_meeting_time_selector_calculate_time (EMeetingTimeSelector *mts, - gint x, - EMeetingTime*time); -gint e_meeting_time_selector_calculate_time_position (EMeetingTimeSelector *mts, - EMeetingTime *mtstime); + * in the entire canvas scroll area. If it returns FALSE, then the meeting + * time isn't in the current scroll area (which shouldn't really happen). */ +gboolean e_meeting_time_selector_get_meeting_time_positions + (EMeetingTimeSelector *mts, + gint *start_x, + gint *end_x); + +void e_meeting_time_selector_drag_meeting_time + (EMeetingTimeSelector *mts, + gint x); + +void e_meeting_time_selector_remove_timeout + (EMeetingTimeSelector *mts); + +void e_meeting_time_selector_fix_time_overflows + (EMeetingTime *mtstime); + +void e_meeting_time_selector_calculate_day_and_position + (EMeetingTimeSelector *mts, + gint x, + GDate *date, + gint *day_position); +void e_meeting_time_selector_convert_day_position_to_hours_and_mins + (EMeetingTimeSelector *mts, + gint day_position, + guint8 *hours, + guint8 *minutes); +void e_meeting_time_selector_calculate_time + (EMeetingTimeSelector *mts, + gint x, + EMeetingTime *time); +gint e_meeting_time_selector_calculate_time_position + (EMeetingTimeSelector *mts, + EMeetingTime *mtstime); +void e_meeting_time_selector_refresh_free_busy + (EMeetingTimeSelector *mts, + gint row, + gboolean all); /* Debugging function to dump information on all attendees. */ #ifdef E_MEETING_TIME_SELECTOR_DEBUG -void e_meeting_time_selector_dump (EMeetingTimeSelector *mts); -gchar* e_meeting_time_selector_dump_time (EMeetingTime*mtstime); -gchar* e_meeting_time_selector_dump_date (GDate *date); +void e_meeting_time_selector_dump (EMeetingTimeSelector *mts); +gchar * e_meeting_time_selector_dump_time + (EMeetingTime *mtstime); +gchar * e_meeting_time_selector_dump_date + (GDate *date); #endif /* E_MEETING_TIME_SELECTOR_DEBUG */ +G_END_DECLS -#ifdef __cplusplus -} -#endif /* __cplusplus */ - -#endif /* _E_MEETING_TIME_SELECTOR_H_ */ +#endif /* E_MEETING_TIME_SELECTOR_H */ |