Debian Codegraph @

lib/gtk/font-manager-place-holder.c

raw
1 /* font-manager-place-holder.c
2 *
3 * Copyright (C) 2009-2024 Jerry Casiano
4 *
5 * This program is free software: you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation, either version 3 of the License, or
8 * (at your option) any later version.
9 *
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
14 *
15 * You should have received a copy of the GNU General Public License
16 * along with this program.
17 *
18 * If not, see <http://www.gnu.org/licenses/gpl-3.0.txt>.
19 */
20
21 #include "font-manager-place-holder.h"
22
23 /**
24 * SECTION: font-manager-place-holder
25 * @short_description: Place holder widget
26 * @title: Place Holder
27 * @include: font-manager-place-holder.h
28 *
29 * Widget intended to display a message in an empty area.
30 */
31
32 struct _FontManagerPlaceHolder
33 {
34 GtkWidget parent;
35
36 GtkWidget *icon;
37 GtkWidget *title;
38 GtkWidget *subtitle;
39 GtkWidget *message;
40 };
41
42 G_DEFINE_TYPE(FontManagerPlaceHolder, font_manager_place_holder, GTK_TYPE_WIDGET)
43
44 enum
45 {
46 PROP_RESERVED,
47 PROP_ICON_NAME,
48 PROP_TITLE,
49 PROP_SUBTITLE,
50 PROP_MESSAGE,
51 N_PROPERTIES
52 };
53
54 static GParamSpec *obj_properties[N_PROPERTIES] = { NULL, };
55
56 static void
57 font_manager_place_holder_dispose (GObject *gobject)
58 {
59 FontManagerPlaceHolder *self = FONT_MANAGER_PLACE_HOLDER(gobject);
60 g_return_if_fail(self != NULL);
61 font_manager_widget_dispose(GTK_WIDGET(gobject));
62 G_OBJECT_CLASS(font_manager_place_holder_parent_class)->dispose(gobject);
63 return;
64 }
65
66 static void
67 font_manager_place_holder_set_label (GtkLabel *_label, const gchar *msg)
68 {
69 gtk_label_set_text(_label, msg);
70 gtk_widget_set_visible(GTK_WIDGET(_label), strlen(gtk_label_get_text(_label)) > 0);
71 return;
72 }
73
74 static void
75 font_manager_place_holder_get_property (GObject *gobject,
76 guint property_id,
77 GValue *value,
78 GParamSpec *pspec)
79 {
80 g_return_if_fail(gobject != NULL);
81 FontManagerPlaceHolder *self = FONT_MANAGER_PLACE_HOLDER(gobject);
82 g_autofree gchar *icon_name = NULL;
83 switch (property_id) {
84 case PROP_ICON_NAME:
85 g_object_get(gobject, "icon-name", &icon_name, NULL);
86 g_value_set_string(value, icon_name);
87 break;
88 case PROP_TITLE:
89 g_value_set_string(value, gtk_label_get_text(GTK_LABEL(self->title)));
90 break;
91 case PROP_SUBTITLE:
92 g_value_set_string(value, gtk_label_get_text(GTK_LABEL(self->subtitle)));
93 break;
94 case PROP_MESSAGE:
95 g_value_set_string(value, gtk_label_get_text(GTK_LABEL(self->message)));
96 break;
97 default:
98 G_OBJECT_WARN_INVALID_PROPERTY_ID(gobject, property_id, pspec);
99 }
100 return;
101 }
102
103 static void
104 font_manager_place_holder_set_property (GObject *gobject,
105 guint property_id,
106 const GValue *value,
107 GParamSpec *pspec)
108 {
109 g_return_if_fail(gobject != NULL);
110 FontManagerPlaceHolder *self = FONT_MANAGER_PLACE_HOLDER(gobject);
111 const gchar *val = g_value_get_string(value);
112 switch (property_id) {
113 case PROP_ICON_NAME:
114 gtk_image_set_from_icon_name(GTK_IMAGE(self->icon), val);
115 break;
116 case PROP_TITLE:
117 font_manager_place_holder_set_label(GTK_LABEL(self->title), val);
118 break;
119 case PROP_SUBTITLE:
120 font_manager_place_holder_set_label(GTK_LABEL(self->subtitle), val);
121 break;
122 case PROP_MESSAGE:
123 font_manager_place_holder_set_label(GTK_LABEL(self->message), val);
124 break;
125 default:
126 G_OBJECT_WARN_INVALID_PROPERTY_ID(gobject, property_id, pspec);
127 }
128 return;
129 }
130
131 static void
132 font_manager_place_holder_class_init (FontManagerPlaceHolderClass *klass)
133 {
134 GObjectClass *object_class = G_OBJECT_CLASS(klass);
135 GtkWidgetClass *widget_class = GTK_WIDGET_CLASS(klass);
136
137 object_class->dispose = font_manager_place_holder_dispose;
138 object_class->get_property = font_manager_place_holder_get_property;
139 object_class->set_property = font_manager_place_holder_set_property;
140 gtk_widget_class_set_layout_manager_type(widget_class, GTK_TYPE_BOX_LAYOUT);
141
142 /**
143 * FontManagerPlaceHolder:icon-name:
144 *
145 * Named icon to display in center of place holder.
146 */
147 obj_properties[PROP_ICON_NAME] = g_param_spec_string("icon-name",
148 NULL,
149 "Named icon to display",
150 NULL,
151 G_PARAM_STATIC_STRINGS |
152 G_PARAM_READWRITE);
153
154 /**
155 * FontManagerPlaceHolder:title:
156 *
157 * Text to display as the title beneath icon.
158 */
159 obj_properties[PROP_TITLE] = g_param_spec_string("title",
160 NULL,
161 "Title to display under icon",
162 NULL,
163 G_PARAM_STATIC_STRINGS |
164 G_PARAM_READWRITE);
165
166 /**
167 * FontManagerPlaceHolder:subtitle:
168 *
169 * Text to display as a subtitle beneath icon.
170 */
171 obj_properties[PROP_SUBTITLE] = g_param_spec_string("subtitle",
172 NULL,
173 "Subtitle to display under icon",
174 NULL,
175 G_PARAM_STATIC_STRINGS |
176 G_PARAM_READWRITE);
177
178 /**
179 * FontManagerPlaceHolder:message:
180 *
181 * Message to display beneath icon.
182 */
183 obj_properties[PROP_MESSAGE] = g_param_spec_string("message",
184 NULL,
185 "Text to display under icon",
186 NULL,
187 G_PARAM_STATIC_STRINGS |
188 G_PARAM_READWRITE);
189
190 g_object_class_install_properties(object_class, N_PROPERTIES, obj_properties);
191 return;
192 }
193
194 static void
195 set_title_attributes (GtkWidget *widget)
196 {
197 PangoAttrList *attrs = pango_attr_list_new();
198 pango_attr_list_insert(attrs, pango_attr_weight_new(PANGO_WEIGHT_BOLD));
199 pango_attr_list_insert(attrs, pango_attr_scale_new(PANGO_SCALE_XX_LARGE));
200 gtk_label_set_attributes(GTK_LABEL(widget), attrs);
201 pango_attr_list_unref(attrs);
202 return;
203 }
204
205 static void
206 set_subtitle_attributes (GtkWidget *widget)
207 {
208 PangoAttrList *attrs = pango_attr_list_new();
209 pango_attr_list_insert(attrs, pango_attr_scale_new(PANGO_SCALE_LARGE));
210 gtk_label_set_attributes(GTK_LABEL(widget), attrs);
211 pango_attr_list_unref(attrs);
212 return;
213 }
214
215 static void
216 set_message_attributes (GtkWidget *widget)
217 {
218 PangoAttrList *attrs = pango_attr_list_new();
219 pango_attr_list_insert(attrs, pango_attr_scale_new(PANGO_SCALE_X_LARGE));
220 gtk_label_set_attributes(GTK_LABEL(widget), attrs);
221 pango_attr_list_unref(attrs);
222 return;
223 }
224
225 static void
226 insert_label (GtkBox *box, GtkWidget *widget)
227 {
228 gtk_widget_set_opacity(widget, 0.90);
229 gtk_widget_set_sensitive(widget, FALSE);
230 gtk_widget_set_halign(widget, GTK_ALIGN_CENTER);
231 gtk_widget_set_valign(widget, GTK_ALIGN_START);
232 gtk_widget_set_margin_bottom(widget, FONT_MANAGER_DEFAULT_MARGIN * 3);
233 gtk_label_set_justify(GTK_LABEL(widget), GTK_JUSTIFY_CENTER);
234 gtk_label_set_wrap(GTK_LABEL(widget), TRUE);
235 gtk_box_append(GTK_BOX(box), widget);
236 return;
237 }
238
239 static void
240 font_manager_place_holder_init (FontManagerPlaceHolder *self)
241 {
242 g_return_if_fail(self != NULL);
243 gtk_widget_set_opacity(GTK_WIDGET(self), 0.75);
244 self->icon = gtk_image_new();
245 gtk_image_set_pixel_size(GTK_IMAGE(self->icon), 128);
246 self->title = gtk_label_new(NULL);
247 set_title_attributes(self->title);
248 self->subtitle = gtk_label_new(NULL);
249 set_subtitle_attributes(self->subtitle);
250 self->message = gtk_label_new(NULL);
251 set_message_attributes(self->message);
252 gtk_widget_set_halign(GTK_WIDGET(self->icon), GTK_ALIGN_CENTER);
253 gtk_widget_set_valign(GTK_WIDGET(self->icon), GTK_ALIGN_END);
254 gtk_widget_set_opacity(self->icon, 0.75);
255 gtk_widget_set_sensitive(self->icon, FALSE);
256 GtkWidget *scrolled_window = gtk_scrolled_window_new();
257 GtkWidget *bbox = gtk_box_new(GTK_ORIENTATION_VERTICAL, FONT_MANAGER_DEFAULT_MARGIN * 3);
258 GtkWidget *box = gtk_box_new(GTK_ORIENTATION_VERTICAL, FONT_MANAGER_DEFAULT_MARGIN);
259 gtk_box_prepend(GTK_BOX(bbox), self->icon);
260 gtk_box_append(GTK_BOX(bbox), box);
261 insert_label(GTK_BOX(box), self->title);
262 insert_label(GTK_BOX(box), self->subtitle);
263 insert_label(GTK_BOX(box), self->message);
264 gtk_widget_set_margin_bottom(box, FONT_MANAGER_DEFAULT_MARGIN * 4);
265 gtk_widget_set_margin_top(box, FONT_MANAGER_DEFAULT_MARGIN * 4);
266 font_manager_widget_set_margin(bbox, FONT_MANAGER_DEFAULT_MARGIN * 4);
267 font_manager_widget_set_expand(self->icon, TRUE);
268 font_manager_widget_set_expand(box, TRUE);
269 font_manager_widget_set_expand(GTK_WIDGET(self), TRUE);
270 gtk_scrolled_window_set_child(GTK_SCROLLED_WINDOW(scrolled_window), bbox);
271 gtk_widget_set_parent(scrolled_window, GTK_WIDGET(self));
272 gtk_widget_add_css_class(GTK_WIDGET(self), FONT_MANAGER_STYLE_CLASS_VIEW);
273 font_manager_widget_set_name(GTK_WIDGET(self), "FontManagerPlaceHoler");
274 return;
275 }
276
277 /**
278 * font_manager_place_holder_new:
279 * @title: (nullable): Title to display in placeholder
280 * @subtitle: (nullable): Subtitle to display in placeholder
281 * @message: (nullable): Message to display in placeholder
282 * @icon_name: (nullable): Named icon to use in placeholder
283 *
284 * Returns: (transfer full): A newly created #FontManagerPlaceHolder.
285 * Free the returned object using #g_object_unref().
286 */
287 GtkWidget *
288 font_manager_place_holder_new (const gchar *title,
289 const gchar *subtitle,
290 const gchar *message,
291 const gchar *icon_name)
292 {
293 return g_object_new(FONT_MANAGER_TYPE_PLACE_HOLDER,
294 "icon-name", icon_name,
295 "title", title,
296 "subtitle", subtitle,
297 "message", message,
298 NULL);
299 }