gtk2/gtk/gtkcomboboxtext.c
Matthias Clasen be944053e0 docs: More syntax fixes
The syntax for interface links is [iface@...], not
[interface@...].
2021-05-22 21:21:10 -04:00

620 lines
19 KiB
C

/* GTK - The GIMP Toolkit
*
* Copyright (C) 2010 Christian Dywan
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library 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
* 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, see <http://www.gnu.org/licenses/>.
*/
#include "config.h"
#include "gtkcomboboxtext.h"
#include "gtkcombobox.h"
#include "gtkcellrenderertext.h"
#include "gtkcelllayout.h"
#include "gtkbuildable.h"
#include "gtkbuilderprivate.h"
#include "gtkliststore.h"
#include <string.h>
/**
* GtkComboBoxText:
*
* A `GtkComboBoxText` is a simple variant of `GtkComboBox` for text-only
* use cases.
*
* ![An example GtkComboBoxText](combo-box-text.png)
*
* `GtkComboBoxText` hides the model-view complexity of `GtkComboBox`.
*
* To create a `GtkComboBoxText`, use [ctor@Gtk.ComboBoxText.new] or
* [ctor@Gtk.ComboBoxText.new_with_entry].
*
* You can add items to a `GtkComboBoxText` with
* [method@Gtk.ComboBoxText.append_text],
* [method@Gtk.ComboBoxText.insert_text] or
* [method@Gtk.ComboBoxText.prepend_text] and remove options with
* [method@Gtk.ComboBoxText.remove].
*
* If the `GtkComboBoxText` contains an entry (via the
* [property@Gtk.ComboBox:has-entry] property), its contents can be retrieved
* using [method@Gtk.ComboBoxText.get_active_text].
*
* You should not call [method@Gtk.ComboBox.set_model] or attempt to pack more
* cells into this combo box via its [iface@Gtk.CellLayout] interface.
*
* # GtkComboBoxText as GtkBuildable
*
* The `GtkComboBoxText` implementation of the `GtkBuildable` interface supports
* adding items directly using the <items> element and specifying <item>
* elements for each item. Each <item> element can specify the “id”
* corresponding to the appended text and also supports the regular
* translation attributes “translatable”, “context” and “comments”.
*
* Here is a UI definition fragment specifying `GtkComboBoxText` items:
* ```xml
* <object class="GtkComboBoxText">
* <items>
* <item translatable="yes" id="factory">Factory</item>
* <item translatable="yes" id="home">Home</item>
* <item translatable="yes" id="subway">Subway</item>
* </items>
* </object>
* ```
*
* # CSS nodes
*
* ```
* combobox
* ╰── box.linked
* ├── entry.combo
* ├── button.combo
* ╰── window.popup
* ```
*
* `GtkComboBoxText` has a single CSS node with name combobox. It adds
* the style class .combo to the main CSS nodes of its entry and button
* children, and the .linked class to the node of its internal box.
*/
typedef struct _GtkComboBoxTextClass GtkComboBoxTextClass;
struct _GtkComboBoxText
{
GtkComboBox parent_instance;
};
struct _GtkComboBoxTextClass
{
GtkComboBoxClass parent_class;
};
static void gtk_combo_box_text_buildable_interface_init (GtkBuildableIface *iface);
static gboolean gtk_combo_box_text_buildable_custom_tag_start (GtkBuildable *buildable,
GtkBuilder *builder,
GObject *child,
const char *tagname,
GtkBuildableParser *parser,
gpointer *data);
static void gtk_combo_box_text_buildable_custom_finished (GtkBuildable *buildable,
GtkBuilder *builder,
GObject *child,
const char *tagname,
gpointer user_data);
static GtkBuildableIface *buildable_parent_iface = NULL;
G_DEFINE_TYPE_WITH_CODE (GtkComboBoxText, gtk_combo_box_text, GTK_TYPE_COMBO_BOX,
G_IMPLEMENT_INTERFACE (GTK_TYPE_BUILDABLE,
gtk_combo_box_text_buildable_interface_init));
static void
gtk_combo_box_text_constructed (GObject *object)
{
const int text_column = 0;
G_OBJECT_CLASS (gtk_combo_box_text_parent_class)->constructed (object);
gtk_combo_box_set_entry_text_column (GTK_COMBO_BOX (object), text_column);
gtk_combo_box_set_id_column (GTK_COMBO_BOX (object), 1);
if (!gtk_combo_box_get_has_entry (GTK_COMBO_BOX (object)))
{
GtkCellRenderer *cell;
cell = gtk_cell_renderer_text_new ();
gtk_cell_layout_pack_start (GTK_CELL_LAYOUT (object), cell, TRUE);
gtk_cell_layout_set_attributes (GTK_CELL_LAYOUT (object), cell,
"text", text_column,
NULL);
}
}
static void
gtk_combo_box_text_init (GtkComboBoxText *combo_box)
{
GtkListStore *store;
store = gtk_list_store_new (2, G_TYPE_STRING, G_TYPE_STRING);
gtk_combo_box_set_model (GTK_COMBO_BOX (combo_box), GTK_TREE_MODEL (store));
g_object_unref (store);
}
static void
gtk_combo_box_text_class_init (GtkComboBoxTextClass *klass)
{
GObjectClass *object_class;
object_class = (GObjectClass *)klass;
object_class->constructed = gtk_combo_box_text_constructed;
}
static void
gtk_combo_box_text_buildable_interface_init (GtkBuildableIface *iface)
{
buildable_parent_iface = g_type_interface_peek_parent (iface);
iface->custom_tag_start = gtk_combo_box_text_buildable_custom_tag_start;
iface->custom_finished = gtk_combo_box_text_buildable_custom_finished;
}
typedef struct {
GtkBuilder *builder;
GObject *object;
const char *domain;
char *id;
GString *string;
char *context;
guint translatable : 1;
guint is_text : 1;
} ItemParserData;
static void
item_start_element (GtkBuildableParseContext *context,
const char *element_name,
const char **names,
const char **values,
gpointer user_data,
GError **error)
{
ItemParserData *data = (ItemParserData*)user_data;
if (strcmp (element_name, "items") == 0)
{
if (!_gtk_builder_check_parent (data->builder, context, "object", error))
return;
if (!g_markup_collect_attributes (element_name, names, values, error,
G_MARKUP_COLLECT_INVALID, NULL, NULL,
G_MARKUP_COLLECT_INVALID))
_gtk_builder_prefix_error (data->builder, context, error);
}
else if (strcmp (element_name, "item") == 0)
{
const char *id = NULL;
gboolean translatable = FALSE;
const char *msg_context = NULL;
if (!_gtk_builder_check_parent (data->builder, context, "items", error))
return;
if (!g_markup_collect_attributes (element_name, names, values, error,
G_MARKUP_COLLECT_STRING|G_MARKUP_COLLECT_OPTIONAL, "id", &id,
G_MARKUP_COLLECT_BOOLEAN|G_MARKUP_COLLECT_OPTIONAL, "translatable", &translatable,
G_MARKUP_COLLECT_STRING|G_MARKUP_COLLECT_OPTIONAL, "comments", NULL,
G_MARKUP_COLLECT_STRING|G_MARKUP_COLLECT_OPTIONAL, "context", &msg_context,
G_MARKUP_COLLECT_INVALID))
{
_gtk_builder_prefix_error (data->builder, context, error);
return;
}
data->is_text = TRUE;
data->translatable = translatable;
data->context = g_strdup (msg_context);
data->id = g_strdup (id);
}
else
{
_gtk_builder_error_unhandled_tag (data->builder, context,
"GtkComboBoxText", element_name,
error);
}
}
static void
item_text (GtkBuildableParseContext *context,
const char *text,
gsize text_len,
gpointer user_data,
GError **error)
{
ItemParserData *data = (ItemParserData*)user_data;
if (data->is_text)
g_string_append_len (data->string, text, text_len);
}
static void
item_end_element (GtkBuildableParseContext *context,
const char *element_name,
gpointer user_data,
GError **error)
{
ItemParserData *data = (ItemParserData*)user_data;
/* Append the translated strings */
if (data->string->len)
{
if (data->translatable)
{
const char *translated;
translated = _gtk_builder_parser_translate (data->domain,
data->context,
data->string->str);
g_string_assign (data->string, translated);
}
gtk_combo_box_text_append (GTK_COMBO_BOX_TEXT (data->object), data->id, data->string->str);
}
data->translatable = FALSE;
g_string_set_size (data->string, 0);
g_clear_pointer (&data->context, g_free);
g_clear_pointer (&data->id, g_free);
data->is_text = FALSE;
}
static const GtkBuildableParser item_parser =
{
item_start_element,
item_end_element,
item_text
};
static gboolean
gtk_combo_box_text_buildable_custom_tag_start (GtkBuildable *buildable,
GtkBuilder *builder,
GObject *child,
const char *tagname,
GtkBuildableParser *parser,
gpointer *parser_data)
{
if (buildable_parent_iface->custom_tag_start (buildable, builder, child,
tagname, parser, parser_data))
return TRUE;
if (strcmp (tagname, "items") == 0)
{
ItemParserData *data;
data = g_slice_new0 (ItemParserData);
data->builder = g_object_ref (builder);
data->object = (GObject *) g_object_ref (buildable);
data->domain = gtk_builder_get_translation_domain (builder);
data->string = g_string_new ("");
*parser = item_parser;
*parser_data = data;
return TRUE;
}
return FALSE;
}
static void
gtk_combo_box_text_buildable_custom_finished (GtkBuildable *buildable,
GtkBuilder *builder,
GObject *child,
const char *tagname,
gpointer user_data)
{
ItemParserData *data;
buildable_parent_iface->custom_finished (buildable, builder, child,
tagname, user_data);
if (strcmp (tagname, "items") == 0)
{
data = (ItemParserData*)user_data;
g_object_unref (data->object);
g_object_unref (data->builder);
g_string_free (data->string, TRUE);
g_slice_free (ItemParserData, data);
}
}
/**
* gtk_combo_box_text_new:
*
* Creates a new `GtkComboBoxText`.
*
* Returns: A new `GtkComboBoxText`
*/
GtkWidget *
gtk_combo_box_text_new (void)
{
return g_object_new (GTK_TYPE_COMBO_BOX_TEXT,
NULL);
}
/**
* gtk_combo_box_text_new_with_entry:
*
* Creates a new `GtkComboBoxText` with an entry.
*
* Returns: a new `GtkComboBoxText`
*/
GtkWidget *
gtk_combo_box_text_new_with_entry (void)
{
return g_object_new (GTK_TYPE_COMBO_BOX_TEXT,
"has-entry", TRUE,
NULL);
}
/**
* gtk_combo_box_text_append_text:
* @combo_box: A `GtkComboBoxText`
* @text: A string
*
* Appends @text to the list of strings stored in @combo_box.
*
* This is the same as calling [method@Gtk.ComboBoxText.insert_text]
* with a position of -1.
*/
void
gtk_combo_box_text_append_text (GtkComboBoxText *combo_box,
const char *text)
{
gtk_combo_box_text_insert (combo_box, -1, NULL, text);
}
/**
* gtk_combo_box_text_prepend_text:
* @combo_box: A `GtkComboBox`
* @text: A string
*
* Prepends @text to the list of strings stored in @combo_box.
*
* This is the same as calling [method@Gtk.ComboBoxText.insert_text]
* with a position of 0.
*/
void
gtk_combo_box_text_prepend_text (GtkComboBoxText *combo_box,
const char *text)
{
gtk_combo_box_text_insert (combo_box, 0, NULL, text);
}
/**
* gtk_combo_box_text_insert_text:
* @combo_box: A `GtkComboBoxText`
* @position: An index to insert @text
* @text: A string
*
* Inserts @text at @position in the list of strings stored in @combo_box.
*
* If @position is negative then @text is appended.
*
* This is the same as calling [method@Gtk.ComboBoxText.insert]
* with a %NULL ID string.
*/
void
gtk_combo_box_text_insert_text (GtkComboBoxText *combo_box,
int position,
const char *text)
{
gtk_combo_box_text_insert (combo_box, position, NULL, text);
}
/**
* gtk_combo_box_text_append:
* @combo_box: A `GtkComboBoxText`
* @id: (nullable): a string ID for this value
* @text: A string
*
* Appends @text to the list of strings stored in @combo_box.
*
* If @id is non-%NULL then it is used as the ID of the row.
*
* This is the same as calling [method@Gtk.ComboBoxText.insert]
* with a position of -1.
*/
void
gtk_combo_box_text_append (GtkComboBoxText *combo_box,
const char *id,
const char *text)
{
gtk_combo_box_text_insert (combo_box, -1, id, text);
}
/**
* gtk_combo_box_text_prepend:
* @combo_box: A `GtkComboBox`
* @id: (nullable): a string ID for this value
* @text: a string
*
* Prepends @text to the list of strings stored in @combo_box.
*
* If @id is non-%NULL then it is used as the ID of the row.
*
* This is the same as calling [method@Gtk.ComboBoxText.insert]
* with a position of 0.
*/
void
gtk_combo_box_text_prepend (GtkComboBoxText *combo_box,
const char *id,
const char *text)
{
gtk_combo_box_text_insert (combo_box, 0, id, text);
}
/**
* gtk_combo_box_text_insert:
* @combo_box: A `GtkComboBoxText`
* @position: An index to insert @text
* @id: (nullable): a string ID for this value
* @text: A string to display
*
* Inserts @text at @position in the list of strings stored in @combo_box.
*
* If @id is non-%NULL then it is used as the ID of the row.
* See [property@Gtk.ComboBox:id-column].
*
* If @position is negative then @text is appended.
*/
void
gtk_combo_box_text_insert (GtkComboBoxText *combo_box,
int position,
const char *id,
const char *text)
{
GtkListStore *store;
GtkTreeIter iter;
int text_column;
g_return_if_fail (GTK_IS_COMBO_BOX_TEXT (combo_box));
g_return_if_fail (text != NULL);
store = GTK_LIST_STORE (gtk_combo_box_get_model (GTK_COMBO_BOX (combo_box)));
g_return_if_fail (GTK_IS_LIST_STORE (store));
text_column = gtk_combo_box_get_entry_text_column (GTK_COMBO_BOX (combo_box));
if (gtk_combo_box_get_has_entry (GTK_COMBO_BOX (combo_box)))
g_return_if_fail (text_column >= 0);
else if (text_column < 0)
text_column = 0;
g_return_if_fail (gtk_tree_model_get_column_type (GTK_TREE_MODEL (store), text_column) == G_TYPE_STRING);
if (position < 0)
gtk_list_store_append (store, &iter);
else
gtk_list_store_insert (store, &iter, position);
gtk_list_store_set (store, &iter, text_column, text, -1);
if (id != NULL)
{
int id_column;
id_column = gtk_combo_box_get_id_column (GTK_COMBO_BOX (combo_box));
g_return_if_fail (id_column >= 0);
g_return_if_fail (gtk_tree_model_get_column_type (GTK_TREE_MODEL (store), id_column) == G_TYPE_STRING);
gtk_list_store_set (store, &iter, id_column, id, -1);
}
}
/**
* gtk_combo_box_text_remove:
* @combo_box: A `GtkComboBox`
* @position: Index of the item to remove
*
* Removes the string at @position from @combo_box.
*/
void
gtk_combo_box_text_remove (GtkComboBoxText *combo_box,
int position)
{
GtkTreeModel *model;
GtkListStore *store;
GtkTreeIter iter;
g_return_if_fail (GTK_IS_COMBO_BOX_TEXT (combo_box));
g_return_if_fail (position >= 0);
model = gtk_combo_box_get_model (GTK_COMBO_BOX (combo_box));
store = GTK_LIST_STORE (model);
g_return_if_fail (GTK_IS_LIST_STORE (store));
if (gtk_tree_model_iter_nth_child (model, &iter, NULL, position))
gtk_list_store_remove (store, &iter);
}
/**
* gtk_combo_box_text_remove_all:
* @combo_box: A `GtkComboBoxText`
*
* Removes all the text entries from the combo box.
*/
void
gtk_combo_box_text_remove_all (GtkComboBoxText *combo_box)
{
GtkListStore *store;
g_return_if_fail (GTK_IS_COMBO_BOX_TEXT (combo_box));
store = GTK_LIST_STORE (gtk_combo_box_get_model (GTK_COMBO_BOX (combo_box)));
gtk_list_store_clear (store);
}
/**
* gtk_combo_box_text_get_active_text:
* @combo_box: A `GtkComboBoxText`
*
* Returns the currently active string in @combo_box.
*
* If no row is currently selected, %NULL is returned.
* If @combo_box contains an entry, this function will
* return its contents (which will not necessarily
* be an item from the list).
*
* Returns: (nullable) (transfer full): a newly allocated
* string containing the currently active text.
* Must be freed with g_free().
*/
char *
gtk_combo_box_text_get_active_text (GtkComboBoxText *combo_box)
{
GtkTreeIter iter;
char *text = NULL;
g_return_val_if_fail (GTK_IS_COMBO_BOX_TEXT (combo_box), NULL);
if (gtk_combo_box_get_has_entry (GTK_COMBO_BOX (combo_box)))
{
GtkWidget *entry;
entry = gtk_combo_box_get_child (GTK_COMBO_BOX (combo_box));
text = g_strdup (gtk_editable_get_text (GTK_EDITABLE (entry)));
}
else if (gtk_combo_box_get_active_iter (GTK_COMBO_BOX (combo_box), &iter))
{
GtkTreeModel *model;
int text_column;
model = gtk_combo_box_get_model (GTK_COMBO_BOX (combo_box));
g_return_val_if_fail (GTK_IS_LIST_STORE (model), NULL);
text_column = gtk_combo_box_get_entry_text_column (GTK_COMBO_BOX (combo_box));
g_return_val_if_fail (text_column >= 0, NULL);
g_return_val_if_fail (gtk_tree_model_get_column_type (model, text_column) == G_TYPE_STRING, NULL);
gtk_tree_model_get (model, &iter, text_column, &text, -1);
}
return text;
}