gnome-triggers

Name

gnome-triggers -- 

Synopsis


#include <libgnome/libgnome.h>


enum        GnomeTriggerType;
void        (*GnomeTriggerActionFunction)   (char *msg,
                                             char *level,
                                             char *supinfo[]);
struct      GnomeTrigger;
void        gnome_triggers_add_trigger      (GnomeTrigger *nt,
                                             ...);
void        gnome_triggers_vadd_trigger     (GnomeTrigger *nt,
                                             char *supinfo[]);
void        gnome_triggers_do               (const char *msg,
                                             const char *level,
                                             ...);
void        gnome_triggers_vdo              (const char *msg,
                                             const char *level,
                                             const char *supinfo[]);

Description

Details

enum GnomeTriggerType

typedef enum {
	GTRIG_NONE,
	GTRIG_FUNCTION,
	GTRIG_COMMAND,
	GTRIG_MEDIAPLAY
} GnomeTriggerType;


GnomeTriggerActionFunction ()

void        (*GnomeTriggerActionFunction)   (char *msg,
                                             char *level,
                                             char *supinfo[]);

msg : 
level : 
supinfo : 


struct GnomeTrigger

struct GnomeTrigger {
	GnomeTriggerType type;
	union {
		/*
		 * These will be passed the same info as
		 * gnome_triggers_do got
		 */
		GnomeTriggerActionFunction function;
		gchar *command;
		struct {
			gchar *file;
			int cache_id;
		} media;
	} u;
        gchar *level;
};


gnome_triggers_add_trigger ()

void        gnome_triggers_add_trigger      (GnomeTrigger *nt,
                                             ...);

Similar to gnome_triggers_readfile(), but gets the trigger information from the file 'nt' structure and the varargs, instead of from a file.

nt : Information on the new trigger to be added.
... : the 'section' to add the trigger under (see gnome_triggers_readfile())


gnome_triggers_vadd_trigger ()

void        gnome_triggers_vadd_trigger     (GnomeTrigger *nt,
                                             char *supinfo[]);

Similar to gnome_triggers_readfile(), but gets the trigger information from the file 'nt' structure and 'supinfo', instead of from a file.

nt : Information on the new trigger to be added.
supinfo : the 'section' to add the trigger under (see gnome_triggers_readfile())


gnome_triggers_do ()

void        gnome_triggers_do               (const char *msg,
                                             const char *level,
                                             ...);

Notifies GNOME about an event happening, so GNOME can do cool things.

msg : The human-readable message describing the event. (Can be NULL).
level : The level of severity of the event, or NULL.
... : The classification of the event.


gnome_triggers_vdo ()

void        gnome_triggers_vdo              (const char *msg,
                                             const char *level,
                                             const char *supinfo[]);

Notifies GNOME about an event happening, so GNOME can do cool things.

msg : The human-readable message describing the event. (Can be NULL).
level : The level of severity of the event, or NULL.
supinfo : The classification of the event (NULL terminated array).