1 /*
2  * Copyright © 2020 Red Hat, Inc.
3  *
4  * This library is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2.1 of the License, or (at your option) any later version.
8  *
9  * This library 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 GNU
12  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser General Public
15  * License along with this library. If not, see <http://www.gnu.org/licenses/>.
16  *
17  * Authors: Matthias Clasen <mclasen@redhat.com>
18  */
19 
20 #ifndef __GTK_STRING_LIST_H__
21 #define __GTK_STRING_LIST_H__
22 
23 
24 #if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
25 #error "Only <gtk/gtk.h> can be included directly."
26 #endif
27 
28 #include <gio/gio.h>
29 /* for GDK_AVAILABLE_IN_ALL */
30 #include <gdk/gdk.h>
31 
32 
33 G_BEGIN_DECLS
34 
35 #define GTK_TYPE_STRING_OBJECT (gtk_string_object_get_type ())
36 GDK_AVAILABLE_IN_ALL
37 G_DECLARE_FINAL_TYPE (GtkStringObject, gtk_string_object, GTK, STRING_OBJECT, GObject)
38 
39 GDK_AVAILABLE_IN_ALL
40 GtkStringObject *       gtk_string_object_new        (const char      *string);
41 GDK_AVAILABLE_IN_ALL
42 const char *            gtk_string_object_get_string (GtkStringObject *self);
43 
44 #define GTK_TYPE_STRING_LIST (gtk_string_list_get_type ())
45 
46 GDK_AVAILABLE_IN_ALL
47 G_DECLARE_FINAL_TYPE (GtkStringList, gtk_string_list, GTK, STRING_LIST, GObject)
48 
49 GDK_AVAILABLE_IN_ALL
50 GtkStringList * gtk_string_list_new             (const char * const    *strings);
51 
52 GDK_AVAILABLE_IN_ALL
53 void            gtk_string_list_append          (GtkStringList         *self,
54                                                  const char            *string);
55 
56 GDK_AVAILABLE_IN_ALL
57 void            gtk_string_list_take            (GtkStringList         *self,
58                                                  char                  *string);
59 
60 GDK_AVAILABLE_IN_ALL
61 void            gtk_string_list_remove          (GtkStringList         *self,
62                                                  guint                  position);
63 
64 GDK_AVAILABLE_IN_ALL
65 void            gtk_string_list_splice          (GtkStringList         *self,
66                                                  guint                  position,
67                                                  guint                  n_removals,
68                                                  const char * const    *additions);
69 
70 GDK_AVAILABLE_IN_ALL
71 const char *    gtk_string_list_get_string      (GtkStringList         *self,
72                                                  guint                  position);
73 
74 G_END_DECLS
75 
76 #endif /* __GTK_STRING_LIST_H__ */
77