aboutsummaryrefslogtreecommitdiffstats
path: root/shell/Evolution-ShellComponent.idl
blob: 9441b73b795d54f82772a4b89432fc19374e54f7 (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
174
175
176
177
178
179
180
181
182
/* -*- Mode: IDL; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
/*
 * Interface for the Evolution components.
 *
 * Authors:
 *   Ettore Perazzoli <ettore@ximian.com>
 *
 * Copyright (C) 2000, 2001, 2002 Ximian, Inc.
 */

#include <Bonobo.h>

module GNOME {
module Evolution {
    interface Shell;

    /* URI schemas, e.g. mailto:.  */
    typedef string URISchema;
    typedef sequence<URISchema> URISchemaList;

    /* A type of item that the component can create when asked by the user,
       e.g. a mail message or an appointment.  */
    struct UserCreatableItemType {
        string id;
        string description;
        string menuDescription;
        string tooltip;
        char menuShortcut;
        Icon icon;

        // This specifies the folder type for which this user creatable
        // type is a default type.
        string folderType;
    };
    typedef sequence<UserCreatableItemType> UserCreatableItemTypeList;

    /* Definition for a folder type.  */
    struct FolderType {
        string name;
        string iconName;

        string displayName;
        string description;

        boolean userCreatable;

        sequence<string> acceptedDndTypes;
        sequence<string> exportedDndTypes;

        UserCreatableItemTypeList userCreatableItemTypes;
    };
    typedef sequence<FolderType> FolderTypeList;

    interface ShellComponentListener;

    interface ShellComponent : Bonobo::Unknown {
        exception AlreadyOwned {};
        exception Busy {};
        exception InternalError {};
        exception NotFound {};
        exception NotOwned {};
        exception OldOwnerHasDied {};
        exception UnsupportedSchema {};
        exception UnsupportedType {};
        exception AlreadyPopulated {};
        exception NotPopulated {};

        /* List of folders that the component supports.  */
        readonly attribute FolderTypeList supportedTypes;

        /* Custom URI schemas that the component supports.
           (e.g. mailto, see ::handleExternalURI).  */
        readonly attribute URISchemaList externalUriSchemas ;

        /* List of the item that the user can create (see
           ::userCreateNewItem).  */
        readonly attribute UserCreatableItemTypeList userCreatableItemTypes;

        /* This method is invoked after the components is activated by
           the shell to notify the component that the shell is
           alive.  */
        void setOwner (in Shell shell, in string evolution_homedir)
            raises (AlreadyOwned, OldOwnerHasDied);

        /* This is invoked when the shell releases the component.  */
        void unsetOwner ()
            raises (NotOwned);

        /* Notify the component of whether the shell is currently
         * running in interactive mode or not.  (I.e. basically,
         * whether there are any Evolution windows on the screen.)  */
        void interactive (in boolean now_interactive);

        /* Send debugging output to the file specified.  */
        void debug (in string log_path);

        /* Create a view for the specified @physical URI.  */
        Bonobo::Control createView (in string physical_uri,
                        in string type,
                        in string view_info)
            raises (NotFound, UnsupportedType, InternalError);

        /* Handle a registered external URI scheme (eg. mailto:).  */
        void handleExternalURI (in string external_uri)
            raises (NotFound, UnsupportedSchema, InternalError);

        /* Folder operations:  */

        /* 1. Create a folder.  */
        void createFolderAsync (in ShellComponentListener listener,
                    in string physical_uri,
                    in string type)
            raises (Busy);

        /* 2. Remove a folder.  */
        void removeFolderAsync (in ShellComponentListener listener,
                    in string physical_uri,
                    in string type)
            raises (Busy);

        /* 3. Copy/move a folder.  */
        void xferFolderAsync (in ShellComponentListener listener,
                      in string source_physical_uri,
                      in string destination_physical_uri,
                      in string type,
                      in boolean remove_source)
            raises (Busy);

        /* Ask the component to populate the UIC with the
           folder-specific menu items of the folder at the specified
           @physical_uri.  */
        void populateFolderContextMenu (in Bonobo::UIContainer uih,
                        in string physical_uri,
                        in string type)
            raises (AlreadyPopulated);

        /* After you are done, you have to remove the items.  This is
           because of BonoboUI sucking and not allowing the shell to
           remove the items itself.  */
        void unpopulateFolderContextMenu (in Bonobo::UIContainer uih,
                          in string physical_uri,
                          in string type)
            raises (NotPopulated);

        /* Make the component create a new item of the specify @id in
           the folder specified by @parent_folder_physical_uri.  This
           is supposed to pop up a dialog (say, the Addressbook
           editor) when necessary.  */
        void userCreateNewItem (in string id,
                    in string parent_folder_physical_uri,
                    in string parent_folder_type)
            raises (UnsupportedType);

        /* Make the component start a Send/Receive operation.  If
           @show_dialog is true, display a progress dialog for the
           operation as well.  */
        void sendReceive (in boolean show_dialog);

        /* Request the component to quit.  The component should report
           through the listener (through OK or CANCEL) whether the
           shell can quit safely.  (This is meant to be used for
           confirmations before quitting.)  */
        oneway void requestQuit (in ShellComponentListener listener);
    };

    interface ShellComponentListener {
        enum Result {
            OK,
            CANCEL,
            UNSUPPORTED_OPERATION,
            UNSUPPORTED_TYPE,
            EXISTS,
            INVALID_URI,
            PERMISSION_DENIED,
            HAS_SUBFOLDERS,
            NO_SPACE
        };

        void notifyResult (in Result result);
    };
};
};