view pidgin/gtkplugin.h @ 30199:bae447e1fa96

Allow the "alt" property on a Bits of Binary object to be NULL (do not store it in the alt lookup hashtable). This will allow us to create data objects for temporary "one time" objects (such as file transfer thumbnails)

+
鐃緒申/**
+
鐃緒申 * @file gtkplugin.h GTK+ Plugin API
+
鐃緒申 * @ingroup pidgin
+
鐃緒申 */
+
鐃緒申
+
鐃緒申/* pidgin
+
鐃緒申 *
+
鐃緒申 * Pidgin is the legal property of its developers, whose names are too numerous
+
鐃緒申 * to list here.  Please refer to the COPYRIGHT file distributed with this
+
鐃緒申 * source distribution.
+
鐃緒申 *
+
鐃緒申 * 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., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
+
鐃緒申 */
+
鐃緒申#ifndef _PIDGINPLUGIN_H_
+
鐃緒申#define _PIDGINPLUGIN_H_
+
鐃緒申
+
鐃緒申#include "pidgin.h"
+
鐃緒申#include "plugin.h"
+
鐃緒申
+
鐃緒申typedef struct _PidginPluginUiInfo PidginPluginUiInfo;
+
鐃緒申
+
鐃緒申/**
+
鐃緒申 * A GTK+ UI structure for plugins.
+
鐃緒申 */
+
鐃緒申struct _PidginPluginUiInfo
+
鐃緒申{
+
鐃緒申	GtkWidget *(*get_config_frame)(PurplePlugin *plugin);
+
鐃緒申
+
鐃緒申	int page_num;                                         /**< Reserved */
+
鐃緒申
+
鐃緒申	/* padding */
+
鐃緒申	void (*_pidgin_reserved1)(void);
+
鐃緒申	void (*_pidgin_reserved2)(void);
+
鐃緒申	void (*_pidgin_reserved3)(void);
+
鐃緒申	void (*_pidgin_reserved4)(void);
+
鐃緒申};
+
鐃緒申
+
鐃緒申#define PIDGIN_PLUGIN_TYPE PIDGIN_UI
+
鐃緒申
+
鐃緒申#define PIDGIN_IS_PIDGIN_PLUGIN(plugin) \
+
鐃緒申	((plugin)->info != NULL && (plugin)->info->ui_info != NULL && \
+
鐃緒申	 !strcmp((plugin)->info->ui_requirement, PIDGIN_PLUGIN_TYPE))
+
鐃緒申
+
鐃緒申#define PIDGIN_PLUGIN_UI_INFO(plugin) \
+
鐃緒申	((PidginPluginUiInfo *)(plugin)->info->ui_info)
+
鐃緒申
+
鐃緒申/**
+
鐃緒申 * Returns the configuration frame widget for a GTK+ plugin, if one
+
鐃緒申 * exists.
+
鐃緒申 *
+
鐃緒申 * @param plugin The plugin.
+
鐃緒申 *
+
鐃緒申 * @return The frame, if the plugin is a GTK+ plugin and provides a
+
鐃緒申 *         configuration frame.
+
鐃緒申 */
+
鐃緒申GtkWidget *pidgin_plugin_get_config_frame(PurplePlugin *plugin);
+
鐃緒申
+
鐃緒申/**
+
鐃緒申 * Saves all loaded plugins.
+
鐃緒申 */
+
鐃緒申void pidgin_plugins_save(void);
+
鐃緒申
+
鐃緒申/**
+
鐃緒申 * Shows the Plugins dialog
+
鐃緒申 */
+
鐃緒申void pidgin_plugin_dialog_show(void);
+
鐃緒申
+
鐃緒申#endif /* _PIDGINPLUGIN_H_ */