A page that shows the meeting time selector and free/busy data for

2001-09-18  JP Rosevear  <jpr@ximian.com>

	* gui/dialogs/schedule-page.*: A page that shows the meeting time
	selector and free/busy data for attendees

	* gui/dialogs/meeting-page.c: use the meeting model to track/edit
	attendees, remove table value conversion routines and simple table
	routines
	(set_attendees): take a pointer array
	(meeting_page_destroy): destroy the pointer array, save state
	(meeting_page_init): new pointer array
	(meeting_page_fill_widgets): don't null the deleted attendees
	field
	(popup_delegate_cb): array add
	(popup_delete_cb): array add
	(cleanup_attendees): iterate over the array to unref now
	(meeting_page_fill_widgets): don't null out fields, no need to add
	attendees here
	(invite_entry_changed): use e_meeting_attendee routines
	(popup_delegate_cb): ditto
	(popup_delete_cb): ditto
	(meeting_page_new): take new arg and pass it to construct
	(meeting_page_construct): take new arg, use e-meeting-model
	routines to construct table

	* gui/dialogs/task-editor.c (task_editor_init): new meeting model
	(task_editor_destroy): unref the model

	* gui/dialogs/event-editor.c (event_editor_init): make new model
	and pass it to meeting and schedule pages
	(event_editor_set_cal_client): virtual function, set meeting model
	client
	(event_editor_edit_comp): add the attendees to the model
	(event_editor_destroy): unref model

	* gui/dialogs/comp-editor.h: add virtual function

	* gui/dialogs/comp-editor.c (comp_editor_set_cal_client): make
	set_cal_client a virutal function

	* gui/e-meeting-types.h: generally useful type defines

	* gui/e-meeting-time-sel*.[hc]: Move here and use an e-table for
	the attendee list and extract display information from the new
	meeting model and attendees

	* gui/e-meeting-time-sel.etspec: spec for the table

	* gui/e-meeting-attendee.[hc]: meeting attendees for the model,
	with to/from conversions for CalComponentAttendee structure, emits
	changed signal and allows getting and setting of free busy
	periods

	* gui/e-meeting-model.[hc]: move the model out on its own

	* gui/e-itip-control.c (write_error_html): clean up warnings

svn path=/trunk/; revision=12968

1 files changed, 375 insertions, 0 deletions

diff --git a/calendar/gui/e-meeting-time-sel.h b/calendar/gui/e-meeting-time-sel.h
new file mode 100644
index 0000000000..a0a3cd7434
--- /dev/null
+++ b/calendar/gui/e-meeting-time-sel.h
@@ -0,0 +1,375 @@
+/* -*- 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 the GNU General Public License as 
+ * published by the Free Software Foundation; either version 2 of the
+ * License, or (at your option) any later version.
+ *
+ * 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.
+ *
+ * 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 */
+
+/*
+ * EMeetingTimeSelector displays a list of attendees for a meeting and a
+ * graphical summary of the times which they are free and busy, allowing the
+ * user to select an appropriate time for a meeting.
+ */
+
+/* Define this to include the debugging functions. */
+#undef E_MEETING_TIME_SELECTOR_DEBUG
+
+/* This is the width of the icon column in the attendees list. */
+#define E_MEETING_TIME_SELECTOR_ICON_COLUMN_WIDTH	24
+
+#define E_MEETING_TIME_SELECTOR_TEXT_Y_PAD		3
+#define E_MEETING_TIME_SELECTOR_TEXT_X_PAD		2
+
+
+/* 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. */
+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. */
+typedef enum
+{
+	E_MEETING_TIME_SELECTOR_POS_NONE,
+	E_MEETING_TIME_SELECTOR_POS_START,
+	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. */
+typedef enum
+{
+	E_MEETING_TIME_SELECTOR_ALL_PEOPLE_AND_RESOURCES,
+	E_MEETING_TIME_SELECTOR_ALL_PEOPLE_AND_ONE_RESOURCE,
+	E_MEETING_TIME_SELECTOR_REQUIRED_PEOPLE,
+	E_MEETING_TIME_SELECTOR_REQUIRED_PEOPLE_AND_ONE_RESOURCE
+} EMeetingTimeSelectorAutopickOption;
+
+/* An array of hour strings, "0:00" .. "23:00". */
+extern const gchar *EMeetingTimeSelectorHours[24];
+
+
+#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
+{
+	/* We subclass a GtkTable which makes it easy to add extra widgets
+	   if neccesary. */
+	GtkTable table;
+
+	/*
+	 * User Interface stuff - widgets, colors etc.
+	 */
+
+	/* This contains our keyboard accelerators, which need to be added to
+	   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. */
+	GtkWidget *attendees_vbox;
+
+	/* The etable and model */
+	EMeetingModel *model;
+	GtkWidget *etable;
+	
+	/* The canvas displaying the dates, times, and the summary
+	   'All Attendees' free/busy display. */
+	GtkWidget *display_top;
+
+	/* The canvas containing the free/busy displays of individual
+	   attendees. This is separate from display_top since it also scrolls
+	   vertically. */
+	GtkWidget *display_main;
+
+	/* This is the 'Options' button & menu. */
+	GtkWidget *options_button;
+	GtkWidget *options_menu;
+
+	/* This is the 'Autopick' button, menu & radio menu items. */
+	GtkWidget *autopick_button;
+	GtkWidget *autopick_menu;
+	GtkWidget *autopick_all_item;
+	GtkWidget *autopick_all_people_one_resource_item;
+	GtkWidget *autopick_required_people_item;
+	GtkWidget *autopick_required_people_one_resource_item;
+
+	/* The horizontal scrollbar which scrolls display_top & display_main.*/
+	GtkWidget *hscrollbar;
+
+	/* The vertical scrollbar which scrolls attendees & display_main. */
+	GtkWidget *vscrollbar;
+
+	/* The 2 GnomeDateEdit widgets for the meeting start & end times. */
+	GtkWidget *start_date_edit;
+	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;
+
+	/* Width of the hours strings (e.g. "1:00") in the current font. */
+	gint hour_widths[24];
+
+	/* Whether we are using the full, abbreviated or short date format. */
+	EMeetingTimeSelectorDateFormat date_format;
+
+	/*
+	 * Option Settings.
+	 */
+
+	/* If this is TRUE we only show hours between day_start_hour and
+	   day_end_hour, defaults to TRUE (9am-6pm). */
+	gboolean working_hours_only;
+	gint day_start_hour;
+	gint day_start_minute;
+	gint day_end_hour;
+	gint day_end_minute;
+
+	/* If TRUE, view is compressed, with one cell for every 3 hours rather
+	   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. */
+	GDate first_date_shown;
+	GDate last_date_shown;
+
+	/* This is the current selection of the meeting time. */
+	EMeetingTime meeting_start_time;
+	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(). */
+	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.*/
+	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. */
+	gint day_width;
+
+	/* These are the first and last hour of each day we display, depending
+	   on working_hours_only and zoomed_out. */
+	gint first_hour_shown;
+	gint last_hour_shown;
+
+	/* The id of the source function for auto-scroll timeouts. */
+	guint auto_scroll_timeout_id;
+
+	/* This specifies if we are dragging one of the vertical bars around
+	   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. */
+	gint last_drag_x;
+
+	/* This is used to determine the delay between scrolls. */
+	gint scroll_count;
+};
+
+
+struct _EMeetingTimeSelectorClass
+{
+	GtkTableClass parent_class;
+};
+
+
+/*
+ * 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);
+
+/* 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);
+
+/* 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_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);
+
+/* Clears all busy times for the given attendee. */
+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);
+
+
+
+/*
+ * INTERNAL ROUTINES - functions to communicate with the canvas items within
+ *		       the 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);
+
+/* 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);
+#endif /* E_MEETING_TIME_SELECTOR_DEBUG */
+
+
+#ifdef __cplusplus
+}
+#endif /* __cplusplus */
+
+#endif /* _E_MEETING_TIME_SELECTOR_H_ */