aboutsummaryrefslogtreecommitdiffstats
path: root/addressbook/backend/ebook/e-card.h
blob: 667fbdc89c38d724c4e9431f91ac211da3088ca6 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
/*
 * Authors:
 *   Chris Lahey <clahey@helixcode.com>
 *   Arturo Espinosa
 *   Nat Friedman (nat@helixcode.com)
 *
 * Copyright (C) 2000 Helix Code, Inc.
 * Copyright (C) 1999 The Free Software Foundation
 */

#ifndef __E_CARD_H__
#define __E_CARD_H__

#include <time.h>
#include <gtk/gtkobject.h>
#include <stdio.h>
#include <addressbook/backend/ebook/e-card-types.h>
#include <e-util/e-list.h>

#define E_TYPE_CARD            (e_card_get_type ())
#define E_CARD(obj)            (GTK_CHECK_CAST ((obj), E_TYPE_CARD, ECard))
#define E_CARD_CLASS(klass)    (GTK_CHECK_CLASS_CAST ((klass), E_TYPE_CARD, ECardClass))
#define E_IS_CARD(obj)         (GTK_CHECK_TYPE ((obj), E_TYPE_CARD))
#define E_IS_CARD_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), E_TYPE_CARD))

typedef struct _ECard ECard;
typedef struct _ECardClass ECardClass;

struct _ECard {
    GtkObject object;
    char *id;

    char            *file_as;       /* The File As field.               */
    char            *fname;         /* The full name.                   */
    ECardName       *name;          /* The structured name.             */
    EList       *address;   /* Delivery addresses (ECardDeliveryAddress *) */
    EList       *address_label; /* Delivery address labels
                     * (ECardAddrLabel *)               */

    EList       *phone;         /* Phone numbers (ECardPhone *)     */
    EList       *email;         /* Email addresses (char *)         */
    char            *url;           /* The person's web page.           */

    ECardDate       *bday;          /* The person's birthday.           */

    char            *note;


    char            *org;           /* The person's organization.       */
    char            *org_unit;      /* The person's organization unit.  */
    char            *office;        /* The person's office.             */
    char            *role;          /* The person's role w/in his org   */
    char            *title;         /* The person's title w/in his org  */

    char            *manager;
    char            *assistant;

    char            *nickname;      /* The person's nickname            */
    
    char            *spouse;        /* The person's spouse.             */
    ECardDate       *anniversary;   /* The person's anniversary.        */

    char            *mailer;        /* Mailer                           */

    char            *fburl;         /* Free Busy URL                    */

    gint             timezone;      /* number of minutes from UTC as an int */

    EList       *categories;    /* Categories.                      */

    EList       *arbitrary;     /* Arbitrary fields.                */

    guint32         wants_html : 1; /* Wants html mail. */
    guint32         wants_html_set : 1; /* Wants html mail. */

#if 0
    ECardPhoto      *logo;          /* This person's org's logo.        */

    ECardPhoto      *photo;     /* A photo of the person.           */
    
    ECard           *agent;         /* A person who sereves as this
                       guy's agent/secretary/etc.       */
    

    char            *categories;    /* A list of the categories to which
                       this card belongs.               */
    
    ECardSound      *sound;
    
    ECardKey        *key;           /* The person's public key.         */
    ECardTimeZone   *timezn;        /* The person's time zone.          */
    ECardGeoPos     *geopos;        /* The person's long/lat.           */

    ECardRev        *rev;           /* The time this card was last
                       modified.                        */

    EList        xtension;
#endif
};

struct _ECardClass {
    GtkObjectClass parent_class;
    GHashTable    *attribute_jump_table;
};


/* Simple functions */
ECard                *e_card_new                          (char                       *vcard);
const char           *e_card_get_id                       (ECard                      *card);
void                  e_card_set_id                       (ECard                      *card,
                               const char                 *character);

char                 *e_card_get_vcard                    (ECard                      *card);
char                 *e_card_list_get_vcard               (GList                      *list);
ECard                *e_card_duplicate                    (ECard                      *card);

/* ECardPhone manipulation */
ECardPhone           *e_card_phone_new                    (void);
ECardPhone           *e_card_phone_copy                   (const ECardPhone           *phone);
void                  e_card_phone_free                   (ECardPhone                 *phone);

/* ECardDeliveryAddress manipulation */
ECardDeliveryAddress *e_card_delivery_address_new         (void);
ECardDeliveryAddress *e_card_delivery_address_copy        (const ECardDeliveryAddress *addr);
void                  e_card_delivery_address_free        (ECardDeliveryAddress       *addr);
gboolean              e_card_delivery_address_is_empty    (const ECardDeliveryAddress *addr);
char                 *e_card_delivery_address_to_string   (const ECardDeliveryAddress *addr);
ECardDeliveryAddress *e_card_delivery_address_from_label  (const ECardAddrLabel       *label);
ECardAddrLabel       *e_card_delivery_address_to_label    (const ECardDeliveryAddress *addr);

/* ECardAddrLabel manipulation */
ECardAddrLabel       *e_card_address_label_new            (void);
ECardAddrLabel       *e_card_address_label_copy           (const ECardAddrLabel       *addr);
void                  e_card_address_label_free           (ECardAddrLabel             *addr);

/* ECardName manipulation */
ECardName            *e_card_name_new                     (void);
ECardName            *e_card_name_copy                    (const ECardName            *name);
void                  e_card_name_free                    (ECardName                  *name);
char                 *e_card_name_to_string               (const ECardName            *name);
ECardName            *e_card_name_from_string             (const char                 *full_name);
gboolean              e_card_name_match_string            (const ECardName            *name,
                               const gchar                *str);

/* ECardArbitrary manipulation */
ECardArbitrary       *e_card_arbitrary_new                (void);
ECardArbitrary       *e_card_arbitrary_copy               (const ECardArbitrary       *arbitrary);
void                  e_card_arbitrary_free               (ECardArbitrary             *arbitrary);

/* ECard email manipulation */
gboolean              e_card_email_match_string           (const ECard                *card,
                               const gchar                *str);

/* Specialized functionality */
GList                *e_card_load_cards_from_file         (const char                 *filename);
GList                *e_card_load_cards_from_string       (const char                 *str);
void                  e_card_free_empty_lists             (ECard                      *card);

enum _ECardDisposition {
    E_CARD_DISPOSITION_AS_ATTACHMENT,
    E_CARD_DISPOSITION_AS_TO,
};
typedef enum _ECardDisposition ECardDisposition;
void                  e_card_send                         (ECard                      *card,
                               ECardDisposition            disposition);
void                  e_card_list_send                    (GList                      *cards,
                               ECardDisposition            disposition);

/* Standard Gtk function */
GtkType               e_card_get_type                     (void);

#endif /* ! __E_CARD_H__ */