path: root/shell/Evolution-ShellComponent.idl

/* -*- Mode: IDL; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
/*
 * Interface for the Evolution components.
 *
 * Authors:
 *   Ettore Perazzoli <ettore@helixcode.com>
 *
 * Copyright (C) 2000 Helix Code, Inc.
 */

#include <Bonobo.h>

module Evolution {
    interface Shell;

    struct FolderType {
        string name;
        string icon_name;
    };

    typedef sequence<FolderType> FolderTypeList;

    interface ShellComponentListener;

    interface ShellComponent : Bonobo::Unknown {
        readonly attribute FolderTypeList supported_types;

        /* FIXME: Can we use an attribute here?  */
        exception AlreadyOwned {};

        void set_owner (in Shell shell, in string evolution_homedir)
            raises (AlreadyOwned);

        exception NotOwned {};

        void unset_owner ()
            raises (NotOwned);

        /* FIXME: We might want more exceptions here.  */
        exception NotFound {};
        exception UnsupportedType {};
        exception InternalError {};

        Bonobo::Control create_view (in string physical_uri,
                         in string type)
            raises (NotFound, UnsupportedType, InternalError);

        exception Busy {};

        void async_create_folder (in ShellComponentListener listener,
                      in string physical_uri,
                      in string type)
            raises (Busy);
        void async_remove_folder (in ShellComponentListener listener,
                      in string physical_uri)
            raises (Busy);

        void populate_folder_context_menu (in Bonobo::UIContainer uih,
                           in string physical_uri,
                           in string type);
    };

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

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