Make sheet spec page opaque
[pspp] / src / ui / gui / text-data-import-dialog.c
1 /* PSPPIRE - a graphical user interface for PSPP.
2    Copyright (C) 2008, 2009, 2010, 2011, 2012, 2013  Free Software Foundation
3
4    This program is free software: you can redistribute it and/or modify
5    it under the terms of the GNU General Public License as published by
6    the Free Software Foundation, either version 3 of the License, or
7    (at your option) any later version.
8
9    This program is distributed in the hope that it will be useful,
10    but WITHOUT ANY WARRANTY; without even the implied warranty of
11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12    GNU General Public License for more details.
13
14    You should have received a copy of the GNU General Public License
15    along with this program.  If not, see <http://www.gnu.org/licenses/>. */
16
17 #include <config.h>
18
19 #include "ui/gui/text-data-import-dialog.h"
20
21 #include <errno.h>
22 #include <fcntl.h>
23 #include <gtk-contrib/psppire-sheet.h>
24 #include <gtk/gtk.h>
25 #include <limits.h>
26 #include <stdlib.h>
27 #include <sys/stat.h>
28
29 #include "data/data-in.h"
30 #include "data/data-out.h"
31 #include "data/format-guesser.h"
32 #include "data/value-labels.h"
33 #include "language/data-io/data-parser.h"
34 #include "language/lexer/lexer.h"
35 #include "libpspp/assertion.h"
36 #include "libpspp/i18n.h"
37 #include "libpspp/line-reader.h"
38 #include "libpspp/message.h"
39 #include "ui/gui/checkbox-treeview.h"
40 #include "ui/gui/dialog-common.h"
41 #include "ui/gui/executor.h"
42 #include "ui/gui/helper.h"
43 #include "ui/gui/builder-wrapper.h"
44 #include "ui/gui/psppire-data-window.h"
45 #include "ui/gui/psppire-dialog.h"
46 #include "ui/gui/psppire-encoding-selector.h"
47 #include "ui/gui/psppire-empty-list-store.h"
48 #include "ui/gui/psppire-var-sheet.h"
49 #include "ui/gui/psppire-var-store.h"
50 #include "ui/gui/psppire-scanf.h"
51 #include "ui/syntax-gen.h"
52
53 #include "gl/error.h"
54 #include "gl/intprops.h"
55 #include "gl/xalloc.h"
56
57 #include "gettext.h"
58 #define _(msgid) gettext (msgid)
59 #define N_(msgid) msgid
60
61 struct import_assistant;
62
63 static void apply_dict (const struct dictionary *, struct string *);
64 static char *generate_syntax (const struct import_assistant *);
65
66 static void add_line_number_column (const struct import_assistant *,
67                                     GtkTreeView *);
68
69 /* Pops up the Text Data Import assistant. */
70 void
71 text_data_import_assistant (PsppireDataWindow *dw)
72 {
73   GtkWindow *parent_window = GTK_WINDOW (dw);
74   struct import_assistant *ia = init_assistant (parent_window);
75   struct sheet_spec_page *ssp ;
76
77   if (!init_file (ia, parent_window))
78     {
79       free (ia);
80       return;
81     }
82
83   ssp = ia->sheet_spec;
84   init_first_line_page (ia);
85   init_separators_page (ia);
86
87   init_formats_page (ia);
88
89   gtk_widget_show_all (GTK_WIDGET (ia->asst.assistant));
90
91   ia->asst.main_loop = g_main_loop_new (NULL, false);
92   g_main_loop_run (ia->asst.main_loop);
93   g_main_loop_unref (ia->asst.main_loop);
94
95   switch (ia->asst.response)
96     {
97     case GTK_RESPONSE_APPLY:
98       free (execute_syntax_string (dw, generate_syntax (ia)));
99       break;
100     case PSPPIRE_RESPONSE_PASTE:
101       free (paste_syntax_to_window (generate_syntax (ia)));
102       break;
103     default:
104       break;
105     }
106
107   destroy_formats_page (ia);
108   destroy_separators_page (ia);
109
110   destroy_assistant (ia);
111   destroy_file (ia);
112   free (ia);
113 }
114
115 /* Emits PSPP syntax to S that applies the dictionary attributes
116    (such as missing values and value labels) of the variables in
117    DICT.  */
118 static void
119 apply_dict (const struct dictionary *dict, struct string *s)
120 {
121   size_t var_cnt = dict_get_var_cnt (dict);
122   size_t i;
123
124   for (i = 0; i < var_cnt; i++)
125     {
126       struct variable *var = dict_get_var (dict, i);
127       const char *name = var_get_name (var);
128       enum val_type type = var_get_type (var);
129       int width = var_get_width (var);
130       enum measure measure = var_get_measure (var);
131       enum alignment alignment = var_get_alignment (var);
132       const struct fmt_spec *format = var_get_print_format (var);
133
134       if (var_has_missing_values (var))
135         {
136           const struct missing_values *mv = var_get_missing_values (var);
137           size_t j;
138
139           syntax_gen_pspp (s, "MISSING VALUES %ss (", name);
140           for (j = 0; j < mv_n_values (mv); j++)
141             {
142               if (j)
143                 ds_put_cstr (s, ", ");
144               syntax_gen_value (s, mv_get_value (mv, j), width, format);
145             }
146
147           if (mv_has_range (mv))
148             {
149               double low, high;
150               if (mv_has_value (mv))
151                 ds_put_cstr (s, ", ");
152               mv_get_range (mv, &low, &high);
153               syntax_gen_num_range (s, low, high, format);
154             }
155           ds_put_cstr (s, ").\n");
156         }
157       if (var_has_value_labels (var))
158         {
159           const struct val_labs *vls = var_get_value_labels (var);
160           const struct val_lab **labels = val_labs_sorted (vls);
161           size_t n_labels = val_labs_count (vls);
162           size_t i;
163
164           syntax_gen_pspp (s, "VALUE LABELS %ss", name);
165           for (i = 0; i < n_labels; i++)
166             {
167               const struct val_lab *vl = labels[i];
168               ds_put_cstr (s, "\n  ");
169               syntax_gen_value (s, &vl->value, width, format);
170               ds_put_byte (s, ' ');
171               syntax_gen_string (s, ss_cstr (val_lab_get_escaped_label (vl)));
172             }
173           free (labels);
174           ds_put_cstr (s, ".\n");
175         }
176       if (var_has_label (var))
177         syntax_gen_pspp (s, "VARIABLE LABELS %ss %sq.\n",
178                          name, var_get_label (var));
179       if (measure != var_default_measure (type))
180         syntax_gen_pspp (s, "VARIABLE LEVEL %ss (%ss).\n",
181                          name,
182                          (measure == MEASURE_NOMINAL ? "NOMINAL"
183                           : measure == MEASURE_ORDINAL ? "ORDINAL"
184                           : "SCALE"));
185       if (alignment != var_default_alignment (type))
186         syntax_gen_pspp (s, "VARIABLE ALIGNMENT %ss (%ss).\n",
187                          name,
188                          (alignment == ALIGN_LEFT ? "LEFT"
189                           : alignment == ALIGN_CENTRE ? "CENTER"
190                           : "RIGHT"));
191       if (var_get_display_width (var) != var_default_display_width (width))
192         syntax_gen_pspp (s, "VARIABLE WIDTH %ss (%d).\n",
193                          name, var_get_display_width (var));
194     }
195 }
196
197 /* Generates and returns PSPP syntax to execute the import
198    operation described by IA.  The caller must free the syntax
199    with free(). */
200 static char *
201 generate_syntax (const struct import_assistant *ia)
202 {
203   struct sheet_spec_page *ssp = ia->sheet_spec;
204
205   struct string s = DS_EMPTY_INITIALIZER;
206
207 #if 0
208   if (ssp->spreadsheet == NULL)
209     {
210       size_t var_cnt;
211       size_t i;
212       syntax_gen_pspp (&s,
213                        "GET DATA"
214                        "\n  /TYPE=TXT"
215                        "\n  /FILE=%sq\n",
216                        ia->file.file_name);
217       if (ia->file.encoding && strcmp (ia->file.encoding, "Auto"))
218         syntax_gen_pspp (&s, "  /ENCODING=%sq\n", ia->file.encoding);
219
220       intro_append_syntax (ia->intro, &s);
221
222       ds_put_cstr (&s,
223                    "  /ARRANGEMENT=DELIMITED\n"
224                    "  /DELCASE=LINE\n");
225       if (ia->first_line->skip_lines > 0)
226         ds_put_format (&s, "  /FIRSTCASE=%d\n", ia->first_line->skip_lines + 1);
227       ds_put_cstr (&s, "  /DELIMITERS=\"");
228       if (ds_find_byte (&ia->separators->separators, '\t') != SIZE_MAX)
229         ds_put_cstr (&s, "\\t");
230       if (ds_find_byte (&ia->separators->separators, '\\') != SIZE_MAX)
231         ds_put_cstr (&s, "\\\\");
232       for (i = 0; i < ds_length (&ia->separators->separators); i++)
233         {
234           char c = ds_at (&ia->separators->separators, i);
235           if (c == '"')
236             ds_put_cstr (&s, "\"\"");
237           else if (c != '\t' && c != '\\')
238             ds_put_byte (&s, c);
239         }
240       ds_put_cstr (&s, "\"\n");
241       if (!ds_is_empty (&ia->separators->quotes))
242         syntax_gen_pspp (&s, "  /QUALIFIER=%sq\n", ds_cstr (&ia->separators->quotes));
243       if (!ds_is_empty (&ia->separators->quotes) && ia->separators->escape)
244         ds_put_cstr (&s, "  /ESCAPE\n");
245       ds_put_cstr (&s, "  /VARIABLES=\n");
246
247       var_cnt = dict_get_var_cnt (ia->formats->dict);
248       for (i = 0; i < var_cnt; i++)
249         {
250           struct variable *var = dict_get_var (ia->formats->dict, i);
251           char format_string[FMT_STRING_LEN_MAX + 1];
252           fmt_to_string (var_get_print_format (var), format_string);
253           ds_put_format (&s, "    %s %s%s\n",
254                          var_get_name (var), format_string,
255                          i == var_cnt - 1 ? "." : "");
256         }
257
258       apply_dict (ia->formats->dict, &s);
259     }
260   else
261
262     {
263       const struct sheet_spec_page *ssp = ia->sheet_spec;
264
265       syntax_gen_pspp (&s,
266                        "GET DATA"
267                        "\n  /TYPE=%ss"
268                        "\n  /FILE=%sq"
269                        "\n  /SHEET=index %d"
270                        "\n  /READNAMES=%ss",
271                        (ssp->spreadsheet->type == SPREADSHEET_GNUMERIC) ? "GNM" : "ODS",
272                        ia->file.file_name,                       
273                        ssp->opts.sheet_index,
274                        ssp->sri.read_names ? "ON" : "OFF");
275
276
277       if ( ssp->opts.cell_range)
278         {
279           syntax_gen_pspp (&s,
280                            "\n  /CELLRANGE=RANGE %sq",
281                            ssp->opts.cell_range);
282         }
283       else
284         {
285           syntax_gen_pspp (&s,
286                            "\n  /CELLRANGE=FULL");
287         }
288
289
290       syntax_gen_pspp (&s, ".");
291     }
292
293 #endif
294   return ds_cstr (&s);
295 }
296
297
298
299 static void render_input_cell (GtkTreeViewColumn *tree_column,
300                                GtkCellRenderer *cell,
301                                GtkTreeModel *model, GtkTreeIter *iter,
302                                gpointer ia);
303
304 static gboolean on_query_input_tooltip (GtkWidget *widget, gint wx, gint wy,
305                                         gboolean keyboard_mode UNUSED,
306                                         GtkTooltip *tooltip,
307                                         struct import_assistant *);
308
309
310
311 /* Called to render one of the cells in the fields preview tree
312    view. */
313 static void
314 render_input_cell (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell,
315                    GtkTreeModel *model, GtkTreeIter *iter,
316                    gpointer ia_)
317 {
318   struct import_assistant *ia = ia_;
319   struct substring field;
320   size_t row;
321   gint column;
322
323   column = GPOINTER_TO_INT (g_object_get_data (G_OBJECT (tree_column),
324                                                "column-number"));
325   row = empty_list_store_iter_to_row (iter) + ia->first_line->skip_lines;
326   field = ia->separators->columns[column].contents[row];
327   if (field.string != NULL)
328     {
329       GValue text = {0, };
330       g_value_init (&text, G_TYPE_STRING);
331       g_value_take_string (&text, ss_xstrdup (field));
332       g_object_set_property (G_OBJECT (cell), "text", &text);
333       g_value_unset (&text);
334       g_object_set (cell, "background-set", FALSE, (void *) NULL);
335     }
336   else
337     g_object_set (cell,
338                   "text", "",
339                   "background", "red",
340                   "background-set", TRUE,
341                   (void *) NULL);
342 }
343
344 static gboolean
345 get_tooltip_location (GtkWidget *widget, gint wx, gint wy,
346                       const struct import_assistant *ia,
347                       size_t *row, size_t *column);
348
349
350 /* Called to render a tooltip on one of the cells in the fields
351    preview tree view. */
352 static gboolean
353 on_query_input_tooltip (GtkWidget *widget, gint wx, gint wy,
354                         gboolean keyboard_mode UNUSED,
355                         GtkTooltip *tooltip, struct import_assistant *ia)
356 {
357   size_t row, column;
358
359   if (!get_tooltip_location (widget, wx, wy, ia, &row, &column))
360     return FALSE;
361
362   if (ia->separators->columns[column].contents[row].string != NULL)
363     return FALSE;
364
365   gtk_tooltip_set_text (tooltip,
366                         _("This input line has too few separators "
367                           "to fill in this field."));
368   return TRUE;
369 }
370
371
372 /* Parses the contents of the field at (ROW,COLUMN) according to
373    its variable format.  If OUTPUTP is non-null, then *OUTPUTP
374    receives the formatted output for that field (which must be
375    freed with free).  If TOOLTIPP is non-null, then *TOOLTIPP
376    receives a message suitable for use in a tooltip, if one is
377    needed, or a null pointer otherwise.  Returns true if a
378    tooltip message is needed, otherwise false. */
379 static bool
380 parse_field (struct import_assistant *ia,
381              size_t row, size_t column,
382              char **outputp, char **tooltipp)
383 {
384   struct substring field;
385   union value val;
386   struct variable *var;
387   const struct fmt_spec *in;
388   struct fmt_spec out;
389   char *tooltip;
390   bool ok;
391
392   field = ia->separators->columns[column].contents[row];
393   var = dict_get_var (ia->formats->dict, column);
394   value_init (&val, var_get_width (var));
395   in = var_get_print_format (var);
396   out = fmt_for_output_from_input (in);
397   tooltip = NULL;
398   if (field.string != NULL)
399     {
400       char *error;
401
402       error = data_in (field, "UTF-8", in->type, &val, var_get_width (var),
403                        dict_get_encoding (ia->formats->dict));
404       if (error != NULL)
405         {
406           tooltip = xasprintf (_("Cannot parse field content `%.*s' as "
407                                  "format %s: %s"),
408                                (int) field.length, field.string,
409                                fmt_name (in->type), error);
410           free (error);
411         }
412     }
413   else
414     {
415       tooltip = xstrdup (_("This input line has too few separators "
416                            "to fill in this field."));
417       value_set_missing (&val, var_get_width (var));
418     }
419   if (outputp != NULL)
420     {
421       *outputp = data_out (&val, dict_get_encoding (ia->formats->dict),  &out);
422     }
423   value_destroy (&val, var_get_width (var));
424
425   ok = tooltip == NULL;
426   if (tooltipp != NULL)
427     *tooltipp = tooltip;
428   else
429     free (tooltip);
430   return ok;
431 }
432
433 /* Called to render one of the cells in the data preview tree
434    view. */
435 static void
436 render_output_cell (GtkTreeViewColumn *tree_column,
437                     GtkCellRenderer *cell,
438                     GtkTreeModel *model,
439                     GtkTreeIter *iter,
440                     gpointer ia_)
441 {
442   struct import_assistant *ia = ia_;
443   char *output;
444   GValue gvalue = { 0, };
445   bool ok;
446
447   ok = parse_field (ia,
448                     (empty_list_store_iter_to_row (iter)
449                      + ia->first_line->skip_lines),
450                     GPOINTER_TO_INT (g_object_get_data (G_OBJECT (tree_column),
451                                                         "column-number")),
452                     &output, NULL);
453
454   g_value_init (&gvalue, G_TYPE_STRING);
455   g_value_take_string (&gvalue, output);
456   g_object_set_property (G_OBJECT (cell), "text", &gvalue);
457   g_value_unset (&gvalue);
458
459   if (ok)
460     g_object_set (cell, "background-set", FALSE, (void *) NULL);
461   else
462     g_object_set (cell,
463                   "background", "red",
464                   "background-set", TRUE,
465                   (void *) NULL);
466 }
467
468 /* Called to render a tooltip for one of the cells in the data
469    preview tree view. */
470 static gboolean
471 on_query_output_tooltip (GtkWidget *widget, gint wx, gint wy,
472                          gboolean keyboard_mode UNUSED,
473                          GtkTooltip *tooltip, struct import_assistant *ia)
474 {
475   size_t row, column;
476   char *text;
477
478   if (!get_tooltip_location (widget, wx, wy, ia, &row, &column))
479     return FALSE;
480
481   if (parse_field (ia, row, column, NULL, &text))
482     return FALSE;
483
484   gtk_tooltip_set_text (tooltip, text);
485   free (text);
486   return TRUE;
487 }
488 \f
489 /* Utility functions used by multiple pages of the assistant. */
490
491 static gboolean
492 get_tooltip_location (GtkWidget *widget, gint wx, gint wy,
493                       const struct import_assistant *ia,
494                       size_t *row, size_t *column)
495 {
496   GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
497   gint bx, by;
498   GtkTreePath *path;
499   GtkTreeIter iter;
500   GtkTreeViewColumn *tree_column;
501   GtkTreeModel *tree_model;
502   bool ok;
503
504   /* Check that WIDGET is really visible on the screen before we
505      do anything else.  This is a bug fix for a sticky situation:
506      when text_data_import_assistant() returns, it frees the data
507      necessary to compose the tool tip message, but there may be
508      a tool tip under preparation at that point (even if there is
509      no visible tool tip) that will call back into us a little
510      bit later.  Perhaps the correct solution to this problem is
511      to make the data related to the tool tips part of a GObject
512      that only gets destroyed when all references are released,
513      but this solution appears to be effective too. */
514   if (!gtk_widget_get_mapped (widget))
515     return FALSE;
516
517   gtk_tree_view_convert_widget_to_bin_window_coords (tree_view,
518                                                      wx, wy, &bx, &by);
519   if (!gtk_tree_view_get_path_at_pos (tree_view, bx, by,
520                                       &path, &tree_column, NULL, NULL))
521     return FALSE;
522
523   *column = GPOINTER_TO_INT (g_object_get_data (G_OBJECT (tree_column),
524                                                 "column-number"));
525
526   tree_model = gtk_tree_view_get_model (tree_view);
527   ok = gtk_tree_model_get_iter (tree_model, &iter, path);
528   gtk_tree_path_free (path);
529   if (!ok)
530     return FALSE;
531
532   *row = empty_list_store_iter_to_row (&iter) + ia->first_line->skip_lines;
533   return TRUE;
534 }
535
536 void
537 make_tree_view (const struct import_assistant *ia,
538                 size_t first_line,
539                 GtkTreeView **tree_view)
540 {
541   GtkTreeModel *model;
542
543   *tree_view = GTK_TREE_VIEW (gtk_tree_view_new ());
544   model = GTK_TREE_MODEL (psppire_empty_list_store_new (
545                                                         ia->file.line_cnt - first_line));
546   g_object_set_data (G_OBJECT (model), "lines", ia->file.lines + first_line);
547   g_object_set_data (G_OBJECT (model), "first-line",
548                      GINT_TO_POINTER (first_line));
549   gtk_tree_view_set_model (*tree_view, model);
550   g_object_unref (model);
551
552   add_line_number_column (ia, *tree_view);
553 }
554
555 static void
556 render_line_number (GtkTreeViewColumn *tree_column,
557                     GtkCellRenderer *cell,
558                     GtkTreeModel *tree_model,
559                     GtkTreeIter *iter,
560                     gpointer data)
561 {
562   gint row = empty_list_store_iter_to_row (iter);
563   char s[INT_BUFSIZE_BOUND (int)];
564   int first_line;
565
566   first_line = GPOINTER_TO_INT (g_object_get_data (G_OBJECT (tree_model),
567                                                    "first-line"));
568   sprintf (s, "%d", first_line + row);
569   g_object_set (cell, "text", s, NULL);
570 }
571
572 static void
573 add_line_number_column (const struct import_assistant *ia,
574                         GtkTreeView *treeview)
575 {
576   GtkTreeViewColumn *column;
577
578   column = gtk_tree_view_column_new_with_attributes (
579                                                      _("Line"), ia->asst.prop_renderer, (void *) NULL);
580   gtk_tree_view_column_set_sizing (column, GTK_TREE_VIEW_COLUMN_FIXED);
581   gtk_tree_view_column_set_fixed_width (
582                                         column, get_monospace_width (treeview, ia->asst.prop_renderer, 5));
583   gtk_tree_view_column_set_resizable (column, TRUE);
584   gtk_tree_view_column_set_cell_data_func (column, ia->asst.prop_renderer,
585                                            render_line_number, NULL, NULL);
586   gtk_tree_view_append_column (treeview, column);
587 }
588
589 gint
590 get_monospace_width (GtkTreeView *treeview, GtkCellRenderer *renderer,
591                      size_t char_cnt)
592 {
593   struct string s;
594   gint width;
595
596   ds_init_empty (&s);
597   ds_put_byte_multiple (&s, '0', char_cnt);
598   ds_put_byte (&s, ' ');
599   width = get_string_width (treeview, renderer, ds_cstr (&s));
600   ds_destroy (&s);
601
602   return width;
603 }
604
605 gint
606 get_string_width (GtkTreeView *treeview, GtkCellRenderer *renderer,
607                   const char *string)
608 {
609   gint width;
610   g_object_set (G_OBJECT (renderer), "text", string, (void *) NULL);
611   gtk_cell_renderer_get_size (renderer, GTK_WIDGET (treeview),
612                               NULL, NULL, NULL, &width, NULL);
613   return width;
614 }
615
616 GtkTreeViewColumn *
617 make_data_column (struct import_assistant *ia, GtkTreeView *tree_view,
618                   bool input, gint dict_idx)
619 {
620   struct variable *var = NULL;
621   struct column *column = NULL;
622   size_t char_cnt;
623   gint content_width, header_width;
624   GtkTreeViewColumn *tree_column;
625   char *name;
626
627   if (input)
628     column = &ia->separators->columns[dict_idx];
629   else
630     var = dict_get_var (ia->formats->dict, dict_idx);
631
632   name = escape_underscores (input ? column->name : var_get_name (var));
633   char_cnt = input ? column->width : var_get_print_format (var)->w;
634   content_width = get_monospace_width (tree_view, ia->asst.fixed_renderer,
635                                        char_cnt);
636   header_width = get_string_width (tree_view, ia->asst.prop_renderer,
637                                    name);
638
639   tree_column = gtk_tree_view_column_new ();
640   g_object_set_data (G_OBJECT (tree_column), "column-number",
641                      GINT_TO_POINTER (dict_idx));
642   gtk_tree_view_column_set_title (tree_column, name);
643   gtk_tree_view_column_pack_start (tree_column, ia->asst.fixed_renderer,
644                                    FALSE);
645   gtk_tree_view_column_set_cell_data_func (
646                                            tree_column, ia->asst.fixed_renderer,
647                                            input ? render_input_cell : render_output_cell, ia, NULL);
648   gtk_tree_view_column_set_sizing (tree_column, GTK_TREE_VIEW_COLUMN_FIXED);
649   gtk_tree_view_column_set_fixed_width (tree_column, MAX (content_width,
650                                                           header_width));
651
652   free (name);
653
654   return tree_column;
655 }
656
657 GtkTreeView *
658 create_data_tree_view (bool input, GtkContainer *parent,
659                        struct import_assistant *ia)
660 {
661   GtkTreeView *tree_view;
662   gint i;
663
664   make_tree_view (ia, ia->first_line->skip_lines, &tree_view);
665   gtk_tree_selection_set_mode (gtk_tree_view_get_selection (tree_view),
666                                GTK_SELECTION_NONE);
667
668   for (i = 0; i < ia->separators->column_cnt; i++)
669     gtk_tree_view_append_column (tree_view,
670                                  make_data_column (ia, tree_view, input, i));
671
672   g_object_set (G_OBJECT (tree_view), "has-tooltip", TRUE, (void *) NULL);
673   g_signal_connect (tree_view, "query-tooltip",
674                     G_CALLBACK (input ? on_query_input_tooltip
675                                 : on_query_output_tooltip), ia);
676   gtk_tree_view_set_fixed_height_mode (tree_view, true);
677
678   gtk_container_add (parent, GTK_WIDGET (tree_view));
679   gtk_widget_show (GTK_WIDGET (tree_view));
680
681   return tree_view;
682 }
683
684 /* Increments the "watch cursor" level, setting the cursor for
685    the assistant window to a watch face to indicate to the user
686    that the ongoing operation may take some time. */
687 void
688 push_watch_cursor (struct import_assistant *ia)
689 {
690   if (++ia->asst.watch_cursor == 1)
691     {
692       GtkWidget *widget = GTK_WIDGET (ia->asst.assistant);
693       GdkDisplay *display = gtk_widget_get_display (widget);
694       GdkCursor *cursor = gdk_cursor_new_for_display (display, GDK_WATCH);
695       gdk_window_set_cursor (widget->window, cursor);
696       gdk_cursor_unref (cursor);
697       gdk_display_flush (display);
698     }
699 }
700
701 /* Decrements the "watch cursor" level.  If the level reaches
702    zero, the cursor is reset to its default shape. */
703 void
704 pop_watch_cursor (struct import_assistant *ia)
705 {
706   if (--ia->asst.watch_cursor == 0)
707     {
708       GtkWidget *widget = GTK_WIDGET (ia->asst.assistant);
709       gdk_window_set_cursor (widget->window, NULL);
710     }
711 }