/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
/*
* Author :
* Damon Chaplin <damon@ximian.com>
*
* Copyright 1999, Helix Code, Inc.
* 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_DAY_VIEW_H_
#define _E_DAY_VIEW_H_
#include <time.h>
#include <gtk/gtktable.h>
#include <libgnomeui/gnome-canvas.h>
#include "gnome-cal.h"
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
/*
* EDayView - displays the Day & Work-Week views of the calendar.
*/
/* The maximum number of days shown. We use the week view for anything more
than about 9 days. */
#define E_DAY_VIEW_MAX_DAYS 10
/* This is used as a special code to signify a long event instead of the day
of a normal event. */
#define E_DAY_VIEW_LONG_EVENT E_DAY_VIEW_MAX_DAYS
/* The maximum number of columns of appointments within a day. */
#define E_DAY_VIEW_MAX_COLUMNS 6
/* The width of the gap between appointments. This should be at least
E_DAY_VIEW_BAR_WIDTH, since in the top canvas we use this space to draw
the triangle to represent continuing events. */
#define E_DAY_VIEW_GAP_WIDTH 7
/* The width of the bars down the left of each column and appointment.
This includes the borders on each side of it. */
#define E_DAY_VIEW_BAR_WIDTH 7
/* The height of the horizontal bar above & beneath the selected event.
This includes the borders on the top and bottom. */
#define E_DAY_VIEW_BAR_HEIGHT 6
/* The size of the reminder & recurrence icons, and padding around them. */
#define E_DAY_VIEW_ICON_WIDTH 16
#define E_DAY_VIEW_ICON_HEIGHT 16
#define E_DAY_VIEW_ICON_X_PAD 0
#define E_DAY_VIEW_ICON_Y_PAD 0
/* The size of the border around the event. */
#define E_DAY_VIEW_EVENT_BORDER_WIDTH 1
#define E_DAY_VIEW_EVENT_BORDER_HEIGHT 1
/* The padding on each side of the event text. */
#define E_DAY_VIEW_EVENT_X_PAD 2
#define E_DAY_VIEW_EVENT_Y_PAD 1
/* The padding on each side of the event text for events in the top canvas. */
#define E_DAY_VIEW_LONG_EVENT_X_PAD 2
#define E_DAY_VIEW_LONG_EVENT_Y_PAD 2
/* The size of the border around the long events in the top canvas. */
#define E_DAY_VIEW_LONG_EVENT_BORDER_WIDTH 1
#define E_DAY_VIEW_LONG_EVENT_BORDER_HEIGHT 1
/* The space between the time and the icon/text in the top canvas. */
#define E_DAY_VIEW_LONG_EVENT_TIME_X_PAD 2
/* The gap between rows in the top canvas. */
#define E_DAY_VIEW_TOP_CANVAS_Y_GAP 2
/* These are used to get/set the working days in the week. The bit-flags are
combined together. The bits must be from 0 (Sun) to 6 (Sat) to match the
day values used by localtime etc. */
typedef enum
{
E_DAY_VIEW_SUNDAY = 1 << 0,
E_DAY_VIEW_MONDAY = 1 << 1,
E_DAY_VIEW_TUESDAY = 1 << 2,
E_DAY_VIEW_WEDNESDAY = 1 << 3,
E_DAY_VIEW_THURSDAY = 1 << 4,
E_DAY_VIEW_FRIDAY = 1 << 5,
E_DAY_VIEW_SATURDAY = 1 << 6
} EDayViewDays;
/* These are used to specify the type of an appointment. They match those
used in EMeetingTimeSelector. */
typedef enum
{
E_DAY_VIEW_BUSY_TENTATIVE = 0,
E_DAY_VIEW_BUSY_OUT_OF_OFFICE = 1,
E_DAY_VIEW_BUSY_BUSY = 2,
E_DAY_VIEW_BUSY_LAST = 3
} EDayViewBusyType;
/* This is used to specify the format used when displaying the dates.
The full format is like 'Thursday 12 September'. The abbreviated format is
like 'Thu 12 Sep'. The no weekday format is like '12 Sep'. The short format
is like '12'. The actual format used is determined in
e_day_view_recalc_cell_sizes(), once we know the font being used. */
typedef enum
{
E_DAY_VIEW_DATE_FULL,
E_DAY_VIEW_DATE_ABBREVIATED,
E_DAY_VIEW_DATE_NO_WEEKDAY,
E_DAY_VIEW_DATE_SHORT
} EDayViewDateFormat;
/* These index our colors array. */
typedef enum
{
E_DAY_VIEW_COLOR_BG_WORKING,
E_DAY_VIEW_COLOR_BG_NOT_WORKING,
E_DAY_VIEW_COLOR_BG_SELECTED,
E_DAY_VIEW_COLOR_BG_GRID,
E_DAY_VIEW_COLOR_BG_TOP_CANVAS,
E_DAY_VIEW_COLOR_BG_TOP_CANVAS_SELECTED,
E_DAY_VIEW_COLOR_BG_TOP_CANVAS_GRID,
E_DAY_VIEW_COLOR_EVENT_VBAR,
E_DAY_VIEW_COLOR_EVENT_BACKGROUND,
E_DAY_VIEW_COLOR_EVENT_BORDER,
E_DAY_VIEW_COLOR_LONG_EVENT_BACKGROUND,
E_DAY_VIEW_COLOR_LONG_EVENT_BORDER,
E_DAY_VIEW_COLOR_LAST
} EDayViewColors;
/* These specify which part of the selection we are dragging, if any. */
typedef enum
{
E_DAY_VIEW_DRAG_START,
E_DAY_VIEW_DRAG_END
} EDayViewDragPosition;
/* Specifies the position of the mouse. */
typedef enum
{
E_DAY_VIEW_POS_OUTSIDE,
E_DAY_VIEW_POS_NONE,
E_DAY_VIEW_POS_EVENT,
E_DAY_VIEW_POS_LEFT_EDGE,
E_DAY_VIEW_POS_RIGHT_EDGE,
E_DAY_VIEW_POS_TOP_EDGE,
E_DAY_VIEW_POS_BOTTOM_EDGE
} EDayViewPosition;
typedef struct _EDayViewEvent EDayViewEvent;
struct _EDayViewEvent {
CalComponent *comp;
/* These are the times of this specific occurrence of the event. */
time_t start;
time_t end;
/* For events in the main canvas, this contains the start column.
For long events in the top canvas, this is its row. */
guint8 start_row_or_col;
/* For events in the main canvas, this is the number of columns that
it covers. For long events this is set to 1 if the event is shown.
For both types of events this is set to 0 if the event is not shown,
i.e. it couldn't fit into the display. Currently long events are
always shown as we just increase the height of the top canvas. */
guint8 num_columns;
/* These are minute offsets from the first time shown in the view.
They range from 0 to 24 * 60. Currently the main canvas always
starts at 12am and the code to handle starting at other times
isn't finished. */
guint16 start_minute;
guint16 end_minute;
/* This is the EText item containing the event summary. */
GnomeCanvasItem *canvas_item;
};
#define E_DAY_VIEW(obj) GTK_CHECK_CAST (obj, e_day_view_get_type (), EDayView)
#define E_DAY_VIEW_CLASS(klass) GTK_CHECK_CLASS_CAST (klass, e_day_view_get_type (), EDayViewClass)
#define E_IS_DAY_VIEW(obj) GTK_CHECK_TYPE (obj, e_day_view_get_type ())
typedef struct _EDayView EDayView;
typedef struct _EDayViewClass EDayViewClass;
struct _EDayView
{
GtkTable table;
/* The top canvas where the dates and long appointments are shown. */
GtkWidget *top_canvas;
GnomeCanvasItem *top_canvas_item;
/* The main canvas where the rest of the appointments are shown. */
GtkWidget *main_canvas;
GnomeCanvasItem *main_canvas_item;
/* The canvas displaying the times of the day. */
GtkWidget *time_canvas;
GnomeCanvasItem *time_canvas_item;
GtkWidget *vscrollbar;
/* The calendar we are associated with. */
GnomeCalendar *calendar;
/* Calendar client object we are monitoring */
CalClient *client;
/* S-expression for query and the query object */
char *sexp;
CalQuery *query;
/* The start and end of the days shown. */
time_t lower;
time_t upper;
/* Whether we are showing the work-week view. */
gboolean work_week_view;
/* The number of days we are showing. Usually 1 or 5, but can be up
to E_DAY_VIEW_MAX_DAYS, e.g. when the user selects a range of
days in the date navigator. */
gint days_shown;
/* The start of each day & an extra element to hold the last time. */
time_t day_starts[E_DAY_VIEW_MAX_DAYS + 1];
/* An array of EDayViewEvent elements for the top view and each day. */
GArray *long_events;
GArray *events[E_DAY_VIEW_MAX_DAYS];
/* These are set to FALSE whenever an event in the corresponding array
is changed. Any function that needs the events sorted calls
e_day_view_ensure_events_sorted(). */
gboolean long_events_sorted;
gboolean events_sorted[E_DAY_VIEW_MAX_DAYS];
/* This is TRUE if we need to relayout the events before drawing. */
gboolean long_events_need_layout;
gboolean need_layout[E_DAY_VIEW_MAX_DAYS];
/* This is TRUE if we need to reshape the canvas items, but a full
layout is not necessary. */
gboolean long_events_need_reshape;
gboolean need_reshape[E_DAY_VIEW_MAX_DAYS];
/* The number of minutes per row. 5, 10, 15, 30 or 60. */
gint mins_per_row;
/* The number of rows needed, depending on the times shown and the
minutes per row. */
gint rows;
/* The height of each row. */
gint row_height;
/* The number of rows in the top display. */
gint rows_in_top_display;
/* The height of each row in the top canvas. */
gint top_row_height;
/* The first and last times shown in the display. The last time isn't
included in the range. Default is 0:00-24:00 */
gint first_hour_shown;
gint first_minute_shown;
gint last_hour_shown;
gint last_minute_shown;
/* Bitwise combination of working days. Defaults to Mon-Fri. */
EDayViewDays working_days;
/* The start and end of the work day, rounded to the nearest row. */
gint work_day_start_hour;
gint work_day_start_minute;
gint work_day_end_hour;
gint work_day_end_minute;
/* Whether we use 12-hour of 24-hour format. */
gboolean use_24_hour_format;
/* Whether we use show event end times in the main canvas. */
gboolean show_event_end_times;
/* The first day of the week, 0 (Monday) to 6 (Sunday). */
gint week_start_day;
/* This is set to TRUE when the widget is created, so it scrolls to
the start of the working day when first shown. */
gboolean scroll_to_work_day;
/* This is the width & offset of each of the day columns in the
display. */
gint day_widths[E_DAY_VIEW_MAX_DAYS];
gint day_offsets[E_DAY_VIEW_MAX_DAYS + 1];
/* An array holding the number of columns in each row, in each day.
Note that there are a maximum of 12 * 24 rows (when a row is 5 mins)
but we don't always have that many rows. */
guint8 cols_per_row[E_DAY_VIEW_MAX_DAYS][12 * 24];
/* Sizes of the various time strings. */
gint small_hour_widths[24];
gint max_small_hour_width;
gint max_minute_width;
gint colon_width;
gint digit_width; /* Size of '0' character. */
/* This specifies how we are displaying the dates at the top. */
EDayViewDateFormat date_format;
/* These are the longest month & weekday names in the current font.
Months are 0 to 11. Weekdays are 0 (Sun) to 6 (Sat). */
gint longest_month_name;
gint longest_abbreviated_month_name;
gint longest_weekday_name;
gint longest_abbreviated_weekday_name;
/* The large font used to display the hours. I don't think we need a
fontset since we only display numbers. */
GdkFont *large_font;
/* The GC used for painting in different colors. */
GdkGC *main_gc;
/* The icons. */
GdkPixmap *reminder_icon;
GdkBitmap *reminder_mask;
GdkPixmap *recurrence_icon;
GdkBitmap *recurrence_mask;
/* Colors for drawing. */
GdkColor colors[E_DAY_VIEW_COLOR_LAST];
/* The normal & resizing cursors. */
GdkCursor *normal_cursor;
GdkCursor *move_cursor;
GdkCursor *resize_width_cursor;
GdkCursor *resize_height_cursor;
/* This remembers the last cursor set on the window. */
GdkCursor *last_cursor_set_in_top_canvas;
GdkCursor *last_cursor_set_in_main_canvas;
/*
* Editing, Selection & Dragging data
*/
/* The horizontal bars to resize events in the main canvas. */
GnomeCanvasItem *main_canvas_top_resize_bar_item;
GnomeCanvasItem *main_canvas_bottom_resize_bar_item;
/* The event currently being edited. The day is -1 if no event is
being edited, or E_DAY_VIEW_LONG_EVENT if a long event is edited. */
gint editing_event_day;
gint editing_event_num;
/* This is a GnomeCanvasRect which is placed around an item while it
is being resized, so we can raise it above all other EText items. */
GnomeCanvasItem *resize_long_event_rect_item;
GnomeCanvasItem *resize_rect_item;
GnomeCanvasItem *resize_bar_item;
/* The event for which a popup menu is being displayed, as above. */
gint popup_event_day;
gint popup_event_num;
/* The currently selected region. If selection_start_day is -1 there is
no current selection. If start_row or end_row is -1 then the
selection is in the top canvas. */
gint selection_start_day;
gint selection_end_day;
gint selection_start_row;
gint selection_end_row;
/* This is TRUE if the selection is currently being dragged using the
mouse. */
gboolean selection_is_being_dragged;
/* This specifies which end of the selection is being dragged. */
EDayViewDragPosition selection_drag_pos;
/* This is TRUE if the selection is in the top canvas only (i.e. if the
last motion event was in the top canvas). */
gboolean selection_in_top_canvas;
/* The last mouse position, relative to the main canvas window.
Used when auto-scrolling to update the selection. */
gint last_mouse_x;
gint last_mouse_y;
/* Auto-scroll info for when selecting an area or dragging an item. */
gint auto_scroll_timeout_id;
gint auto_scroll_delay;
gboolean auto_scroll_up;
/* These are used for the resize bars. */
gint resize_bars_event_day;
gint resize_bars_event_num;
/* These are used when resizing events. */
gint resize_event_day;
gint resize_event_num;
EDayViewPosition resize_drag_pos;
gint resize_start_row;
gint resize_end_row;
/* This is the event the mouse button was pressed on. If the button
is released we start editing it, but if the mouse is dragged we set
this to -1. */
gint pressed_event_day;
gint pressed_event_num;
/* These are used when dragging events. If drag_event_day is not -1 we
know that we are dragging one of the EDayView events around. */
gint drag_event_day;
gint drag_event_num;
/* The last mouse position when dragging, in the entire canvas. */
gint drag_event_x;
gint drag_event_y;
/* The offset of the mouse from the top of the event, in rows.
In the top canvas this is the offset from the left, in days. */
gint drag_event_offset;
/* The last day & row dragged to, so we know when we need to update
the dragged event's position. */
gint drag_last_day;
gint drag_last_row;
/* This is a GnomeCanvasRect which is placed around an item while it
is being resized, so we can raise it above all other EText items. */
GnomeCanvasItem *drag_long_event_rect_item;
GnomeCanvasItem *drag_long_event_item;
GnomeCanvasItem *drag_rect_item;
GnomeCanvasItem *drag_bar_item;
GnomeCanvasItem *drag_item;
/* "am" and "pm" in the current locale, and their widths. */
gchar *am_string;
gchar *pm_string;
gint am_string_width;
gint pm_string_width;
};
struct _EDayViewClass
{
GtkTableClass parent_class;
};
GtkType e_day_view_get_type (void);
GtkWidget* e_day_view_new (void);
void e_day_view_set_calendar (EDayView *day_view,
GnomeCalendar *calendar);
void e_day_view_set_cal_client (EDayView *day_view,
CalClient *client);
void e_day_view_set_query (EDayView *day_view,
const char *sexp);
/* This sets the selected time range. The EDayView will show the day or week
corresponding to the start time. If the start_time & end_time are not equal
and are both visible in the view, then the selection is set to those times,
otherwise it is set to 1 hour from the start of the working day. */
void e_day_view_set_selected_time_range (EDayView *day_view,
time_t start_time,
time_t end_time);
/* Returns the selected time range. */
void e_day_view_get_selected_time_range (EDayView *day_view,
time_t *start_time,
time_t *end_time);
/* Whether we are displaying a work-week, in which case the display always
starts on the first day of the working week. */
gboolean e_day_view_get_work_week_view (EDayView *day_view);
void e_day_view_set_work_week_view (EDayView *day_view,
gboolean work_week_view);
/* The number of days shown in the EDayView, from 1 to 7. This is normally
either 1 or 5 (for the Work-Week view). */
gint e_day_view_get_days_shown (EDayView *day_view);
void e_day_view_set_days_shown (EDayView *day_view,
gint days_shown);
/* This specifies how many minutes are represented by one row in the display.
It can be 60, 30, 15, 10 or 5. The default is 30. */
gint e_day_view_get_mins_per_row (EDayView *day_view);
void e_day_view_set_mins_per_row (EDayView *day_view,
gint mins_per_row);
/* This specifies the working days in the week. The value is a bitwise
combination of day flags. Defaults to Mon-Fri. */
EDayViewDays e_day_view_get_working_days (EDayView *day_view);
void e_day_view_set_working_days (EDayView *day_view,
EDayViewDays days);
/* The start and end time of the working day. This only affects the background
colors. */
void e_day_view_get_working_day (EDayView *day_view,
gint *start_hour,
gint *start_minute,
gint *end_hour,
gint *end_minute);
void e_day_view_set_working_day (EDayView *day_view,
gint start_hour,
gint start_minute,
gint end_hour,
gint end_minute);
/* Whether we use 12-hour or 24-hour format. */
gboolean e_day_view_get_24_hour_format (EDayView *day_view);
void e_day_view_set_24_hour_format (EDayView *day_view,
gboolean use_24_hour);
/* Whether we display event end times in the main canvas. */
gboolean e_day_view_get_show_event_end_times (EDayView *day_view);
void e_day_view_set_show_event_end_times (EDayView *day_view,
gboolean show);
/* The first day of the week, 0 (Monday) to 6 (Sunday). */
gint e_day_view_get_week_start_day (EDayView *day_view);
void e_day_view_set_week_start_day (EDayView *day_view,
gint week_start_day);
/*
* Internal functions called by the associated canvas items.
*/
void e_day_view_check_layout (EDayView *day_view);
gint e_day_view_convert_time_to_row (EDayView *day_view,
gint hour,
gint minute);
gint e_day_view_convert_time_to_position (EDayView *day_view,
gint hour,
gint minute);
gboolean e_day_view_get_event_position (EDayView *day_view,
gint day,
gint event_num,
gint *item_x,
gint *item_y,
gint *item_w,
gint *item_h);
gboolean e_day_view_get_long_event_position (EDayView *day_view,
gint event_num,
gint *start_day,
gint *end_day,
gint *item_x,
gint *item_y,
gint *item_w,
gint *item_h);
void e_day_view_start_selection (EDayView *day_view,
gint day,
gint row);
void e_day_view_update_selection (EDayView *day_view,
gint day,
gint row);
void e_day_view_finish_selection (EDayView *day_view);
void e_day_view_check_auto_scroll (EDayView *day_view,
gint event_x,
gint event_y);
void e_day_view_stop_auto_scroll (EDayView *day_view);
void e_day_view_convert_time_to_display (EDayView *day_view,
gint hour,
gint *display_hour,
gchar **suffix,
gint *suffix_width);
gint e_day_view_get_time_string_width (EDayView *day_view);
gint e_day_view_event_sort_func (const void *arg1,
const void *arg2);
#ifdef __cplusplus
}
#endif /* __cplusplus */
#endif /* _E_DAY_VIEW_H_ */
