Mercurial > pidgin.yaz
view src/notify.h @ 6096:94e4cf59bacb
[gaim-migrate @ 6555]
(21:55:33) Robot101: LSchiere2: while you're round, fancy renaming a file? StdAfx.h in src/win32/ to stdafx.h.
(21:55:50) LSchiere2: Robot101: is there a reason?
(21:55:57) Robot101: LSchiere2: yeah, try and put a vitriolic comment about windows and/or herman and his build system into
the CVS message.
(21:56:14) ***LSchiere2 listens for the why
(21:56:33) Robot101: because it gets included as "stdafx.h"
(21:56:38) LSchiere2: that's a good reason
(21:56:53) SimGuy: windows filesystems and their not-caring-ness
(21:57:03) Robot101: so gcc on Linux doesn't find it. just because you're building on a retarded platform doesn't mean you
have to be all retarded about it.
(21:57:14) Robot101: (yeah, use that as the commit message)
(21:57:31) LSchiere2: how many places is it included? ie would it be easier to just change the include?
(21:58:00) Robot101: we want to discourage this camelcaps as much as possible, so let's just embrace the fact he included it
as lowercase.
(21:58:13) ***LSchiere2 detects evasion
(21:58:26) LSchiere2: you do realize do you not that cvs does NOT handle renaming a file well at all
(21:58:37) Robot101: detect someone who is on a windows laptop ssh'd to a machine which doesn't have a gaim tree on
(21:58:50) Robot101: the file isn't ours
(21:58:55) Robot101: it's just ripped from some other project
(21:58:58) zx64: mv File file; cvs remove File; cvs add file; cvs ci; done
(21:59:00) Robot101: we havn't changed it much.any
(21:59:04) RUBotzman left the room ("Bye all").
(21:59:11) LSchiere2: yes i'm aware of the steps involved zx64
(21:59:12) Robot101: *much/any
committer: Tailor Script <tailor@pidgin.im>
author | Luke Schierer <lschiere@pidgin.im> |
---|---|
date | Sat, 12 Jul 2003 02:00:38 +0000 |
parents | 158196b2db19 |
children | ee0044f3e377 |
line wrap: on
line source
/** * @file notify.h Notification API * @ingroup core * * gaim * * Copyright (C) 2003 Christian Hammond <chipx86@gnupdate.org> * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2 of the License, or * (at your option) any later version. * * This program 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 General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA */ #ifndef _GAIM_NOTIFY_H_ #define _GAIM_NOTIFY_H_ #include <stdlib.h> #include <glib-object.h> #include <glib.h> /** * Notification types. */ typedef enum { GAIM_NOTIFY_MESSAGE = 0, /**< Message notification. */ GAIM_NOTIFY_EMAIL, /**< Single e-mail notification. */ GAIM_NOTIFY_EMAILS /**< Multiple e-mail notification. */ } GaimNotifyType; /** * Notification message types. */ typedef enum { GAIM_NOTIFY_MSG_ERROR = 0, /**< Error notification. */ GAIM_NOTIFY_MSG_WARNING, /**< Warning notification. */ GAIM_NOTIFY_MSG_INFO /**< Information notification. */ } GaimNotifyMsgType; /** * Notification UI operations. */ typedef struct { void *(*notify_message)(GaimNotifyMsgType type, const char *title, const char *primary, const char *secondary, GCallback cb, void *user_data); void *(*notify_email)(const char *subject, const char *from, const char *to, const char *url, GCallback cb, void *user_data); void *(*notify_emails)(size_t count, gboolean detailed, const char **subjects, const char **froms, const char **tos, const char **urls, GCallback cb, void *user_data); void (*close_notify)(GaimNotifyType type, void *ui_handle); } GaimNotifyUiOps; #ifdef __cplusplus extern "C" { #endif /**************************************************************************/ /** @name Notification API */ /**************************************************************************/ /*@{*/ /** * Displays a notification message to the user. * * @param handle The plugin or connection handle. * @param type The notification type. * @param title The title of the message. * @param primary The main point of the message. * @param secondary The secondary information. * @param cb The callback to call when the user closes * the notification. * @param user_data The data to pass to the callback. * * @return A UI-specific handle. */ void *gaim_notify_message(void *handle, GaimNotifyType type, const char *title, const char *primary, const char *secondary, GCallback cb, void *user_data); /** * Displays a single e-mail notification to the user. * * @param handle The plugin or connection handle. * @param subject The subject of the e-mail. * @param from The from address. * @param to The destination address. * @param url The URL where the message can be read. * @param cb The callback to call when the user closes * the notification. * @param user_data The data to pass to the callback. * * @return A UI-specific handle. */ void *gaim_notify_email(void *handle, const char *subject, const char *from, const char *to, const char *url, GCallback cb, void *user_data); /** * Displays a notification for multiple e-mails to the user. * * @param handle The plugin or connection handle. * @param count The number of e-mails. * @param detailed @c TRUE if there is information for each e-mail in the * arrays. * @param subjects The array of subjects. * @param froms The array of from addresses. * @param tos The array of destination addresses. * @param url The URLs where the messages can be read. * @param cb The callback to call when the user closes * the notification. * @param user_data The data to pass to the callback. * * @return A UI-specific handle. */ void *gaim_notify_emails(void *handle, size_t count, gboolean detailed, const char **subjects, const char **froms, const char **tos, const char **urls, GCallback cb, void *user_data); /** * Closes a notification. * * This should be used only by the UI operation functions and part of the * core. * * @param type The notification type. * @param ui_handle The notification UI handle. */ void gaim_notify_close(GaimNotifyType type, void *ui_handle); /** * Closes all notifications registered with the specified handle. * * @param handle The handle. */ void gaim_notify_close_with_handle(void *handle); /** * A wrapper for gaim_notify_message that displays an information message. */ #define gaim_notify_info(handle, title, primary, secondary) \ gaim_notify_message((handle), GAIM_NOTIFY_MSG_INFO, (title), \ (primary), (secondary), NULL, NULL) /** * A wrapper for gaim_notify_message that displays a warning message. */ #define gaim_notify_warning(handle, title, primary, secondary) \ gaim_notify_message((handle), GAIM_NOTIFY_MSG_WARNING, (title), \ (primary), (secondary), NULL, NULL) /** * A wrapper for gaim_notify_message that displays an error message. */ #define gaim_notify_error(handle, title, primary, secondary) \ gaim_notify_message((handle), GAIM_NOTIFY_MSG_ERROR, (title), \ (primary), (secondary), NULL, NULL) /*@}*/ /**************************************************************************/ /** @name UI Operations API */ /**************************************************************************/ /*@{*/ /** * Sets the UI operations structure to be used when displaying a * notification. * * @param ops The UI operations structure. */ void gaim_set_notify_ui_ops(GaimNotifyUiOps *ops); /** * Returns the UI operations structure to be used when displaying a * notification. * * @param ops The UI operations structure. */ GaimNotifyUiOps *gaim_get_notify_ui_ops(void); /*@}*/ #ifdef __cplusplus } #endif #endif /* _GAIM_NOTIFY_H_ */