Files
evolution/widgets/text/e-entry.h
Jon Trowbridge 0e3e3e9914 Added. Allows you to attach an ECompletion to an EEntry, and have that
2001-02-19  Jon Trowbridge  <trow@ximian.com>

        * gal/e-text/e-entry.c (e_entry_enable_completion_full): Added.
        Allows you to attach an ECompletion to an EEntry, and have that
        ECompletion be used for (obviously enough) completions.

        * gal/e-text/e-completion-view.h, gal/e-text/e-completion-view.c:
        Added.  ECompletionView is a widget for displaying the results of
        a completion request in a format that is appropriate for a
        drop-down window.

        * gal/e-text/e-completion.h, gal/e-text/e-completion.c: Added.
        ECompletion is a "pure virtual base class" for completion-type
        operations.  It is implemented so that completions can be either
        synchronous or asynchronous.

        * gal/e-text/e-text.c: Lots of changes to accomodate the
        ETextModel changes.  First of all, we render embedded text objects
        as being underlined.  We also cause the model to emit the
        appropriate object activation signal when an embedded object is
        double-clicked.  Also, all of the code that moves the cursor in
        response to user input has been removed.  Instead, the EText now
        listens for "reposition" events from the underlying model, and
        bases all cursor motions on those.
        (get_bounds_item_relative): Fixed bug in the handling of
        differently-anchored text.  Being differently-anchored is not a
        crime or a perversion --- it is an alternative lifestyle that we
        have to respect.

        * gal/e-text/e-text-model-uri.h, gal/e-text/e-text-model-uri.c: A
        sample ETextModel that converts URIs into embedded objects that
        get opened in the browser when you double-click them.

        * gal/e-text/e-text-model-repos.h,
        gal/e-text/e-text-model-repos.c: Added.  A group of simple
        structures & functions for handling various cursor movement rules.
        These are the sorts of things that are passed as arguments to
        ETextModel "reposition" event handlers.

        * gal/e-text/e-text-model.h, gal/e-text/e-text-model.c: Privitized
        the ETextModel struct and "methodized" all of the operations, so
        that derived classes can do arbitrarily respond to get/set
        requests in arbitrarily strange ways.  Also added the concept of
        declaring regions of the text as "embedded text objects".
        Finally, caused operations that change the text to emit a
        "reposition" signal that passes information that can be used by a
        view (like an EText) to move the cursor or selection in an
        intelligent way in response to those changes.  This means that you
        can now open two ETexts that look at the same ETextModel, and have
        the cursor in one do the right thing when you edit the other.  (As
	opposed to producing a lot of potential segfaults, as it was
	before.)

svn path=/trunk/; revision=8280
2001-02-19 22:47:23 +00:00

86 lines
2.7 KiB
C

/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
/*
* EEntry: An EText-based entry widget
*
* Authors:
* Miguel de Icaza <miguel@helixcode.com>
* Chris Lahey <clahey@helixcode.com>
* Jon Trowbridge <trow@ximian.com>
*
* Copyright (C) 1999, 2000, 2001 Ximian Inc.
*/
/*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License as
* published by the Free Software Foundation; either version 2 of the
* License, or (at your option) any later version.
*
* 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
*/
#ifndef _E_ENTRY_H_
#define _E_ENTRY_H_
#include <gtk/gtktable.h>
#include <gnome-xml/tree.h>
#include "e-completion.h"
BEGIN_GNOME_DECLS
#define E_ENTRY_TYPE (e_entry_get_type ())
#define E_ENTRY(o) (GTK_CHECK_CAST ((o), E_ENTRY_TYPE, EEntry))
#define E_ENTRY_CLASS(k) (GTK_CHECK_CLASS_CAST((k), E_ENTRY_TYPE, EEntryClass))
#define E_IS_ENTRY(o) (GTK_CHECK_TYPE ((o), E_ENTRY_TYPE))
#define E_IS_ENTRY_CLASS(k) (GTK_CHECK_CLASS_TYPE ((k), E_ENTRY_TYPE))
typedef struct _EEntry EEntry;
typedef struct _EEntryClass EEntryClass;
struct _EEntryPrivate;
typedef void (*EEntryCompletionHandler) (EEntry *entry, const gchar *text, gpointer extra_data);
struct _EEntry {
GtkTable parent;
struct _EEntryPrivate *priv;
};
struct _EEntryClass {
GtkTableClass parent_class;
void (* changed) (EEntry *entry);
void (* activate) (EEntry *entry);
};
GtkType e_entry_get_type (void);
void e_entry_construct (EEntry *entry);
GtkWidget *e_entry_new (void);
const gchar *e_entry_get_text (EEntry *entry);
void e_entry_set_text (EEntry *entry, const gchar *text);
gint e_entry_get_position (EEntry *entry);
void e_entry_set_position (EEntry *entry, gint);
void e_entry_select_region (EEntry *entry, gint start, gint end);
void e_entry_set_editable (EEntry *entry, gboolean editable);
void e_entry_enable_completion (EEntry *entry, ECompletion *completion);
void e_entry_enable_completion_full (EEntry *entry, ECompletion *completion, gint autocomplete_delay,
EEntryCompletionHandler handler);
END_GNOME_DECLS
#endif /* _E_ENTRY_H_ */