Files
evolution/shell/evolution-storage.h
Dan Winship 86b700d089 Support for delayed filling-in of storages/folders.
* Evolution-Storage.idl (StorageListener): add
	notifyHasSubfolders, to announce that a folder has currently-
	unknown subfolders.
	(Storage): add asyncOpenFolder, to request that previously-
	announced subfolders be filled in.

	* evolution-storage.c (impl_Storage_async_open_folder): emit
	OPEN_FOLDER.
	(evolution_storage_has_subfolders): Implement by calling
	notifyHasSubfolders on all of its listeners.

	* evolution-storage-listener.c
	(impl_GNOME_Evolution_StorageListener_notifyHasSubfolders): emit
	HAS_SUBFOLDERS.

	* e-corba-storage.c (impl_StorageListener_notifyHasSubfolders):
	Implement by calling e_storage_has_subfolders.
	(async_open_folder): Implement by calling asyncOpenFolder on the
	CORBA storage.

	* e-storage.c (EStoragePrivate, init, destroy): Keep a list of
	pseudofolders representing un-filled-in subtrees.
	(impl_async_open_folder): No-op default implementation
	(e_storage_async_open_folder): New function to request that
	un-filled-in subtrees be filled in.
	(e_storage_new_folder): If the new folder's parent has an
	"un-filled-in children" pseudofolder, remove it.
	(e_storage_has_subfolders): New function to note that a folder has
	unknown children. If the folder previously was marked as having
	real children, remove them, and emit CLOSE_FOLDER to reset it back
	to an a "unknown subfolders" state.

	* e-storage-set.c (make_full_path): Make this deal with path being
	"/", since that case gets used from storage_close_folder_cb
	sometimes.
	(storage_close_folder_cb): Proxy EStorage's CLOSE_FOLDER signal.
	(storage_set_view_folder_opened): Handle EStorageSetView's
	FOLDER_OPENED signal by calling e_storage_async_open_folder.

	* e-storage-set-view.c (etree_fill_in_children): If the given node
	is its parent's first child, emit FOLDER_OPENED for the parent.
	(close_folder_cb): Handler for EStorageSet's CLOSE_FOLDER signal.
	Ask the model to close that node.
	(e_storage_set_view_construct): Set the default expanded state for
	the tree to FALSE rather than TRUE, to prevent unwanted expansion
	of delayed nodes. (This only affects the very first time the tree
	is displayed anyway: after that its state is loaded off disk.)

	* e-shell.c (e_shell_construct): Register the "noselect" type with
	the folder type registry, so icon lookups on placeholder folders
	will work.

svn path=/trunk/; revision=16169
2002-03-14 22:22:35 +00:00

154 lines
6.0 KiB
C
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/* -*- Mode: C; indent-tabs-mode: t; c-basic-offset: 8; tab-width: 8 -*- */
/* evolution-storage.h
*
* Copyright (C) 2000 Ximian, Inc.
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of version 2 of the GNU General Public
* License as published by the Free Software Foundation.
*
* 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.
*
* Author: Ettore Perazzoli
*/
#ifndef __EVOLUTION_STORAGE_H__
#define __EVOLUTION_STORAGE_H__
#include <glib.h>
#include <bonobo/bonobo-object.h>
#include "Evolution.h"
#ifdef __cplusplus
extern "C" {
#pragma }
#endif /* __cplusplus */
#define EVOLUTION_TYPE_STORAGE (evolution_storage_get_type ())
#define EVOLUTION_STORAGE(obj) (GTK_CHECK_CAST ((obj), EVOLUTION_TYPE_STORAGE, EvolutionStorage))
#define EVOLUTION_STORAGE_CLASS(klass) (GTK_CHECK_CLASS_CAST ((klass), EVOLUTION_TYPE_STORAGE, EvolutionStorageClass))
#define EVOLUTION_IS_STORAGE(obj) (GTK_CHECK_TYPE ((obj), EVOLUTION_TYPE_STORAGE))
#define EVOLUTION_IS_STORAGE_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((obj), EVOLUTION_TYPE_STORAGE))
typedef struct _EvolutionStorage EvolutionStorage;
typedef struct _EvolutionStoragePrivate EvolutionStoragePrivate;
typedef struct _EvolutionStorageClass EvolutionStorageClass;
enum _EvolutionStorageResult {
EVOLUTION_STORAGE_OK,
/* Generic errors */
EVOLUTION_STORAGE_ERROR_GENERIC,
EVOLUTION_STORAGE_ERROR_CORBA,
EVOLUTION_STORAGE_ERROR_INVALIDPARAMETER,
/* Registration errors */
EVOLUTION_STORAGE_ERROR_ALREADYREGISTERED,
EVOLUTION_STORAGE_ERROR_NOTREGISTERED,
EVOLUTION_STORAGE_ERROR_NOREGISTRY,
EVOLUTION_STORAGE_ERROR_EXISTS,
EVOLUTION_STORAGE_ERROR_NOTFOUND,
/* Folder creation/deletion errors */
EVOLUTION_STORAGE_ERROR_UNSUPPORTED_OPERATION,
EVOLUTION_STORAGE_ERROR_UNSUPPORTED_TYPE,
EVOLUTION_STORAGE_ERROR_INVALID_URI,
EVOLUTION_STORAGE_ERROR_ALREADY_EXISTS,
EVOLUTION_STORAGE_ERROR_DOES_NOT_EXIST,
EVOLUTION_STORAGE_ERROR_PERMISSION_DENIED,
EVOLUTION_STORAGE_ERROR_NO_SPACE,
EVOLUTION_STORAGE_ERROR_NOT_EMPTY
};
typedef enum _EvolutionStorageResult EvolutionStorageResult;
struct _EvolutionStorage {
BonoboObject parent;
EvolutionStoragePrivate *priv;
};
struct _EvolutionStorageClass {
BonoboObjectClass parent_class;
/* signals */
void (*create_folder) (EvolutionStorage *storage,
const Bonobo_Listener listener,
const char *path,
const char *type,
const char *description,
const char *parent_physical_uri);
void (*remove_folder) (EvolutionStorage *storage,
const Bonobo_Listener listener,
const char *path,
const char *physical_uri);
void (*xfer_folder) (EvolutionStorage *storage,
const Bonobo_Listener listener,
const char *source_path,
const char *destination_path,
gboolean remove_source);
void (*open_folder) (EvolutionStorage *storage,
const char *path);
void (*update_folder) (EvolutionStorage *storage,
const char *path,
int unread_count);
};
POA_GNOME_Evolution_Storage__epv *evolution_storage_get_epv (void);
GtkType evolution_storage_get_type (void);
void evolution_storage_construct (EvolutionStorage *storage,
GNOME_Evolution_Storage corba_object,
const char *name);
EvolutionStorage *evolution_storage_new (const char *name);
void evolution_storage_rename (EvolutionStorage *storage,
const char *new_name);
EvolutionStorageResult evolution_storage_register (EvolutionStorage *storage,
GNOME_Evolution_StorageRegistry corba_registry);
EvolutionStorageResult evolution_storage_register_on_shell (EvolutionStorage *evolution_storage,
GNOME_Evolution_Shell corba_shell);
EvolutionStorageResult evolution_storage_deregister_on_shell (EvolutionStorage *storage,
GNOME_Evolution_Shell corba_shell);
EvolutionStorageResult evolution_storage_new_folder (EvolutionStorage *evolution_storage,
const char *path,
const char *display_name,
const char *type,
const char *physical_uri,
const char *description,
int unread_count);
EvolutionStorageResult evolution_storage_update_folder (EvolutionStorage *evolution_storage,
const char *path,
int unread_count);
EvolutionStorageResult evolution_storage_update_folder_by_uri (EvolutionStorage *evolution_storage,
const char *physical_uri,
int unread_count);
EvolutionStorageResult evolution_storage_removed_folder (EvolutionStorage *evolution_storage,
const char *path);
gboolean evolution_storage_folder_exists (EvolutionStorage *evolution_storage,
const char *path);
EvolutionStorageResult evolution_storage_has_subfolders (EvolutionStorage *evolution_storage,
const char *path,
const char *message);
#ifdef __cplusplus
}
#endif /* __cplusplus */
#endif /* __EVOLUTION_STORAGE_H__ */