Add GtkStringList as public api

This is a list model holding strings, initialized
from a char **. String lists are buildable as well,
and that replaces the buildable support in GktDropDowns.

1 files changed, 75 insertions, 0 deletions

diff --git a/gtk/gtkstringlist.h b/gtk/gtkstringlist.h
new file mode 100644
index 0000000000..31c788312a
--- /dev/null
+++ b/gtk/gtkstringlist.h
@@ -0,0 +1,75 @@
+/*
+ * Copyright © 2020 Red Hat, Inc.
+ *
+ * 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.1 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/>.
+ *
+ * Authors: Matthias Clasen <mclasen@redhat.com>
+ */
+
+#ifndef __GTK_STRING_LIST_H__
+#define __GTK_STRING_LIST_H__
+
+
+#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
+#error "Only <gtk/gtk.h> can be included directly."
+#endif
+
+#include <gio/gio.h>
+/* for GDK_AVAILABLE_IN_ALL */
+#include <gdk/gdk.h>
+
+
+G_BEGIN_DECLS
+
+#define GTK_TYPE_STRING_OBJECT (gtk_string_object_get_type ())
+GDK_AVAILABLE_IN_ALL
+G_DECLARE_FINAL_TYPE (GtkStringObject, gtk_string_object, GTK, STRING_OBJECT, GObject)
+
+GDK_AVAILABLE_IN_ALL
+const char *         gtk_string_object_get_string (GtkStringObject *self);
+
+#define GTK_TYPE_STRING_LIST (gtk_string_list_get_type ())
+
+GDK_AVAILABLE_IN_ALL
+G_DECLARE_FINAL_TYPE (GtkStringList, gtk_string_list, GTK, STRING_LIST, GObject)
+
+GDK_AVAILABLE_IN_ALL
+GtkStringList * gtk_string_list_new             (const char **strings);
+
+GDK_AVAILABLE_IN_ALL
+void            gtk_string_list_append          (GtkStringList *self,
+                                                 const char    *string);
+
+GDK_AVAILABLE_IN_ALL
+void            gtk_string_list_take            (GtkStringList *self,
+                                                 char          *string);
+
+GDK_AVAILABLE_IN_ALL
+void            gtk_string_list_remove          (GtkStringList *self,
+                                                 guint          position);
+
+GDK_AVAILABLE_IN_ALL
+void            gtk_string_list_splice          (GtkStringList  *self,
+                                                 guint           position,
+                                                 guint           n_removals,
+                                                 const char    **additions,
+                                                 guint           n_additions);
+
+GDK_AVAILABLE_IN_ALL
+const char *    gtk_string_list_get_string      (GtkStringList *self,
+                                                 guint          position);
+
+G_END_DECLS
+
+#endif /* __GTK_STRING_LIST_H__ */