* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
- * License along with this library; if not, write to the
- * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- * Boston, MA 02111-1307, USA.
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
/*
*/
#include "config.h"
+
#include "gtktexttagtable.h"
+
+#include "gtkbuildable.h"
+#include "gtktexttagprivate.h"
#include "gtkmarshalers.h"
#include "gtktextbuffer.h" /* just for the lame notify_will_remove_tag hack */
#include "gtkintl.h"
-#include "gtkalias.h"
#include <stdlib.h>
+
+/**
+ * SECTION:gtktexttagtable
+ * @Short_description: Collection of tags that can be used together
+ * @Title: GtkTextTagTable
+ *
+ * You may wish to begin by reading the <link linkend="TextWidget">text widget
+ * conceptual overview</link> which gives an overview of all the objects and
+ * data types related to the text widget and how they work together.
+ *
+ * <refsect2 id="GtkTextTagTable-BUILDER-UI">
+ * <title>GtkTextTagTables as GtkBuildable</title>
+ * <para>
+ * The GtkTextTagTable implementation of the GtkBuildable interface
+ * supports adding tags by specifying "tag" as the "type"
+ * attribute of a <child> element.
+ *
+ * <example>
+ * <title>A UI definition fragment specifying tags</title>
+ * <programlisting><![CDATA[
+ * <object class="GtkTextTagTable">
+ * <child type="tag">
+ * <object class="GtkTextTag"/>
+ * </child>
+ * </object>
+ * ]]></programlisting>
+ * </example>
+ * </para>
+ * </refsect2>
+ */
+
+struct _GtkTextTagTablePrivate
+{
+ GHashTable *hash;
+ GSList *anonymous;
+ GSList *buffers;
+
+ gint anon_count;
+};
+
+
enum {
TAG_CHANGED,
TAG_ADDED,
GValue *value,
GParamSpec *pspec);
+static void gtk_text_tag_table_buildable_interface_init (GtkBuildableIface *iface);
+static void gtk_text_tag_table_buildable_add_child (GtkBuildable *buildable,
+ GtkBuilder *builder,
+ GObject *child,
+ const gchar *type);
+
static guint signals[LAST_SIGNAL] = { 0 };
-G_DEFINE_TYPE (GtkTextTagTable, gtk_text_tag_table, G_TYPE_OBJECT)
+G_DEFINE_TYPE_WITH_CODE (GtkTextTagTable, gtk_text_tag_table, G_TYPE_OBJECT,
+ G_IMPLEMENT_INTERFACE (GTK_TYPE_BUILDABLE,
+ gtk_text_tag_table_buildable_interface_init))
static void
gtk_text_tag_table_class_init (GtkTextTagTableClass *klass)
object_class->get_property = gtk_text_tag_table_get_property;
object_class->finalize = gtk_text_tag_table_finalize;
-
+
+ /**
+ * GtkTextTagTable::tag-changed:
+ * @texttagtable: the object which received the signal.
+ * @tag: the changed tag.
+ * @size_changed: whether the size has been changed.
+ */
signals[TAG_CHANGED] =
g_signal_new (I_("tag-changed"),
G_OBJECT_CLASS_TYPE (object_class),
GTK_TYPE_TEXT_TAG,
G_TYPE_BOOLEAN);
+ /**
+ * GtkTextTagTable::tag-added:
+ * @texttagtable: the object which received the signal.
+ * @tag: the added tag.
+ */
signals[TAG_ADDED] =
g_signal_new (I_("tag-added"),
G_OBJECT_CLASS_TYPE (object_class),
1,
GTK_TYPE_TEXT_TAG);
+ /**
+ * GtkTextTagTable::tag-removed:
+ * @texttagtable: the object which received the signal.
+ * @tag: the removed tag.
+ */
signals[TAG_REMOVED] =
g_signal_new (I_("tag-removed"),
G_OBJECT_CLASS_TYPE (object_class),
G_TYPE_NONE,
1,
GTK_TYPE_TEXT_TAG);
+
+ g_type_class_add_private (klass, sizeof (GtkTextTagTablePrivate));
}
static void
gtk_text_tag_table_init (GtkTextTagTable *table)
{
- table->hash = g_hash_table_new (g_str_hash, g_str_equal);
+ GtkTextTagTablePrivate *priv;
+
+ table->priv = G_TYPE_INSTANCE_GET_PRIVATE (table,
+ GTK_TYPE_TEXT_TAG_TABLE,
+ GtkTextTagTablePrivate);
+ priv = table->priv;
+
+ priv->hash = g_hash_table_new (g_str_hash, g_str_equal);
}
/**
static void
foreach_unref (GtkTextTag *tag, gpointer data)
{
+ GtkTextTagTable *table = GTK_TEXT_TAG_TABLE (tag->priv->table);
+ GtkTextTagTablePrivate *priv = table->priv;
GSList *tmp;
/* We don't want to emit the remove signal here; so we just unparent
* and unref the tag.
*/
- tmp = tag->table->buffers;
+ tmp = priv->buffers;
while (tmp != NULL)
{
_gtk_text_buffer_notify_will_remove_tag (GTK_TEXT_BUFFER (tmp->data),
tmp = tmp->next;
}
- tag->table = NULL;
+ tag->priv->table = NULL;
g_object_unref (tag);
}
static void
gtk_text_tag_table_finalize (GObject *object)
{
- GtkTextTagTable *table;
+ GtkTextTagTable *table = GTK_TEXT_TAG_TABLE (object);
+ GtkTextTagTablePrivate *priv = table->priv;
- table = GTK_TEXT_TAG_TABLE (object);
-
gtk_text_tag_table_foreach (table, foreach_unref, NULL);
- g_hash_table_destroy (table->hash);
- g_slist_free (table->anonymous);
+ g_hash_table_destroy (priv->hash);
+ g_slist_free (priv->anonymous);
- g_slist_free (table->buffers);
+ g_slist_free (priv->buffers);
G_OBJECT_CLASS (gtk_text_tag_table_parent_class)->finalize (object);
}
}
}
+static void
+gtk_text_tag_table_buildable_interface_init (GtkBuildableIface *iface)
+{
+ iface->add_child = gtk_text_tag_table_buildable_add_child;
+}
+
+static void
+gtk_text_tag_table_buildable_add_child (GtkBuildable *buildable,
+ GtkBuilder *builder,
+ GObject *child,
+ const gchar *type)
+{
+ if (type && strcmp (type, "tag") == 0)
+ gtk_text_tag_table_add (GTK_TEXT_TAG_TABLE (buildable),
+ GTK_TEXT_TAG (child));
+}
+
/**
* gtk_text_tag_table_add:
* @table: a #GtkTextTagTable
gtk_text_tag_table_add (GtkTextTagTable *table,
GtkTextTag *tag)
{
+ GtkTextTagTablePrivate *priv;
guint size;
g_return_if_fail (GTK_IS_TEXT_TAG_TABLE (table));
g_return_if_fail (GTK_IS_TEXT_TAG (tag));
- g_return_if_fail (tag->table == NULL);
+ g_return_if_fail (tag->priv->table == NULL);
+
+ priv = table->priv;
- if (tag->name && g_hash_table_lookup (table->hash, tag->name))
+ if (tag->priv->name && g_hash_table_lookup (priv->hash, tag->priv->name))
{
g_warning ("A tag named '%s' is already in the tag table.",
- tag->name);
+ tag->priv->name);
return;
}
g_object_ref (tag);
- if (tag->name)
- g_hash_table_insert (table->hash, tag->name, tag);
+ if (tag->priv->name)
+ g_hash_table_insert (priv->hash, tag->priv->name, tag);
else
{
- table->anonymous = g_slist_prepend (table->anonymous, tag);
- table->anon_count += 1;
+ priv->anonymous = g_slist_prepend (priv->anonymous, tag);
+ priv->anon_count += 1;
}
- tag->table = table;
+ tag->priv->table = table;
/* We get the highest tag priority, as the most-recently-added
tag. Note that we do NOT use gtk_text_tag_set_priority,
as it assumes the tag is already in the table. */
size = gtk_text_tag_table_get_size (table);
g_assert (size > 0);
- tag->priority = size - 1;
+ tag->priv->priority = size - 1;
g_signal_emit (table, signals[TAG_ADDED], 0, tag);
}
*
* Look up a named tag.
*
- * Return value: The tag, or %NULL if none by that name is in the table.
+ * Return value: (transfer none): The tag, or %NULL if none by that name is in the table.
**/
GtkTextTag*
gtk_text_tag_table_lookup (GtkTextTagTable *table,
const gchar *name)
{
+ GtkTextTagTablePrivate *priv;
+
g_return_val_if_fail (GTK_IS_TEXT_TAG_TABLE (table), NULL);
g_return_val_if_fail (name != NULL, NULL);
- return g_hash_table_lookup (table->hash, name);
+ priv = table->priv;
+
+ return g_hash_table_lookup (priv->hash, name);
}
/**
gtk_text_tag_table_remove (GtkTextTagTable *table,
GtkTextTag *tag)
{
+ GtkTextTagTablePrivate *priv;
GSList *tmp;
g_return_if_fail (GTK_IS_TEXT_TAG_TABLE (table));
g_return_if_fail (GTK_IS_TEXT_TAG (tag));
- g_return_if_fail (tag->table == table);
+ g_return_if_fail (tag->priv->table == table);
+
+ priv = table->priv;
/* Our little bad hack to be sure buffers don't still have the tag
* applied to text in the buffer
*/
- tmp = table->buffers;
+ tmp = priv->buffers;
while (tmp != NULL)
{
_gtk_text_buffer_notify_will_remove_tag (GTK_TEXT_BUFFER (tmp->data),
priorities of the tags in the table. */
gtk_text_tag_set_priority (tag, gtk_text_tag_table_get_size (table) - 1);
- tag->table = NULL;
+ tag->priv->table = NULL;
- if (tag->name)
- g_hash_table_remove (table->hash, tag->name);
+ if (tag->priv->name)
+ g_hash_table_remove (priv->hash, tag->priv->name);
else
{
- table->anonymous = g_slist_remove (table->anonymous, tag);
- table->anon_count -= 1;
+ priv->anonymous = g_slist_remove (priv->anonymous, tag);
+ priv->anon_count -= 1;
}
g_signal_emit (table, signals[TAG_REMOVED], 0, tag);
/**
* gtk_text_tag_table_foreach:
* @table: a #GtkTextTagTable
- * @func: a function to call on each tag
+ * @func: (scope call): a function to call on each tag
* @data: user data
*
* Calls @func on each tag in @table, with user data @data.
GtkTextTagTableForeach func,
gpointer data)
{
+ GtkTextTagTablePrivate *priv;
struct ForeachData d;
g_return_if_fail (GTK_IS_TEXT_TAG_TABLE (table));
g_return_if_fail (func != NULL);
+ priv = table->priv;
+
d.func = func;
d.data = data;
- g_hash_table_foreach (table->hash, hash_foreach, &d);
- g_slist_foreach (table->anonymous, list_foreach, &d);
+ g_hash_table_foreach (priv->hash, hash_foreach, &d);
+ g_slist_foreach (priv->anonymous, list_foreach, &d);
}
/**
gint
gtk_text_tag_table_get_size (GtkTextTagTable *table)
{
+ GtkTextTagTablePrivate *priv;
+
g_return_val_if_fail (GTK_IS_TEXT_TAG_TABLE (table), 0);
- return g_hash_table_size (table->hash) + table->anon_count;
+ priv = table->priv;
+
+ return g_hash_table_size (priv->hash) + priv->anon_count;
}
void
_gtk_text_tag_table_add_buffer (GtkTextTagTable *table,
gpointer buffer)
{
- g_return_if_fail (GTK_IS_TEXT_TAG_TABLE (table));
+ GtkTextTagTablePrivate *priv = table->priv;
- table->buffers = g_slist_prepend (table->buffers, buffer);
+ priv->buffers = g_slist_prepend (priv->buffers, buffer);
}
static void
_gtk_text_tag_table_remove_buffer (GtkTextTagTable *table,
gpointer buffer)
{
- g_return_if_fail (GTK_IS_TEXT_TAG_TABLE (table));
+ GtkTextTagTablePrivate *priv = table->priv;
gtk_text_tag_table_foreach (table, foreach_remove_tag, buffer);
-
- table->buffers = g_slist_remove (table->buffers, buffer);
-}
-#define __GTK_TEXT_TAG_TABLE_C__
-#include "gtkaliasdef.c"
+ priv->buffers = g_slist_remove (priv->buffers, buffer);
+}