mc/lib/event/event.c
Slava Zanko a5195d285a Added new engine for universal event system.
Example:

gboolean mkdir_callback(const gchar *event_group, const gchar *event_name, gpointer init_data, gpointer event_data)
{
    ... /* some action for handle event */
    return TRUE; /* got chance to run other callbacks for this event or */
    return FALSE; /* break execution for other callbacks */
}

mc_event_add ("filesystem", "mkdir", mkdir_callback, "some init data", NULL);
mc_event_add ("filesystem", "mkdir", mkdir_log_callback, "some init data", NULL);
mc_event_add ("filesystem", "mkdir", third_callback, NULL, NULL);

/*
    Last add - first run. In this case execution order is
 * third_callback
 * mkdir_log_callback
 * mkdir_callback
 if third_callback fuctions will return FALSE, then other callbacks
 (mkdir_log_callback and mkdir_callback) never run!
*/

... /* some code */

/* for example, after pressing F7 */
mc_event_raise("filesystem", "mkdir", "some event_data... path to directory");

Signed-off-by: Slava Zanko <slavazanko@gmail.com>
2011-03-21 11:46:40 +02:00

136 lines
4.4 KiB
C

/*
Handle events in application.
Interface functions: init/deinit; start/stop
Copyright (C) 2011 The Free Software Foundation, Inc.
Written by:
Slava Zanko <slavazanko@gmail.com>, 2011.
This file is part of the Midnight Commander.
The Midnight Commander 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.
The Midnight Commander 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 02110-1301, USA.
*/
#include <config.h>
#include "lib/global.h"
#include "lib/event.h"
#include "internal.h"
/*** global variables ****************************************************************************/
/*** file scope macro definitions ****************************************************************/
/*** file scope type declarations ****************************************************************/
/*** file scope variables ************************************************************************/
GTree *mc_event_grouplist = NULL;
/*** file scope functions ************************************************************************/
/* --------------------------------------------------------------------------------------------- */
/*** public functions ****************************************************************************/
/* --------------------------------------------------------------------------------------------- */
gboolean
mc_event_init (GError ** mcerror)
{
if (mc_event_grouplist != NULL)
{
g_propagate_error (mcerror,
g_error_new (mc_main_error_quark (), 1,
_("Event system already initialized")));
return FALSE;
}
mc_event_grouplist =
g_tree_new_full ((GCompareDataFunc) g_ascii_strcasecmp,
NULL, (GDestroyNotify) g_free, (GDestroyNotify) g_tree_destroy);
if (mc_event_grouplist == NULL)
{
g_propagate_error (mcerror,
g_error_new (mc_main_error_quark (), 2,
_("Failed to initialize event system")));
return FALSE;
}
return TRUE;
}
/* --------------------------------------------------------------------------------------------- */
gboolean
mc_event_deinit (GError ** mcerror)
{
if (mc_event_grouplist == NULL)
{
g_propagate_error (mcerror,
g_error_new (mc_main_error_quark (), 1,
_("Event system not initialized")));
return FALSE;
}
g_tree_destroy (mc_event_grouplist);
mc_event_grouplist = NULL;
return TRUE;
}
/* --------------------------------------------------------------------------------------------- */
gboolean
mc_event_mass_add (event_init_t * events, GError ** mcerror)
{
size_t array_index;
for (array_index = 0; events[array_index].event_group_name != NULL; array_index++)
{
if (!mc_event_add (events[array_index].event_group_name,
events[array_index].event_name,
events[array_index].cb, events[array_index].init_data, mcerror))
{
return FALSE;
}
}
return TRUE;
}
/* --------------------------------------------------------------------------------------------- */
gboolean
mc_event_present (const gchar *event_group_name, const gchar *event_name)
{
GTree *event_group;
GPtrArray *callbacks;
if (mc_event_grouplist == NULL || event_group_name == NULL || event_name == NULL)
return FALSE;
event_group = mc_event_get_event_group_by_name (event_group_name, FALSE, NULL);
if (event_group == NULL)
return FALSE;
callbacks = mc_event_get_event_by_name (event_group, event_name, FALSE, NULL);
if (callbacks == NULL)
return FALSE;
return TRUE;
}
/* --------------------------------------------------------------------------------------------- */