<HTML
><HEAD
><TITLE
>bonobo-event-source</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="Bonobo API Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Notification and EventSources"
HREF="bonobo-notification.html"><LINK
REL="PREVIOUS"
TITLE="Notification and EventSources"
HREF="bonobo-notification.html"><LINK
REL="NEXT"
TITLE="bonobo-listener"
HREF="bonobo-bonobo-listener.html"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TH
COLSPAN="4"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="5"
>Bonobo API Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="bonobo-notification.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><<< Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="bonobo-notification.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="bonobo-bonobo-listener.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page >>></B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="BONOBO-BONOBO-EVENT-SOURCE"
>bonobo-event-source</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN5454"
></A
><H2
>Name</H2
>bonobo-event-source -- An Event Source where clients can connect to listen to events.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN5457"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>
typedef <A
HREF="bonobo-bonobo-event-source.html#BONOBOEVENTSOURCE"
>BonoboEventSource</A
>;
typedef <A
HREF="bonobo-bonobo-event-source.html#BONOBOEVENTSOURCECLASS"
>BonoboEventSourceClass</A
>;
<A
HREF="bonobo-bonobo-event-source.html#BONOBOEVENTSOURCE"
>BonoboEventSource</A
>* <A
HREF="bonobo-bonobo-event-source.html#BONOBO-EVENT-SOURCE-NEW"
>bonobo_event_source_new</A
> (void);
void <A
HREF="bonobo-bonobo-event-source.html#BONOBO-EVENT-SOURCE-NOTIFY-LISTENERS"
>bonobo_event_source_notify_listeners</A
>
(<A
HREF="bonobo-bonobo-event-source.html#BONOBOEVENTSOURCE"
>BonoboEventSource</A
> *event_source,
const char *event_name,
const <GTKDOCLINK
HREF="CORBA-ANY"
>CORBA_any</GTKDOCLINK
> *value,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *opt_ev);
void <A
HREF="bonobo-bonobo-event-source.html#BONOBO-EVENT-SOURCE-NOTIFY-LISTENERS-FULL"
>bonobo_event_source_notify_listeners_full</A
>
(<A
HREF="bonobo-bonobo-event-source.html#BONOBOEVENTSOURCE"
>BonoboEventSource</A
> *event_source,
const char *path,
const char *type,
const char *subtype,
const <GTKDOCLINK
HREF="CORBA-ANY"
>CORBA_any</GTKDOCLINK
> *value,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *opt_ev);
<GTKDOCLINK
HREF="BONOBO-EVENTSOURCE-LISTENERID"
>Bonobo_EventSource_ListenerId</GTKDOCLINK
> <A
HREF="bonobo-bonobo-event-source.html#BONOBO-EVENT-SOURCE-CLIENT-ADD-LISTENER"
>bonobo_event_source_client_add_listener</A
>
(<GTKDOCLINK
HREF="BONOBO-UNKNOWN"
>Bonobo_Unknown</GTKDOCLINK
> object,
<A
HREF="bonobo-bonobo-listener.html#BONOBOLISTENERCALLBACKFN"
>BonoboListenerCallbackFn</A
> event_callback,
const char *opt_mask,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *opt_ev,
<GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> user_data);
void <A
HREF="bonobo-bonobo-event-source.html#BONOBO-EVENT-SOURCE-CLIENT-REMOVE-LISTENER"
>bonobo_event_source_client_remove_listener</A
>
(<GTKDOCLINK
HREF="BONOBO-UNKNOWN"
>Bonobo_Unknown</GTKDOCLINK
> object,
<GTKDOCLINK
HREF="BONOBO-EVENTSOURCE-LISTENERID"
>Bonobo_EventSource_ListenerId</GTKDOCLINK
> id,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *opt_ev);
void <A
HREF="bonobo-bonobo-event-source.html#BONOBO-EVENT-SOURCE-IGNORE-LISTENERS"
>bonobo_event_source_ignore_listeners</A
>
(<A
HREF="bonobo-bonobo-event-source.html#BONOBOEVENTSOURCE"
>BonoboEventSource</A
> *event_source); </PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN5484"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
> <GTKDOCLINK
HREF="GTKOBJECT"
>GtkObject</GTKDOCLINK
>
+----<A
HREF="bonobo-bonobo-object.html#BONOBOOBJECT"
>BonoboObject</A
>
+----<GTKDOCLINK
HREF="BONOBOXOBJECT"
>BonoboXObject</GTKDOCLINK
>
+----BonoboEventSource</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN5490"
></A
><H2
>Description</H2
><P
>An event source object is responsible for channeling the emission
of signals on an object to the appropriate attached listeners.
The API is extremely simple and allows implementations to notify
their listeners of a new event occuring.</P
><P
>To notify a listener, you need to construct a textual string,
this is done by the <TT
CLASS="FUNCTION"
>bonobo_event</TT
> functions
( see <A
HREF="bonobo-bonobo-listener.html#BONOBOLISTENER"
>BonoboListener</A
> ) ':' delimiting the fields. It is reccommended
that the IDL module path of the interface be used as the first
part of the string. This is because many interfaces can be aggregated
together and need to share the same event namespace without conflicts.
So for example the bonobo property bag notification code
uses the IDL path "Bonobo/Property" the "change" kind and sets the
sub-type to the property name:
<DIV
CLASS="EXAMPLE"
><A
NAME="AEN5496"
></A
><P
><B
>Example 1. An example event source notification</B
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>static void
notify_listeners (BonoboPropertyBag *pb,
BonoboProperty *prop,
const BonoboArg *new_value,
CORBA_Environment *opt_ev)
{
if (prop->flags & BONOBO_PROPERTY_NO_LISTENING)
return;
bonobo_event_source_notify_listeners_full (pb->es,
"Bonobo/Property",
"change", prop->name,
new_value, opt_ev);
}
</PRE
></TD
></TR
></TABLE
></DIV
>
Of course, you need to notify the listener with a valid
BonoboArg containing the event data, this could easily contain
a structure. eg.
<DIV
CLASS="EXAMPLE"
><A
NAME="AEN5499"
></A
><P
><B
>Example 2. Passing a structure in an event</B
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>module GNOME {
module Foo {
struct BaaEvent {
double a;
string b;
long c;
};
};
};
</PRE
></TD
></TR
></TABLE
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>static void
fire_event (BonoboEventSource *on_source,
double a_double,
char *a_string,
long a_float,
CORBA_Environment *opt_ev)
{
CORBA_any any;
GNOME_Foo_BaaEvent e;
e.a = a_double;
e.b = a_string;
e.c = a_float;
any->_type = TC_GNOME_Foo_BaaEvent;
any->_data = &e;
bonobo_event_source_notify_listeners_full (
on_source, "GNOME/Foo", "event", NULL,
&any, opt_ev);
}
</PRE
></TD
></TR
></TABLE
></DIV
>
NB. it is reccommended that you make it clear that the event
structure is intended for use with the <A
HREF="bonobo-bonobo-event-source.html#BONOBOEVENTSOURCE"
>BonoboEventSource</A
> /
<A
HREF="bonobo-bonobo-listener.html#BONOBOLISTENER"
>BonoboListener</A
> by naming it XYZEvent, ie. with the 'Event'
suffix.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN5505"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN5507"
></A
><H3
><A
NAME="BONOBOEVENTSOURCE"
></A
>BonoboEventSource</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef struct {
BonoboXObject parent;
BonoboEventSourcePrivate *priv;
} BonoboEventSource;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5512"
></A
><H3
><A
NAME="BONOBOEVENTSOURCECLASS"
></A
>BonoboEventSourceClass</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef struct {
BonoboXObjectClass parent_class;
POA_Bonobo_EventSource__epv epv;
} BonoboEventSourceClass;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5517"
></A
><H3
><A
NAME="BONOBO-EVENT-SOURCE-NEW"
></A
>bonobo_event_source_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="bonobo-bonobo-event-source.html#BONOBOEVENTSOURCE"
>BonoboEventSource</A
>* bonobo_event_source_new (void);</PRE
></TD
></TR
></TABLE
><P
>Creates a new BonoboEventSource object. Typically this
object will be exposed to clients through CORBA and they
will register and unregister functions to be notified
of events that this EventSource generates.</P
><P
>To notify clients of an event, use the <A
HREF="bonobo-bonobo-event-source.html#BONOBO-EVENT-SOURCE-NOTIFY-LISTENERS"
>bonobo_event_source_notify_listeners</A
>()
function.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN5527"><SPAN
STYLE="white-space: nowrap"
><I
CLASS="EMPHASIS"
>Returns</I
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> A new <A
HREF="bonobo-bonobo-event-source.html#BONOBOEVENTSOURCE"
>BonoboEventSource</A
> server object.</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5533"
></A
><H3
><A
NAME="BONOBO-EVENT-SOURCE-NOTIFY-LISTENERS"
></A
>bonobo_event_source_notify_listeners ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void bonobo_event_source_notify_listeners
(<A
HREF="bonobo-bonobo-event-source.html#BONOBOEVENTSOURCE"
>BonoboEventSource</A
> *event_source,
const char *event_name,
const <GTKDOCLINK
HREF="CORBA-ANY"
>CORBA_any</GTKDOCLINK
> *value,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *opt_ev);</PRE
></TD
></TR
></TABLE
><P
>This will notify all clients that have registered with this EventSource
(through the addListener or addListenerWithMask methods) of the availability
of the event named <TT
CLASS="PARAMETER"
><I
>event_name</I
></TT
>. The <TT
CLASS="PARAMETER"
><I
>value</I
></TT
> CORBA::any value is passed to
all listeners.</P
><P
><TT
CLASS="PARAMETER"
><I
>event_name</I
></TT
> can not contain comma separators, as commas are used to
separate the various event names.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN5547"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>event_source</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the Event Source that will emit the event.</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN5552"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>event_name</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> Name of the event being emitted</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN5557"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>value</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> A CORBA_any value that contains the data that is passed to interested clients</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN5562"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>opt_ev</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> A CORBA_Environment where a failure code can be returned, can be NULL.</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5567"
></A
><H3
><A
NAME="BONOBO-EVENT-SOURCE-NOTIFY-LISTENERS-FULL"
></A
>bonobo_event_source_notify_listeners_full ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void bonobo_event_source_notify_listeners_full
(<A
HREF="bonobo-bonobo-event-source.html#BONOBOEVENTSOURCE"
>BonoboEventSource</A
> *event_source,
const char *path,
const char *type,
const char *subtype,
const <GTKDOCLINK
HREF="CORBA-ANY"
>CORBA_any</GTKDOCLINK
> *value,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *opt_ev);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN5576"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>event_source</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN5581"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN5586"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>type</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN5591"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>subtype</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN5596"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>value</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN5601"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>opt_ev</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> </P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5606"
></A
><H3
><A
NAME="BONOBO-EVENT-SOURCE-CLIENT-ADD-LISTENER"
></A
>bonobo_event_source_client_add_listener ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="BONOBO-EVENTSOURCE-LISTENERID"
>Bonobo_EventSource_ListenerId</GTKDOCLINK
> bonobo_event_source_client_add_listener
(<GTKDOCLINK
HREF="BONOBO-UNKNOWN"
>Bonobo_Unknown</GTKDOCLINK
> object,
<A
HREF="bonobo-bonobo-listener.html#BONOBOLISTENERCALLBACKFN"
>BonoboListenerCallbackFn</A
> event_callback,
const char *opt_mask,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *opt_ev,
<GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> user_data);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN5617"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>object</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN5622"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>event_callback</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN5627"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>opt_mask</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN5632"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>opt_ev</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN5637"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN5642"><SPAN
STYLE="white-space: nowrap"
><I
CLASS="EMPHASIS"
>Returns</I
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> </P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5647"
></A
><H3
><A
NAME="BONOBO-EVENT-SOURCE-CLIENT-REMOVE-LISTENER"
></A
>bonobo_event_source_client_remove_listener ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void bonobo_event_source_client_remove_listener
(<GTKDOCLINK
HREF="BONOBO-UNKNOWN"
>Bonobo_Unknown</GTKDOCLINK
> object,
<GTKDOCLINK
HREF="BONOBO-EVENTSOURCE-LISTENERID"
>Bonobo_EventSource_ListenerId</GTKDOCLINK
> id,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *opt_ev);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN5656"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>object</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN5661"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>id</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN5666"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>opt_ev</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> </P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5671"
></A
><H3
><A
NAME="BONOBO-EVENT-SOURCE-IGNORE-LISTENERS"
></A
>bonobo_event_source_ignore_listeners ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void bonobo_event_source_ignore_listeners
(<A
HREF="bonobo-bonobo-event-source.html#BONOBOEVENTSOURCE"
>BonoboEventSource</A
> *event_source);</PRE
></TD
></TR
></TABLE
><P
>Instructs the event source to de-register any listeners
that are added from the global running context.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN5679"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>event_source</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> </P
></TD
></TR
></TBODY
></TABLE
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN5684"
></A
><H2
>See Also</H2
><P
> <A
HREF="bonobo-bonobo-listener.html#BONOBOLISTENER"
>BonoboListener</A
> <A
HREF="bonobo-bonobo-arg.html#BONOBOARG"
>BonoboArg</A
></P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="bonobo-notification.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><<< Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="bonobo-notification.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="bonobo-bonobo-listener.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page >>></B
></FONT
></A
></TD
></TR
><TR
><TD
COLSPAN="2"
ALIGN="left"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Notification and EventSources</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>bonobo-listener</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
distrib
>
PLD
>
ac
>
amd64
>
media
>
dist
>
by-pkgid
>
fd2761970a77896f276e13daf3a9620f
>
files
>
101
