aboutsummaryrefslogtreecommitdiffstats
path: root/doc/devel/importer/tmpl/evolution-importer.sgml
blob: 1c7736a37fce4fa7e142fe986c0cb8a51a106a13 (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
<!-- ##### SECTION Title ##### -->
EvolutionImporter

<!-- ##### SECTION Short_Description ##### -->
A #BonoboObject that implements the GNOME/Evolution/Importer interface.

<!-- ##### SECTION Long_Description ##### -->
<para>
A #BonoboObject wrapper around the GNOME/Evolution/Importer interface, providing error checking and reference counting, hiding the CORBA internals from the user and providing a simple way to create a GNOME_Evolution_Importer object.
</para>

<!-- ##### SECTION See_Also ##### -->
<para>

</para>

<!-- ##### MACRO EVOLUTION_IMPORTER ##### -->
<para>
Casts a #GtkObject into an #EvolutionImporter.
</para>

@obj: A #GtkObject.


<!-- ##### USER_FUNCTION EvolutionImporterSupportFormatFn ##### -->
<para>
The type of function that is called when the importer wishes to find out if the importing component can support the file given in @filename.
</para>

@importer: The #EvolutionImporter.
@filename: The filename of the file to check.
@closure: The data passed into evolution_importer_new ().
@Returns: A #gboolean. TRUE if the importing component can import the file, FALSE otherwise.


<!-- ##### USER_FUNCTION EvolutionImporterLoadFileFn ##### -->
<para>
The type of function that is called when the importer wishes the importing component to load the file given in @filename, and initialise itself.
</para>

@importer: The #EvolutionImporter.
@filename: The filename of the file to load.
@folderpath: 
@closure: The data passed into evolution_importer_new ().
@Returns: A #gboolean. TRUE if the load and initialisation was successful, FALSE otherwise.


<!-- ##### USER_FUNCTION EvolutionImporterProcessItemFn ##### -->
<para>
The type of function that is called when the importer wants the importing component to process the next item (or items) in a file.
</para>

@importer: The #EvolutionImporter
@listener: A GNOME_Evolution_Importer_Listener CORBA object.
@closure: The data passed into evolution_importer_new ().
@ev: A #CORBA_Environment for returning any CORBA exceptions.


<!-- ##### USER_FUNCTION EvolutionImporterGetErrorFn ##### -->
<para>
The type of function that is called when the importer wants to get a string version of an error. Not all importing components support this function.
</para>

@importer: The #EvolutionImporter.
@closure: The data passed to evolution_importer_new ().
@Returns: A string representation of the error, or NULL if there was no error, or the importing component does not support the getError method.


<!-- ##### ENUM EvolutionImporterResult ##### -->
<para>

</para>

@EVOLUTION_IMPORTER_OK: 
@EVOLUTION_IMPORTER_UNSUPPORTED_OPERATION: 
@EVOLUTION_IMPORTER_INTERRUPTED: 
@EVOLUTION_IMPORTER_BUSY: 
@EVOLUTION_IMPORTER_NOT_READY: 
@EVOLUTION_IMPORTER_UNKNOWN_DATA: 
@EVOLUTION_IMPORTER_BAD_DATA: 
@EVOLUTION_IMPORTER_BAD_FILE: 
@EVOLUTION_IMPORTER_UNKNOWN_ERROR: 

<!-- ##### FUNCTION evolution_importer_new ##### -->
<para>

</para>

@support_format_fn: 
@load_file_fn: 
@process_item_fn: 
@get_error_fn: 
@closure: 
@Returns: