glib-2.0/gio/gnotification.h

0001 /*
0002  * Copyright © 2013 Lars Uebernickel
0003  *
0004  * SPDX-License-Identifier: LGPL-2.1-or-later
0005  *
0006  * This library is free software; you can redistribute it and/or
0007  * modify it under the terms of the GNU Lesser General Public
0008  * License as published by the Free Software Foundation; either
0009  * version 2.1 of the License, or (at your option) any later version.
0010  *
0011  * This library is distributed in the hope that it will be useful,
0012  * but WITHOUT ANY WARRANTY; without even the implied warranty of
0013  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
0014  * Lesser General Public License for more details.
0015  *
0016  * You should have received a copy of the GNU Lesser General
0017  * Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
0018  *
0019  * Authors: Lars Uebernickel <lars@uebernic.de>
0020  */
0021
0022 #ifndef __G_NOTIFICATION_H__
0023 #define __G_NOTIFICATION_H__
0024
0025 #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
0026 #error "Only <gio/gio.h> can be included directly."
0027 #endif
0028
0029 #include <gio/giotypes.h>
0030 #include <gio/gioenums.h>
0031
0032 G_BEGIN_DECLS
0033
0034 #define G_TYPE_NOTIFICATION         (g_notification_get_type ())
0035 #define G_NOTIFICATION(o)           (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_NOTIFICATION, GNotification))
0036 #define G_IS_NOTIFICATION(o)        (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_NOTIFICATION))
0037
0038 GIO_AVAILABLE_IN_2_40
0039 GType                   g_notification_get_type                         (void) G_GNUC_CONST;
0040
0041 GIO_AVAILABLE_IN_2_40
0042 GNotification *         g_notification_new                              (const gchar *title);
0043
0044 GIO_AVAILABLE_IN_2_40
0045 void                    g_notification_set_title                        (GNotification *notification,
0046                                                                          const gchar   *title);
0047
0048 GIO_AVAILABLE_IN_2_40
0049 void                    g_notification_set_body                         (GNotification *notification,
0050                                                                          const gchar   *body);
0051
0052 GIO_AVAILABLE_IN_2_40
0053 void                    g_notification_set_icon                         (GNotification *notification,
0054                                                                          GIcon         *icon);
0055
0056 GIO_DEPRECATED_IN_2_42_FOR(g_notification_set_priority)
0057 void                    g_notification_set_urgent                       (GNotification *notification,
0058                                                                          gboolean       urgent);
0059
0060 GIO_AVAILABLE_IN_2_42
0061 void                    g_notification_set_priority                     (GNotification         *notification,
0062                                                                          GNotificationPriority  priority);
0063
0064 GIO_AVAILABLE_IN_2_70
0065 void                    g_notification_set_category                     (GNotification *notification,
0066                                                                          const gchar   *category);
0067
0068 GIO_AVAILABLE_IN_2_40
0069 void                    g_notification_add_button                       (GNotification *notification,
0070                                                                          const gchar   *label,
0071                                                                          const gchar   *detailed_action);
0072
0073 GIO_AVAILABLE_IN_2_40
0074 void                    g_notification_add_button_with_target           (GNotification *notification,
0075                                                                          const gchar   *label,
0076                                                                          const gchar   *action,
0077                                                                          const gchar   *target_format,
0078                                                                          ...);
0079
0080 GIO_AVAILABLE_IN_2_40
0081 void                    g_notification_add_button_with_target_value     (GNotification *notification,
0082                                                                          const gchar   *label,
0083                                                                          const gchar   *action,
0084                                                                          GVariant      *target);
0085
0086 GIO_AVAILABLE_IN_2_40
0087 void                    g_notification_set_default_action               (GNotification *notification,
0088                                                                          const gchar   *detailed_action);
0089
0090 GIO_AVAILABLE_IN_2_40
0091 void                    g_notification_set_default_action_and_target    (GNotification *notification,
0092                                                                          const gchar   *action,
0093                                                                          const gchar   *target_format,
0094                                                                          ...);
0095
0096 GIO_AVAILABLE_IN_2_40
0097 void                 g_notification_set_default_action_and_target_value (GNotification *notification,
0098                                                                          const gchar   *action,
0099                                                                          GVariant      *target);
0100
0101 G_END_DECLS
0102
0103 #endif